资源标签 - 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 使用。此前缀不区分大小写。如果您在 Key 或 Value 属性中使用此前缀，则无法更新或删除标签。具有此前缀的标签不计入每个资源的最大标签数。

将堆栈级标签传递到资源（包括自动创建的标签）可能会因资源而异。例如，标签不会传递给从块设备映射创建的 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"

另请参阅