# AWS WA Tool リソースのタグ付け
AWS WA Tool リソースを管理しやすくするために、*タグ*形式で各リソースに独自のメタデータを割り当てることができます。ここではタグとその作成方法について説明します。
**Topics**
+ [タグの基本](#tag-basics)
+ [リソースのタグ付け](#tag-resources)
+ [タグの制限](#tag-restrictions)
+ [コンソールでのタグの処理](#tag-resources-console)
+ [API を使用したタグの操作](#tag-resources-api-sdk)
## タグの基本
タグとはAWS リソースに割り当てるラベルです。タグはそれぞれ、1 つの*キー*とオプションの 1 つの*値*で構成されており、どちらもお客様側が定義します。
タグを使用すると、AWS リソースを目的、所有者、環境などで分類できます。同じ型のリソースが多い場合に、割り当てたタグに基づいて特定のリソースをすばやく識別できます。たとえば、AWS WA Tool サービスに一連のタグを定義して、各サービスの所有者とスタックレベルを追跡できます。リソースタイプごとに一貫した一連のタグキーを考案することをお勧めします。
タグは自動的にはリソースに割り当てられません。タグを追加したら、いつでもタグキーと値は編集でき、タグはリソースからいつでも削除できます。リソースを削除すると、リソースのタグも削除されます。
タグには、AWS WA Tool に関連する意味はなく、完全に文字列として解釈されます。タグの値を空の文字列に設定することはできますが、タグの値を null に設定することはできません。特定のリソースについて既存のタグと同じキーを持つタグを追加した場合、以前の値は新しい値によって上書きされます。
AWS マネジメントコンソール、AWS CLI、および AWS WA Tool API を使用してタグを操作できます。
AWS Identity and Access Management (IAM) を使用している場合は、タグを作成、編集、削除するためのアクセス許可を持つ AWS アカウントのユーザーを制御できます。
## リソースのタグ付け
新しいまたは既存の AWS WA Tool リソースにタグを付けることができます。
AWS WA Tool コンソールを使用している場合、新しいリソースには作成時にタグを適用でき、既存のリソースにはいつでもタグを適用できます。既存のワークロードには、**[プロパティ]** タブからタグを適用できます。既存のカスタムレンズ、プロファイル、レビューテンプレートには、**[概要]** タブからタグを適用できます。
AWS WA Tool API、AWS CLI、または AWS SDK を使用している場合、新しいリソースには、関連する API アクションの `tags` パラメータを使用してタグを適用でき、既存のリソースには、`TagResource` API アクションを使用してタグを適用できます。詳細については、「[TagResource](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html)」を参照してください。
リソース作成アクションによっては、リソースの作成時にリソースのタグを指定できます。リソースの作成時にタグを適用できない場合、リソースの作成プロセスは失敗します。これにより、作成時にタグ付けするリソースが、指定したタグで作成されるか、まったく作成されないことが確認されます。作成時にリソースにタグを付ける場合、リソースの作成後にカスタムのタグ付けスクリプトを実行する必要はありません。
次の表では、タグ付け可能な AWS WA Tool リソースと、作成時にタグ付け可能なリソースについて説明します。
**AWS WA Tool リソースのタグ付けのサポート**
| リソース | タグをサポート | タグの伝播をサポート | 作成時のタグ付けをサポート (AWS WA Tool API、AWS CLI、AWS SDK) |
| --- | --- | --- | --- |
| AWS WA Tool ワークロード | はい | なし | あり |
| AWS WA Tool カスタムレンズ | はい | なし | あり |
| AWS WA Tool プロファイル | はい | なし | あり |
| AWS WA Tool レビューテンプレート | はい | なし | あり |
## タグの制限
タグには以下のような基本制限があります。
+ リソースあたりのタグの最大数 - 50 件
+ タグキーはリソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。
+ キーの最大長 - UTF-8 の 128 Unicode 文字
+ 値の最大長 - UTF-8 の 256 Unicode 文字
+ 複数の AWS サービス間およびリソース間でタグ付けスキーマを使用する場合、他のサービスでも許可される文字に制限が適用されることがあるのでご注意ください。一般的に使用が許可される文字は、UTF-8 で表現できる文字、数字、スペース、および \+、-、=、.、\_、:、/、@。
+ タグのキーと値では、大文字と小文字が区別されます。
+ `aws:`、`AWS:`、またはその大文字または小文字の組み合わせを、キーまたは値のプレフィックスとして使用しないでください。これらの文字列は AWS による使用のために予約されています。このプレフィックスを持つタグのキーや値を編集または削除することはできません。このプレフィックスを持つタグは、リソースあたりのタグ数の制限時には計算されません。
## コンソールでのタグの処理
AWS WA Tool コンソールを使用すると、新しいリソースまたは既存のリソースに関連付けられたタグを管理できます。
### 作成時に個々のリソースにタグを追加する
リソースを作成時に AWS WA Tool リソースにタグを追加できます。
### 個々のリソースでタグを追加および削除する
AWS WA Tool を使用すると、ワークロードの **[プロパティ] **タブおよびカスタムレンズ、プロファイル、レビューテンプレートの **[概要]** タブから直接リソースに関連付けられているタグを追加または削除できます。
**ワークロードのタグを追加または削除するには**
1. AWS マネジメントコンソール にサインインし、[https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/) で AWS Well-Architected Tool のコンソールを開きます。
1. ナビゲーションバーから、使用するリージョンを選択します。
1. ナビゲーションペインで **[Workloads]** (ワークロード) を選択します。
1. 修正するワークロードを選択し、**[Properties]** (プロパティ) を選択します。
1. **[タグ]** セクションで、**[タグを管理]** を選択します。
1. 必要に応じてタグを追加または削除します。
+ タグを追加するには、**[Add new tag]** (新しいタグの追加) を選択し、**[Key]** (キー) と **[Value]** (値) のフィールドに入力します。
+ タグを削除するには、**[削除]** を選択します。
1. 追加、変更、削除を行うタグごとにこのプロセスを繰り返します。**[保存]** を選択して変更を保存します。
**カスタムレンズのタグを追加または削除するには**
1. AWS マネジメントコンソール にサインインし、[https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/) で AWS Well-Architected Tool のコンソールを開きます。
1. ナビゲーションバーから、使用するリージョンを選択します。
1. ナビゲーションペインで **[カスタムレンズ]** を選択します。
1. 変更するカスタムレンズの名前を選択します。
1. **[概要]** タブの **[タグ]** セクションで、**[タグを管理]** を選択します。
1. 必要に応じてタグを追加または削除します。
+ タグを追加するには、**[Add new tag]** (新しいタグの追加) を選択し、**[Key]** (キー) と **[Value]** (値) のフィールドに入力します。
+ タグを削除するには、**[削除]** を選択します。
1. 追加、変更、削除を行うタグごとにこのプロセスを繰り返します。**[保存]** を選択して変更を保存します。
**プロファイルでタグを追加または削除するには**
1. AWS マネジメントコンソール にサインインし、[https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/) で AWS Well-Architected Tool のコンソールを開きます。
1. ナビゲーションバーから、使用するリージョンを選択します。
1. ナビゲーションペインで **[プロファイル]** を選択します。
1. 修正するプロファイルの名前を選択します。
1. **[概要]** タブの **[タグ]** セクションで、**[タグを管理]** を選択します。
1. 必要に応じてタグを追加または削除します。
+ タグを追加するには、**[Add new tag]** (新しいタグの追加) を選択し、**[Key]** (キー) と **[Value]** (値) のフィールドに入力します。
+ タグを削除するには、**[削除]** を選択します。
1. 追加、変更、削除を行うタグごとにこのプロセスを繰り返します。**[保存]** を選択して変更を保存します。
**レビューテンプレートでタグを追加または削除するには**
1. AWS マネジメントコンソール にサインインし、[https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/) で AWS Well-Architected Tool のコンソールを開きます。
1. ナビゲーションバーから、使用するリージョンを選択します。
1. ナビゲーションペインで **[レビューテンプレート]** を選択します。
1. 変更するレビューテンプレートの名前を選択します。
1. **[概要]** タブの **[タグ]** セクションで、**[タグを管理]** を選択します。
1. 必要に応じてタグを追加または削除します。
+ タグを追加するには、**[Add new tag]** (新しいタグの追加) を選択し、**[Key]** (キー) と **[Value]** (値) のフィールドに入力します。
+ タグを削除するには、**[削除]** を選択します。
1. 追加、変更、削除を行うタグごとにこのプロセスを繰り返します。**[保存]** を選択して変更を保存します。
## API を使用したタグの操作
リソースのタグの追加、更新、リスト表示、および削除には、次の AWS WA Tool API オペレーションを使用します。
**AWS WA Tool リソースのタグ付けのサポート**
| タスク | API アクション |
| --- | --- |
| 1 つ以上のタグを追加、または上書きします。 | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html) |
| 1 つ以上のタグを削除します。 | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_UntagResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_UntagResource.html) |
| リソースのタグを一覧表示します。 | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ListTagsForResource.html) |
一部のリソース作成アクションでは、リソースの作成時にタグを指定できます。以下のアクションでは、作成時のタグ付けがサポートされます。
| タスク | API アクション |
| --- | --- |
| ワークロードの作成 | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateWorkload.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateWorkload.html) |
| 新しいレンズをインポートする | [ImportLens](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ImportLens.html) |
| プロファイルを作成する | [CreateProfile](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateProfile.html) |
| レビューテンプレートを作成する | [CreateReviewTemplate](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateReviewTemplate.html) |