# 标记 Amazon CloudWatch 资源
<a name="CloudWatch-Tagging"></a>

 *标签*是您或 Amazon 分配给 Amazon 资源的自定义属性标签。

 标签可帮助您：
+  标识和整理您的 Amazon 资源。许多 Amazon 服务都支持标记。您可以将同一标签分配给不同服务的资源，以指示这些资源是否相关。例如，您可以将分配给 CloudWatch 规则的标签分配给 EC2 实例。

 标签分为两部分：
+  *标签键*（例如，`CostCenter`、`Environment` 或 `Project`）。标签键区分大小写。
+  一个称为*标签值* 的可选字段（例如，`111122223333` 或 `Production`）。省略标签值与使用空字符串效果相同。与标签键一样，标签值区分大小写。

 以下各节提供有关 CloudWatch 的标签的更多信息。

## CloudWatch 中支持的资源
<a name="supported-resources"></a>

CloudWatch 中的以下资源支持标记：
+ 警报 – 您可以使用 [tag-resource](https://docs.amazonaws.cn/cli/latest/reference/cloudwatch/tag-resource.html) Amazon CLI 和 [TagResource](https://docs.amazonaws.cn/AmazonCloudWatch/latest/APIReference/API_TagResource.html) API 标记告警。您还可以通过 CloudWatch 控制台中的*警报*详细信息页面，来查看和管理警报标签。
+ Canary – 您可以使用 CloudWatch 控制台标记 Canary。有关更多信息，请参阅 [创建金丝雀](CloudWatch_Synthetics_Canaries_Create.md)。
+ Contributor Insights 规则 – 您可以在创建 Contributor Insights 规则时使用 [put-insight-rule](https://docs.amazonaws.cn/cli/latest/reference/cloudwatch/put-insight-rule.html) Amazon CLI 命令和 [PutInsightRule](https://docs.amazonaws.cn/AmazonCloudWatch/latest/APIReference/API_PutInsightRule.html) API 来标记它们。您可以使用 [tag-resource](https://docs.amazonaws.cn/cli/latest/reference/cloudwatch/tag-resource.html) Amazon CLI 命令和 [TagResource](https://docs.amazonaws.cn/AmazonCloudWatch/latest/APIReference/API_TagResource.html) API 向现有规则添加标签。
+ 指标流 – 您可以在创建指标流时使用 [put-metric-stream](https://docs.amazonaws.cn/cli/latest/reference/cloudwatch/put-metric-stream.html) Amazon CLI 命令和 [PutMetricStream](https://docs.amazonaws.cn/AmazonCloudWatch/latest/APIReference/API_PutMetricStream.html) API 来标记它们。您可以使用 [tag-resource](https://docs.amazonaws.cn/cli/latest/reference/cloudwatch/tag-resource.html) Amazon CLI 命令和 [TagResource](https://docs.amazonaws.cn/AmazonCloudWatch/latest/APIReference/API_TagResource.html) API 向现有指标流添加标签。

有关添加和管理标签的信息，请参阅[管理标签](#CloudWatch-tagging-add-edit-delete)。

## 管理标签
<a name="CloudWatch-tagging-add-edit-delete"></a>

标签由资源上的 `Key` 和 `Value` 属性构成。您可以使用 CloudWatch 控制台、Amazon CLI 或 CloudWatch API 添加、编辑或删除这些属性的值。有关使用标签的信息，请参阅以下内容：
+ *Amazon CloudWatch API 引用*中的 [TagResource](https://docs.amazonaws.cn/AmazonCloudWatch/latest/APIReference/API_TagResource.html)、[UntagResource](https://docs.amazonaws.cn/AmazonCloudWatch/latest/APIReference/API_UntagResource.html) 和 [ListTagsForResource](https://docs.amazonaws.cn/AmazonCloudWatch/latest/APIReference/API_ListTagsForResource.html)
+ *Amazon CloudWatch CLI 引用*中的 [tag-resource](https://docs.amazonaws.cn/cli/latest/reference/cloudwatch/tag-resource.html)、[untag-resource](https://docs.amazonaws.cn/cli/latest/reference/cloudwatch/untag-resource.html) 和 [list-tags-for-resource](https://docs.amazonaws.cn/cli/latest/reference/cloudwatch/list-tags-for-resource.html)
+ *Resource Groups 用户指南*中的[使用标签编辑器](https://docs.amazonaws.cn/ARG/latest/userguide/tag-editor.html)

## 标签命名和使用约定
<a name="tagging-restrictions"></a>

以下基本命名和使用约定适用于将标签与 CloudWatch 资源一起使用的情况：
+ 每个资源最多可以有 50 个标签。
+ 对于每个资源，每个标签键都必须是唯一的，每个标签键只能有一个值。
+ 最大标签键长度为 128 个 Unicode 字符 (采用 UTF-8 格式)。
+ 最大标签值长度为 256 个 Unicode 字符 (采用 UTF-8 格式)。
+ 允许使用的字符包括可用 UTF-8 格式表示的字母、数字和空格，以及以下字符：***. : \$1 = @ \$1 / -***（连字符）。
+ 标签键和值区分大小写。最佳实践是，决定利用标签的策略并在所有资源类型中一致地实施该策略。例如，决定是否使用 `Costcenter`、`costcenter` 或 `CostCenter`，以及是否对所有标签使用相同的约定。避免将类似的标签用于不一致的案例处理。
+ 对标签禁止使用 `aws:` 前缀，因为它是为使用 Amazon 而保留的。无法编辑或删除带此前缀的标签键或值。具有此前缀的标签不计入每个资源的标签数限制。