资源标签 - Amazon CloudFormation
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

资源标签

您可以使用资源标签属性将标签应用于资源,这可以帮助您对这些资源进行标识和分类。只能标记 Amazon CloudFormation 对其支持标记的资源。有关可以使用 CloudFormation 进行标记的资源的信息,请参阅 Amazon 资源和属性类型参考 中的各个资源。

注意

标签实现方式可能因资源而异。例如,AWS::AutoScaling::AutoScalingGroup 提供了一个附加的必需 PropagateAtLaunch 属性,以作为其标签方案的一部分。

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

  • aws:cloudformation:logical-id

  • aws:cloudformation:stack-id

  • aws:cloudformation:stack-name

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

将堆栈级标签传递到资源(包括自动创建的标签)可能会因资源而异。例如,标签不会传递给从块设备映射创建的 Amazon EBS 卷。

语法

JSON

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

YAML

Key: String Value: String

属性

Key

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

必需:是

类型:字符串

Value

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

必需:是

类型:字符串

示例

本示例将展示 Tags 属性。您在支持该属性的资源的 Properties 部分内指定该属性。资源被创建后,会标上您声明的标签。

JSON

"Tags" : [ { "Key" : "keyname1", "Value" : "value1" }, { "Key" : "keyname2", "Value" : "value2" } ]

YAML

Tags: - Key: "keyname1" Value: "value1" - Key: "keyname2" Value: "value2"

另请参阅