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

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

AWS::Serverless::Application

将来自Amazon Serverless Application Repository或来自 Amazon S3 存储桶的无服务器应用程序嵌入为嵌套应用程序。嵌套应用程序作为嵌套AWS::CloudFormation::Stack资源部署,嵌套资源可以包含多个其他资源,包括其他AWS::Serverless::Application资源。

注意

部署到时Amazon CloudFormation,Amazon SAM将您的Amazon SAM资源转换为Amazon CloudFormation资源。有关更多信息,请参阅Amazon CloudFormation

语法

要在Amazon Serverless Application Model (Amazon 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可用于指定已发布到的应用程序Amazon Serverless Application Repository

如果提供了本地文件路径,则模板必须经过包含sam deploysam package命令的工作流程,才能正确转换应用程序。

类型:字符串 | ApplicationLocationObject

必需:是

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

NotificationARNs

将发送有关堆栈事件的通知的通知的通知的通知的通知的通知的通知的通知的通知的现有 Amaion 主题。

类型:清单

必需:否

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

Parameters

应用程序参数值。

类型:地图

必需:否

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

Tags

一个映射(字符串到字符串),指定要添加到此应用程序的标签的标签。密钥和值只能包含字母数字字符。密钥的长度可以在 1 到 127 个 Unicode 字符之间,并且不能带有前缀 aws:。值的长度可以在 1 到 255 个 Unicode 字符之间。

类型:地图

必需:否

Amazon CloudFormation兼容性:此属性类似于AWS::CloudFormation::Stack资源的Tags属性。SAM 中的 Tags 属性由 Key: Value 对组成; CloudFormation 它由标签对象列表组成。创建堆栈后,SAM 将自动向该应用程序添加lambda:createdBy:SAM标签。此外,如果此应用程序来自于Amazon Serverless Application Repository,则 SAM 还将自动添加两个附加标签serverlessrepo:applicationId:ApplicationIdserverlessrepo:semanticVersion:SemanticVersion

TimeoutInMinutes

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

类型:整数

必需:否

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

返回值

Ref

当该资源的逻辑 ID 提供给Ref内部函数时,它将返回基础资源的AWS::CloudFormation::Stack资源名称。

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

Fn::GetAtt

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

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

Outputs.ApplicationOutputName

带有名称的堆栈输出的值ApplicationOutputName

示例

特区应用程序

使用Serverless Application Repository 中的模板的应用程序

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

速正常关应用程序

来自 S3 网址的应用程序

YAML

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