Amazon CloudFormation 资源标记 - Amazon CloudFormation
语法属性示例另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

这是新的《Amazon CloudFormation 模板参考指南》。请更新您的书签和链接。有关开始使用 CloudFormation 的帮助，请参阅《Amazon CloudFormation 用户指南》https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/Welcome.html。

Amazon CloudFormation 资源标记

您可以使用 CloudFormation 模板中的 Tags 属性将标签应用于资源，这可以帮助您识别和分类这些资源。

有关哪些资源支持 Tags 属性的信息，请参阅 Amazon 资源和属性类型参考中的各个资源。如果资源尚不支持 Tags 属性，则资源的服务可能支持使用其自己的 API 操作进行标记。有关更多信息，请参阅该服务的文档。

除了您定义的任何标签之外，CloudFormation 还会自动创建带有 aws: 前缀的以下堆栈级标签：

  • aws:cloudformation:logical-id

  • aws:cloudformation:stack-id

  • aws:cloudformation:stack-name

aws: 前缀专门预留供 Amazon 使用。此前缀不区分大小写。如果您在 Key 或 Value 属性中使用此前缀，则无法更新或删除标签。具有此前缀的标签不计入每个资源的最大标签数。

堆栈级标签到资源的传播（包括带有 aws: 前缀的标签）因资源类型而异。例如，标签不会传递给从块设备映射创建的 Amazon EBS 卷。

注意

一些资源需要明确的标签传播设置。例如，AWS::AutoScaling::AutoScalingGroup 资源的 PropagateAtLaunch 属性必须设置为 true，才能将标签传播到其 EC2 实例。但是，无论 PropagateAtLaunch 设置如何，堆栈级标签都会自动应用于 EC2 实例。

语法

JSON

{
  "Key" : String,
  "Value" : String
}

YAML

Key: String
Value: String

属性

Key

标签的键名称。您可以指定一个值，该值的长度为 1 到 128 个 Unicode 字符并且不能以 aws: 为前缀。您可以使用以下任一字符：Unicode 字母、数字、空格、_、.、:、/、=、+、@、- 和 " 的组合。

必需：是

类型：字符串

Value

标签的值。您可以指定长度为 1 到 256 个字符的值。您可以使用以下任一字符：Unicode 字母、数字、空格、_、.、/、=、+ 和 - 的组合。

必需：是

类型：字符串

示例

本示例将展示 Tags 属性。您在支持该属性的资源的 Properties 部分内指定该属性。创建资源时，使用参数动态设置 Environment 标签，并将 Owner 标签静态设置为 MyName。

JSON

"Tags" : [
   {
      "Key" : "Environment",
      "Value" : { "Ref": "Environment" }
   },
   {
      "Key" : "Owner",
      "Value" : "MyName"
   }
]

YAML

Tags: 
  - Key: Environment
    Value: !Ref Environment
  - Key: Owner
    Value: MyName

另请参阅