翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS Cloud Map リソースのタグ付け
タグは、 AWS リソースに割り当てるラベルです。タグはそれぞれ、1 つの*キー*とオプションの 1 つの*値*で構成されており、どちらもお客様側が定義します。
タグを使用すると、目的、所有者、環境などで AWS リソースを分類できます。同じ型のリソースが多い場合に、割り当てたタグに基づいて特定のリソースをすばやく識別できます。たとえば、 AWS Cloud Map サービスのタグのセットを定義して、各サービスの所有者とスタックレベルを追跡できます。リソースタイプごとに一貫した一連のタグキーを考案することをお勧めします。
タグは自動的にはリソースに割り当てられません。タグを追加したら、いつでもタグキーと値は編集でき、タグはリソースからいつでも削除できます。リソースを削除すると、リソースのタグも削除されます。
タグには に対する意味論的な意味はなく AWS Cloud Map 、厳密に文字列として解釈されます。タグの値を空の文字列に設定することはできますが、タグの値を null に設定することはできません。特定のリソースについて既存のタグと同じキーを持つタグを追加した場合、以前の値は新しい値によって上書きされます。
タグは、 AWS マネジメントコンソール、、 AWS CLIおよび AWS Cloud Map API を使用して操作できます。
AWS Identity and Access Management (IAM) を使用している場合は、 AWS アカウントのどのユーザーにタグを作成、編集、または削除するためのアクセス許可があるかを制御できます。
## リソースのタグ付け方法
新規または既存の AWS Cloud Map 名前空間とサービスにタグを付けることができます。
AWS Cloud Map コンソールを使用している場合は、関連するリソースページのタグタブを使用して、新しいリソースの作成時または既存のリソースに**タグ**をいつでも適用できます。
AWS Cloud Map API、、または AWS SDK を使用している場合は、関連する API アクションの `tags`パラメータを使用して新しいリソースにタグを適用するか AWS CLI、[TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html) API アクションを使用して既存のリソースにタグを適用できます。詳細については、「[TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html)」を参照してください。
リソース作成アクションによっては、リソースの作成時にリソースのタグを指定できます。リソースの作成時にタグを適用できない場合、リソースの作成プロセスは失敗します。これにより、作成時にタグ付けするリソースが、指定したタグで作成されるか、まったく作成されないことが確認されます。作成時にリソースにタグを付ける場合、リソースの作成後にカスタムのタグ付けスクリプトを実行する必要はありません。
次の表は、タグ付けできる AWS Cloud Map リソースと、作成時にタグ付けできるリソースを示しています。
**AWS Cloud Map リソースのタグ付けのサポート**
| リソース | タグをサポート | タグの伝播をサポート | 作成時のタグ付けをサポート (AWS Cloud Map API、 AWS CLI、 AWS SDK) |
| --- | --- | --- | --- |
| AWS Cloud Map 名前空間 | はい | いいえ。名前空間タグは、名前空間に関連付けられた他のリソースには伝達されません。 | はい |
| AWS Cloud Map サービス | はい | いいえ。サービスタグは、サービスに関連付けられた他のリソースには伝達されません。 | はい |
## 制限事項
タグには以下のベーシックな制限があります。
+ それぞれのリソースに付けることができるタグの最大数は 50 です。
+ タグキーはリソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。
+ キーの最大長 - UTF-8 の 128 Unicode 文字
+ 値の最大長 - UTF-8 の 256 Unicode 文字
+ タグ付けスキーマが複数の AWS サービスとリソースで使用されている場合は、他のサービスで許可される文字に制限がある可能性があることに注意してください。一般的に使用が許可される文字は、UTF-8 で表現できる文字、数字、スペース、および \$1、-、=、.、\$1、:、/、@。
+ タグのキーと値では、大文字と小文字が区別されます。
+ `aws:`、`AWS:`、またはキーや値のプレフィックスなど、 の大文字または小文字の組み合わせは使用しないでください。使用のために予約されています AWS 。このプレフィックスを持つタグのキーや値を編集または削除することはできません。このプレフィックスを持つタグは、リソースあたりのタグ数の制限にはカウントされません。
# AWS Cloud Map リソースのタグの更新
次の AWS CLI コマンドまたは AWS Cloud Map API オペレーションを使用して、リソースのタグを追加、更新、一覧表示、削除します。
**AWS Cloud Map リソースのタグ付けのサポート**
| タスク | API アクション | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| 1 つ以上のタグを追加、または上書きします。 | [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html) | [タグリソース](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/tag-resource.html) | [Add-SDResourceTag](https://docs.aws.amazon.com/powershell/v4/reference/items/Add-SDResourceTag.html) |
| 1 つ以上のタグを削除します。 | [UntagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_UntagResource.html) | [タグなしリソース](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/untag-resource.html) | [Remove-SDResourceTag](https://docs.aws.amazon.com/powershell/v4/reference/items/Remove-SDResourceTag.html) |
| リソースのタグの一覧表示 | [ListTagsForResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_ListTagsForResource.html) | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/list-tags-for-resource.html) | [Get-SDResourceTag](https://docs.aws.amazon.com/powershell/v4/reference/items/Get-SDResourceTag.html) |
以下の例では、 AWS CLIを使用して、リソースに対してタグ付けまたはタグ削除する方法を示しています。
**例 1: 既存のリソースにタグ付けする**
次のコマンドでは、既存のリソースにタグ付けします。
```
aws servicediscovery tag-resource --resource-arn resource_ARN --tags team=devs
```
**例 2: 既存のリソースからタグを削除する**
次のコマンドでは、既存のリソースからタグを削除します。
```
aws servicediscovery untag-resource --resource-arn resource_ARN --tag-keys tag_key
```
**例 3: リソースのタグのリスト取得**
次のコマンドは、既存のリソースに関連付けられているタグのリストを取得します。
```
aws servicediscovery list-tags-for-resource --resource-arn resource_ARN
```
一部のリソース作成アクションでは、リソースの作成時にタグを指定できます。以下のアクションでは、作成時のタグ付けがサポートされます。
| タスク | API アクション | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| HTTP 名前空間を作成する | [CreateHttpNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateHttpNamespace.html) | [create-http-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-http-namespace.html) | [New-SDHttpNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDHttpNamespace.html) |
| DNS に基づくプライベート名前空間を作成する | [CreatePrivateDnsNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreatePrivateDnsNamespace.html) | [create-private-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-private-dns-namespace.html) | [New-SDPrivateDnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPrivateDnsNamespace.html) |
| DNS に基づくパブリック名前空間を作成する | [CreatePublicDnsNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreatePublicDnsNamespace.html) | [create-public-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-public-dns-namespace.html) | [New-SDPublicDnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPublicDnsNamespace.html) |
| サービスを作成する | [CreateService](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateService.html) | [サービスの作成](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-service.html) | [New-SDService](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDService.html) |