# Amazon CloudWatch リソースにタグを付ける
<a name="CloudWatch-Tagging"></a>

 タグ**は、ユーザーまたは AWS が AWS リソースに割り当てるカスタム属性ラベルです。

 タグは、以下のことに役立ちます。
+  AWS リソースを識別および整理します。多くの AWS サービスではタグ付けがサポートされています。さまざまなサービスのリソースに同じタグを割り当てて、それらのリソースが関連していることを示すことができます。例えば、CloudWatch ルールに割り当てたタグを EC2 インスタンスに割り当てることができます。

 タグは 2 つの部分で構成されています。
+  *タグキー* (例： `CostCenter`、`Environment`、または `Project`)。タグキーでは、大文字と小文字が区別されます。
+  *タグ値*として知られるオプションのフィールド (例： `111122223333` または `Production`)。タグ値を省略すると、空の文字列を使用した場合と同じになります。タグキーと同様に、タグ値では大文字と小文字が区別されます。

 以下のセクションでは、CloudWatch のタグに関する詳細を示します。

## CloudWatch でサポートされるリソース
<a name="supported-resources"></a>

CloudWatch の次のリソースは、タグ付けをサポートしています。
+ アラーム － アラームにタグを付けるには、[tag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/tag-resource.html) AWS CLI コマンドと [TagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html) API を使用します。CloudWatch コンソールの [アラーム] の詳細ページを使用して、アラームタグを表示および管理することもできます。
+ Canary – Canary にタグを付けるには、CloudWatch コンソールを使用できます。詳細については、「[Canary を作成する](CloudWatch_Synthetics_Canaries_Create.md)」を参照してください。
+ Contributor Insights ルール － Contributor Insights ルールにタグを付けるには、そのルールの作成時に [put-insight-rule](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-insight-rule.html) AWS CLI コマンドと [PutInsightRule API](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutInsightRule.html) を使用します。既存のルールにタグを追加するには、[tag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/tag-resource.html) AWS CLI コマンドと [TagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html) API を使用できます。
+ メトリクスストリーム － メトリクスストリームを作成する場合、[put-metric-stream](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-stream.html) AWS CLI コマンドと [PutMetricStream](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricStream.html) API を使用して、メトリクスストリームにタグを付けることができます。既存のメトリクスストリームタグを追加するには、[tag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/tag-resource.html) AWS CLI コマンドと [TagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html) API を使用します。

タグの追加と管理の詳細については、「[タグの管理](#CloudWatch-tagging-add-edit-delete)」を参照してください。

## タグの管理
<a name="CloudWatch-tagging-add-edit-delete"></a>

タグは、リソースの `Key` および `Value` プロパティで構成されています。このようなプロパティの値を追加、編集、削除するには、CloudWatch コンソール、AWS CLI、または CloudWatch API を使用できます。タグの使用については、以下を参照してください。
+ 「Amazon CloudWatch API リファレンス」の「[TagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html)」、「[UntagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UntagResource.html)」、「[ListTagsForResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListTagsForResource.html)」
+ 『*Amazon CloudWatch CLI リファレンス*』の [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/tag-resource.html)、[untag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/untag-resource.html)、および [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-tags-for-resource.html)
+ *Resource Groups ユーザーガイド*の「[タグエディタの使用](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)」

## タグの命名規則と使用規則
<a name="tagging-restrictions"></a>

CloudWatch リソースでのタグの使用には、次の基本的な命名規則と使用規則が適用されます。
+ 各リソースには、最大 50 個のタグを設定できます。
+ タグキーは、リソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。
+ タグキーの最大長は UTF-8 で 128 Unicode 文字です。
+ タグ値の最大長は UTF-8 で 256 Unicode 文字です。
+ 使用できる文字は、UTF-8 対応の文字、数字、スペースと、文字 (***. ： \$1 = @ \$1 / -***) (ハイフン) です。
+ タグのキーと値では、大文字と小文字が区別されます。ベストプラクティスとして、タグでの大文字の使用方針を決定し、その方針をすべてのリソースタイプで一貫して実装することをお勧めします。例えば、`Costcenter`、`costcenter`、`CostCenter` のいずれを使用するかを決定し、すべてのタグに同じ規則を使用します。大文字と小文字の扱いについて、同様のタグに整合性のない規則を使用することは避けてください。
+ `aws:` プレフィックスは AWS の使用に予約されているため、タグで使用することはできません。このプレフィックスを持つタグのキーや値を編集または削除することはできません。このプレフィックスを持つタグは、リソースあたりのタグ数の制限にはカウントされません。