Amazon SAM模板剖析

网络 ACL 和安全组都允许 (因此可到达您的实例) 的发起 ping 的Amazon SAM模板文件严格遵循Amazon CloudFormation模板文件，中对此进行了介绍模板剖析中的Amazon CloudFormation用户指南. 两者之间的主要区别Amazon SAM和模板文件Amazon CloudFormation模板文件如下：

转换声明。该声明Transform: AWS::Serverless-2016-10-31是必需的Amazon SAM模板文件。此声明标识Amazon CloudFormation模板文件作为Amazon SAM模板文件。有关转换的更多信息，请参阅转换中的Amazon CloudFormation用户指南.
“全局变量” 部分。这些区域有：Globals部分对是唯一的Amazon SAM. 它定义了所有无服务器函数和 API 通用的属性。所有AWS::Serverless::Function、AWS::Serverless::Api, 和AWS::Serverless::SimpleTable资源继承在Globals部分。有关本节的更多信息，请参阅Amazon SAM模板的全局变量部分.
资源部分。InAmazon SAM模板化Resources部分可以包含Amazon CloudFormation资源和Amazon SAM资源的费用。有关的更多信息Amazon CloudFormation资源，请参阅Amazon资源和属性类型参考中的Amazon CloudFormation用户指南. 有关 Amazon SAM 资源的更多信息，请参阅 Amazon SAM资源和属性参考。
参数部分。中声明的对象Parameters部分导致sam deploy --guided命令向用户显示其他提示。有关已声明对象和相应提示的示例，请参阅sam deploy中的Amazon SAMCLI 命令参考。

的所有其他部分Amazon SAM模板文件对应于Amazon CloudFormation同名的模板文件部分。

YAML

以下示例显示 YAML 格式的模板片段。


Transform: AWS::Serverless-2016-10-31

Globals:
  set of globals

Description:
  String

Metadata:
  template metadata

Parameters:
  set of parameters

Mappings:
  set of mappings

Conditions:
  set of conditions

Resources:
  set of resources

Outputs:
  set of outputs

模板部分

Amazon SAM模板可以包含几个主要部分。只有Transform和Resources部分是必填的。

您可以按任意顺序包含模板部分。但是，在您构建模板时，使用以下列表中显示的逻辑顺序可能会很有用。这是因为一个部分中的值可能是指前一节中的值。

转换（必填）

适用于Amazon SAM模板，您必须将此部分的值包含为AWS::Serverless-2016-10-31.

其他转换是可选的。有关转换的更多信息，请参阅转换中的Amazon CloudFormation用户指南.

全局变量（可选）

所有无服务器函数、API 和简单表都通用的属性。所有AWS::Serverless::Function、AWS::Serverless::Api, 和AWS::Serverless::SimpleTable资源继承在Globals部分。

本节对是唯一的Amazon SAM. 中没有相应的部分Amazon CloudFormation模板。

Description (可选)

一个描述模板的文本字符串。

本节直接对应于Description部分Amazon CloudFormation模板。

元数据（可选）

提供有关模板的其他信息的对象。

本节直接对应于Metadata部分Amazon CloudFormation模板。

Parameters（可选）

要在运行时 (创建或更新堆栈时) 传递到模板的值。您可引用模板的 Resources 和 Outputs 部分中的参数。

使用--parameter-overrides的参数sam deploy命令和配置文件中的条目-优先于Amazon SAM模板文件。有关的更多信息sam deploy命令，请参阅sam deploy中的Amazon SAMCLI 命令参考。有关配置文件的更多信息，请参阅Amazon SAM CLI 配置文件。

Mappings（可选）