标记 Amazon CloudWatch 资源
标签是您或 AWS 分配给 AWS 资源的自定义属性标签。
标签可帮助您:
-
标识和整理您的 AWS 资源。许多 AWS 服务都支持标记。您可以将同一标签分配给不同服务的资源,以指示这些资源是否相关。例如,您可以将分配给 CloudWatch 规则的标签分配给 EC2 实例。
标签分为两部分:
-
标签键(例如,
CostCenter
、Environment
或Project
)。标签键区分大小写。 -
一个称为标签值 的可选字段(例如,
111122223333
或Production
)。省略标签值与使用空字符串效果相同。与标签键一样,标签值区分大小写。
以下各节提供有关 CloudWatch 的标签的更多信息。
CloudWatch 中支持的资源
CloudWatch 中的以下资源支持标记:
-
警报 – 您可以使用 tag-resource AWS CLI 和 TagResource API 标记告警。您还可以通过 CloudWatch 控制台中的警报详细信息页面,来查看和管理警报标签。
-
Canary – 您可以使用 CloudWatch 控制台标记 Canary。有关更多信息,请参阅 创建金丝雀。
-
Contributor Insights 规则 – 您可以在创建 Contributor Insights 规则时使用 put-insight-rule AWS CLI 命令和 PutInsightRule API 来标记它们。您可以使用 tag-resource AWS CLI 命令和 TagResource API 向现有规则添加标签。
-
指标流 – 您可以在创建指标流时使用 put-metric-stream AWS CLI 命令和 PutMetricStream API 来标记它们。您可以使用 tag-resource AWS CLI 命令和 TagResource API 向现有指标流添加标签。
有关添加和管理标签的信息,请参阅管理标签。
管理标签
标签由资源上的 Key
和 Value
属性构成。您可以使用 CloudWatch 控制台、AWS CLI 或 CloudWatch API 添加、编辑或删除这些属性的值。有关使用标签的信息,请参阅以下内容:
-
Amazon CloudWatch API 引用中的 TagResource、UntagResource 和 ListTagsForResource
-
Amazon CloudWatch CLI 引用中的 tag-resource、untag-resource 和 list-tags-for-resource
-
Resource Groups 用户指南中的使用标签编辑器
标签命名和使用约定
以下基本命名和使用约定适用于将标签与 CloudWatch 资源一起使用的情况:
-
每个资源最多可以有 50 个标签。
-
对于每个资源,每个标签键都必须是唯一的,每个标签键只能有一个值。
-
最大标签键长度为 128 个 Unicode 字符 (采用 UTF-8 格式)。
-
最大标签值长度为 256 个 Unicode 字符 (采用 UTF-8 格式)。
-
允许使用的字符包括可用 UTF-8 格式表示的字母、数字和空格,以及以下字符:. : + = @ _ / -(连字符)。
-
标签键和值区分大小写。最佳实践是,决定利用标签的策略并在所有资源类型中一致地实施该策略。例如,决定是否使用
Costcenter
、costcenter
或CostCenter
,以及是否对所有标签使用相同的约定。避免将类似的标签用于不一致的案例处理。 -
对标签禁止使用
aws:
前缀,因为它是为使用 AWS 而保留的。无法编辑或删除带此前缀的标签键或值。具有此前缀的标签不计入每个资源的标签数限制。