翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS Direct Connect リソースにタグを付ける
タグは、リソースの所有者が自分の Direct Connect リソースに割り当てるラベルです。タグはそれぞれ、1 つのキーとオプションの 1 つの値で構成されており、どちらもお客様側が定義します。タグを使用すると、Direct Connect リソースを用途、環境などのさまざまな方法で分類できます。これは、同じタイプのリソースが多数ある場合に役立ちます。割り当てたタグに基づいて特定のリソースをすばやく識別できます。
たとえば、リージョンの異なる場所に 2 つの Direct Connect 接続がある場合。接続 `dxcon-11aa22bb` は接続のための本稼働トラフィックとなり、仮想インターフェース `dxvif-33cc44dd` に関連付けられます。接続 `dxcon-abcabcab` は冗長性(バックアップ)接続となり、仮想インターフェイス `dxvif-12312312` に関連付けられます。接続と仮想インターフェイスに次のようなタグ付けをして、識別に役立たせることもできます。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/directconnect/latest/UserGuide/using-tags.html)
ニーズを満たす一連のタグキーをリソースタイプごとに考案されることをお勧めします。一貫性のあるタグキーセットを使用することで、リソースの管理が容易になります。タグには、Direct Connect に関連する意味はなく、完全に文字列として解釈されます。また、タグは自動的にリソースに割り当てられます。タグのキーと値は編集でき、タグはリソースからいつでも削除できます。タグの値を空の文字列に設定することはできますが、タグの値を null に設定することはできません。特定のリソースについて既存のタグと同じキーを持つタグを追加した場合、以前の値は新しい値によって上書きされます。リソースを削除すると、リソースのタグも削除されます。
次の Direct Connect リソースは、Direct Connect コンソール、Direct Connect API、AWS CLI、AWS Tools for Windows PowerShell、または AWS SDK を使用してタグ付けできます。このようなツールを使用してタグを管理する場合、リソースに Amazon リソースネーム (ARN) を指定する必要があります。ARN の詳細については、「*Amazon Web Services 全般のリファレンス*」の「[Amazon リソースネーム (ARN)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)」を参照してください。
| リソース | タグをサポート | 作成時のタグをサポート | アクセスとリソースの割り当てを制御するタグをサポート | コスト配分をサポート |
| --- | --- | --- | --- | --- |
| 接続 | はい | あり | あり | はい |
| 仮想インターフェイス | はい | あり | あり | いいえ |
| Link aggregation groups (LAG) | はい | あり | あり | はい |
| 相互接続 | はい | あり | あり | はい |
| Direct Connect ゲートウェイ | 可能 | あり | あり | 不可 |
## タグの制限
タグには以下のルールや制限があります。
+ リソースあたりのタグの最大数: 50
+ キーの最大長: 128 文字（Unicode）
+ 値の最大長: 265 文字 (Unicode)
+ タグのキーと値は大文字と小文字が区別されます。
+ `aws:` プレフィックスは AWS の使用のために予約されています。タグに `aws:` というプレフィックスが付いたタグキーがある場合、タグのキーまたは値を編集、削除することはできません。`aws:` プレフィックスが付いたタグキーを持つタグは、リソースあたりのタグ数の制限に数えられません。
+ 使用できる文字は、UTF-8 で表現できる文字、スペース、および数字と、特殊文字 (\$1、-、=、.、\$1、:、/、@) です。
+ タグを追加または削除できるのは、リソースの所有者のみです。たとえば、ホスト接続がある場合、パートナーはタグを追加、削除、または表示することはできません。
+ コスト配分タグは、接続、相互接続、および LAG に対してのみサポートされています。コスト管理にタグを使用する方法については、*AWS Billing and Cost Management ユーザーガイド*の「[コスト配分タグの使用](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)」を参照してください。
## CLI または API でのタグの操作
リソースのタグの追加、更新、リスト表示、および削除には、次を使用します。
| タスク | API | CLI |
| --- | --- | --- |
| 1 つ以上のタグを追加、または上書きします。 | [TagResource](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_TagResource.html) | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/tag-resource.html) |
| 1 つ以上のタグを削除します。 | [UntagResource](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_UntagResource.html) | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/untag-resource.html) |
| 1 つ以上のタグを記述します。 | [タグの説明](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_DescribeTags.html) | [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/directconnect/describe-tags.html) |
### 例
[tag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/tag-resource.html) コマンドを使用して、接続 `dxcon-11aa22bb` にタグ付けします。
```
aws directconnect tag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb --tags "key=Purpose,value=Production"
```
[describe-tags](https://docs.aws.amazon.com/cli/latest/reference/directconnect/describe-tags.html) コマンドを使用して、接続 `dxcon-11aa22bb` のタグを示します。
```
aws directconnect describe-tags --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb
```
[untag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/untag-resource.html) コマンドを使用して、接続 `dxcon-11aa22bb` からタグを削除します。
```
aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb --tag-keys Purpose
```