AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

AWS CloudFormation 模板格式

可使用 JSON 或 YAML 格式创作 AWS CloudFormation 模板。我们支持适用于这两种格式 (包含在 AWS CloudFormation Designer 中) 的所有 AWS CloudFormation 功能和函数。

在决定要使用哪种格式时,选择最方便使用的格式。另外,考虑到 YAML 本身提供了一些不适用于 JSON 的功能,例如注释。

重要

我们建议您不要在 Designer 中向模板添加 # YAML 注释。如果您的 YAML 模板包含 # 注释,Designer 在将模板转换为 JSON 时不保留这些注释。此外,在 Designer 中修改模板 (例如,在画布上移动资源) 时,注释将丢失。

您可以向在 Designer 以外创建的 AWS CloudFormation 模板添加注释。下面的示例介绍一个包含内联注释的 YAML 模板。

AWSTemplateFormatVersion: "2010-09-09" Description: A sample template Resources: MyEC2Instance: #An inline comment Type: "AWS::EC2::Instance" Properties: ImageId: "ami-2f726546" #Another comment -- This is a Linux AMI InstanceType: t1.micro KeyName: testkey BlockDeviceMappings: - DeviceName: /dev/sdm Ebs: VolumeType: io1 Iops: 200 DeleteOnTermination: false VolumeSize: 20

有关适用于每种格式的模板语法的更多信息,请参阅模板剖析

AWS CloudFormation 支持以下 JSON 和 YAML 规范:

JSON

AWS CloudFormation 遵循 ECMA-404 JSON 标准。有关 JSON 格式的更多信息,请访问 http://www.json.org

YAML

AWS CloudFormation 支持 YAML 版本 1.1 规范,但有一些例外。AWS CloudFormation 不支持以下功能:

  • binaryomappairssettimestamp 标签

  • 别名

  • 哈希合并

有关 YAML 的更多信息,请访问 http://www.yaml.org