AWS Direct Connect リソースのタグ付け

タグは、リソース所有者が AWS Direct Connect リソースに割り当てるラベルです。タグはそれぞれ、1 つのキーとオプションの 1 つの値で設定されており、どちらもお客様側が定義します。タグを使用すると、リソース所有者は、目的や環境など、さまざまな方法で AWS Direct Connect リソースを分類できます。これは、同じタイプのリソースが多数ある場合に役立ちます。割り当てたタグに基づいて特定のリソースをすばやく識別できます。

例えば、1 つのリージョンに 2 つの AWS Direct Connect 接続があり、それぞれが異なる場所にあります。接続 dxcon-11aa22bb は接続のための本稼働トラフィックとなり、仮想インターフェース dxvif-33cc44dd に関連付けられます。接続 dxcon-abcabcab は冗長性(バックアップ)接続となり、仮想インターフェイス dxvif-12312312 に関連付けられます。接続と仮想インターフェイスに次のようなタグ付けをして、識別に役立たせることもできます。

[Resource ID (リソース ID)]	タグキー	タグ値
dxcon-11aa22bb	目的	本番稼働用
	場所	アムステルダム
dxvif-33cc44dd	目的	本番稼働用
dxcon-abcabcab	目的	バックアップ
	場所	フランクフルト
dxvif-12312312	目的	バックアップ

ニーズを満たす一連のタグキーをリソースタイプごとに考案されることをお勧めします。一貫性のある一連のタグキーを使用することで、リソースの管理が容易になります。タグには意味論的な意味はなく AWS Direct Connect 、文字列として厳密に解釈されます。また、タグは自動的にリソースに割り当てられます。タグのキーと値は編集でき、タグはリソースからいつでも削除できます。タグの値を空の文字列に設定することはできますが、タグの値を null に設定することはできません。特定のリソースについて既存のタグと同じキーを持つタグを追加した場合、以前の値は新しい値によって上書きされます。リソースを削除すると、リソースのタグも削除されます。

AWS Direct Connect コンソール、、、 AWS Direct Connect API、 AWS Tools for Windows PowerShellまたは を使用して AWS CLI、次の AWS Direct Connect リソースにタグを付けることができます AWS SDK。これらのツールを使用してタグを管理する場合は、リソースの Amazon リソースネーム (ARN) を指定する必要があります。の詳細についてはARNs、「」の「Amazon リソースネーム (ARNs）」を参照してくださいAmazon Web Services 全般のリファレンス。

リソース	タグをサポート	作成時のタグをサポート	アクセスとリソースの割り当てを制御するタグをサポート	コスト配分をサポート
接続	はい	はい	はい	はい
仮想インターフェイス	はい	はい	はい	なし
リンク集約グループ (LAG）	あり	はい	はい	はい
相互接続	はい	はい	はい	はい
Direct Connect ゲートウェイ	いいえ	いいえ	いいえ	いいえ

タグの制限

タグには以下のルールや制限があります。

• リソースあたりのタグの最大数: 50

• キーの最大長: 128 文字（Unicode）

• 値の最大長: 265 文字 (Unicode)

• タグのキーと値は大文字と小文字が区別されます。

• aws: プレフィックスは AWS 用に予約されています。タグに aws: というプレフィックスが付いたタグキーがある場合、タグのキーまたは値を編集、削除することはできません。aws: プレフィックスが付いたタグキーを持つタグは、リソースあたりのタグ数の制限に数えられません。

• 使用できる文字は、UTF-8 で表される文字、スペース、および数字と、+ - = . _ : / @ の特殊文字です。

• タグを追加または削除できるのは、リソースの所有者のみです。たとえば、ホスト接続がある場合、パートナーはタグを追加、削除、または表示することはできません。

• コスト配分タグは、接続、相互接続、および でのみサポートされますLAGs。コスト管理でタグを使用する方法については、「 ユーザーガイド」の「コスト配分タグの使用」を参照してください。 AWS Billing and Cost Management

CLI または を使用したタグの操作 API

リソースのタグの追加、更新、リスト表示、および削除には、次を使用します。

タスク	API	CLI
1 つ以上のタグを追加、または上書きします。	TagResource	タグリソース
1 つ以上のタグを削除します。	UntagResource	タグなしリソース
1 つ以上のタグを記述します。	DescribeTags	describe-tags

例

tag-resource コマンドを使用して、接続 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 コマンドを使用して、接続 dxcon-11aa22bb のタグを示します。

aws directconnect describe-tags --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb

untag-resource コマンドを使用して、接続 dxcon-11aa22bb からタグを削除します。

aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb --tag-keys Purpose