AWS::Serverless::Application - AWS Serverless Application Model
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

AWS::Serverless::Application

从嵌入无服务器应用程序 AWS无服务器应用程序存储库 或来自 Amazon S3 bucket作为嵌套应用程序。嵌套应用程序作为嵌套部署 AWS::云格式::堆栈 可以包含多个其他资源,包括其他 AWS::Serverless::Application 资源。

语法

若要在您的 AWS 无服务器应用程序模型 (AWS SAM)模板,请使用以下语法。

YAML

Type: AWS::Serverless::Application Properties: Location: String | ApplicationLocationObject NotificationARNs: List Parameters: Map Tags: Map TimeoutInMinutes: Integer

属性

Location

嵌套应用程序的模板URL、文件路径或位置对象。

如果提供了模板URL,则必须遵循 CloudFormation TemplateUrl 文档 并包含有效的 CloudFormation 或SAM模板。一种 ApplicationLocationObject 可用于指定已发布到 AWS无服务器应用程序存储库.

如果提供了本地文件路径,则模板必须通过包含 sam deploysam package 命令,以便正确转换应用程序。

类型:字符串| ApplicationLocationObject

必需: 是

AWS CloudFormation 兼容性: 该属性类似于 TemplateURL 属性 AWS::CloudFormation::Stack 资源。的 CloudFormation 版本不需要 ApplicationLocationObject 从检索应用程序 AWS Serverless Application Repository.

NotificationARNs

现有AmazonSNS主题的列表,其中发送了关于堆栈事件的通知。

类型:列表

必需: 否

AWS CloudFormation 兼容性: 此属性直接传递到 NotificationARNs 属性 AWS::CloudFormation::Stack 资源。

Parameters

应用程序参数值。

类型:Map

必需: 否

AWS CloudFormation 兼容性: 此属性直接传递到 Parameters 属性 AWS::CloudFormation::Stack 资源。

Tags

指定要添加到此应用程序的标记的地图(字符串到字符串)。键和值限于个字母数字字符。密钥的长度可以是1至127个Unicode字符,不能以aws前缀:。数值可以是1至255个Unicode字符。

类型:Map

必需: 否

AWS CloudFormation 兼容性: 该属性类似于 Tags 属性 AWS::CloudFormation::Stack 资源。SAM中的“标记”属性由键:值对组成; CloudFormation 它由标记对象的列表组成。创建堆栈时,SAM将自动添加 lambda:createdBy:SAM 标记到此应用程序。此外,如果此应用程序来自 AWS Serverless Application Repository,SAM也会自动添加两个附加标记 serverlessrepo:applicationId:ApplicationIdserverlessrepo:semanticVersion:SemanticVersion.

TimeoutInMinutes

AWS CloudFormation 等待嵌套堆栈达到 CREATE_COMPLETE 状态的时间长度(以分钟为单位)。默认值为无超时。当AWS CloudFormation 检测到嵌套堆栈已达到 CREATE_COMPLETE 状态,它将嵌套堆栈资源标记为 CREATE_COMPLETE 在父堆栈中继续创建父堆栈。如果在嵌套堆栈达到 CREATE_COMPLETE 之前超时期限过期,则 AWS CloudFormation 将嵌套堆栈标记为失败并回滚嵌套堆栈和父堆栈。

类型:整数

必需: 否

AWS CloudFormation 兼容性: 此属性直接传递到 TimeoutInMinutes 属性 AWS::CloudFormation::Stack 资源。

返回值

Ref

当此资源的逻辑ID提供给 Ref 内在函数,则返回基础 AWS::CloudFormation::Stack 资源。

有关使用的更多信息 Ref 函数,请参阅 RefAWS CloudFormation 用户指南.

Fn::GetAtt

Fn::GetAtt 返回一个此类型指定属性的值。以下为可用属性和示例返回值。

有关使用 Fn::GetAtt 的更多信息,请参阅 AWS CloudFormation 用户指南 中的 Fn::GetAtt

Outputs.ApplicationOutputName

具有名称的堆栈输出的值 ApplicationOutputName.

示例

SAR应用

使用来自无服务器应用程序存储库的模板的应用程序

YAML

Type: AWS::Serverless::Application Properties: Location: ApplicationId: 'arn:aws:serverlessrepo:us-east-1:012345678901:applications/my-application' SemanticVersion: 1.0.0 Parameters: StringParameter: parameter-value IntegerParameter: 2

正常-应用

来自S3url的应用程序

YAML

Type: AWS::Serverless::Application Properties: Location: https://s3.amazonaws.com/demo-bucket/template.yaml