翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS Database Migration Service でのリソースへのタグ付け
<a name="CHAP_Tagging"></a>

AWS Database Migration Service (AWS DMS) でタグを使用してリソースにメタデータを追加できます。また、これらのタグを AWS Identity and Access Management (IAM) ポリシーで使用して、AWS DMS リソースへのアクセスを管理したり、AWS DMS リソースに適用できるアクションを制御したりできます。最後に、これらのタグを使用して、類似のリソースの費用をグループ化することで、コストを追跡できます。

以下のすべての AWS DMS リソースにタグを付けることができます:
+ 証明書
+ データプロバイダー
+ データの移行
+ エンドポイント
+ イベントサブスクリプション
+ インスタンスプロファイル
+ 移行プロジェクト
+ レプリケーション インスタンス
+ レプリケーションサブネットグループ
+ レプリケーションタスク

AWS DMS タグは、AWS DMS リソースを定義してそのリソースに関連付ける名前と値のペアです。その名前はキーと呼ばれます。キーの値の指定は省略可能です。タグを使用して、AWS DMS リソースに任意の情報を割り当てることができます。たとえば、タグキーを使用してカテゴリを定義し、タグ値をそのカテゴリのアイテムにすることができます。たとえば、「project」というタグキーと「Salix」というタグ値を定義して、AWS DMS リソースが Salix プロジェクトに割り当てられていることを示すことができます。また、タグキーとして environment=test や environment=production などを使用して、AWS DMS リソースがテスト用なのか本稼働用なのかを示すこともできます。AWS DMS リソースに関連付けられているメタデータの追跡が簡単になるように、一貫したタグキー集合を使用することをお勧めします。

タグを使用して、自分のコスト構造を反映するように AWS 請求書を整理します。そのためには、サインアップして、タグキー値が含まれた AWS アカウント の請求書を取得する必要があります。次に、結合したリソースのコストを見るには、同じタグキー値のリソースに従って請求書情報を整理します。例えば、複数のリソースに特定のアプリケーション名のタグを付け、請求情報を整理することで、複数のサービスを利用しているアプリケーションの合計コストを確認することができます。詳細については、*AWS Billingユーザーガイド* の「[コスト配分タグの使用](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)」をご参照ください。

各 AWS DMS リソースにはタグセットがあり、AWS DMS リソースに割り当てられているすべてのタグが含まれています。タグセットには、最大 10 個のタグを格納でき、空にすることもできます。AWS DMS リソースに追加したタグのキーがそのリソースの既存のタグのキーと同じ場合、既存の値は新しい値によって上書きされます。

AWS は、タグに意味を適用せず、タグは文字列として厳密に解釈されます。AWSリソース作成時に使用する設定によっては、DMS によって AWS DMS リソースにタグが設定されることがあります。

AWS DMS タグの特徴を以下に挙げます。
+ タグキーは、必須のタグ名です。文字列値は、1〜128 文字の Unicode 文字です。「aws:」または「dms:」をプレフィックスとして使用することはできません。文字列には、一連の Unicode 文字、数字、空白、「\$1」、「.」、「/」、「=」、「\$1」、「-」 (Java 正規表現: `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`) を含めることができます。
+ タグ値は、タグの省略可能な文字列値です。文字列値は、1 ～ 256 文字の Unicode 文字です。「aws:」または「dms:」をプレフィックスとして使用することはできません。文字列には、一連の Unicode 文字、数字、空白、「\$1」、「.」、「/」、「=」、「\$1」、「-」 (Java 正規表現: `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`) を含めることができます。

  値はタグセット内で一意である必要はなく、null を指定できます。例えば、project/Trinity と cost-center/Trinity のタグセット内に 1 つのキーと値のペアを使用できます。

AWS CLI または AWS DMS API を使用して、AWS DMS リソースにタグの追加、一覧表示、または削除ができます。AWS CLI または AWS DMS API を使用するときは、操作する AWS DMS リソースの Amazon リソースネーム (ARN)を指定する必要があります。ARN の作成の詳細については、「[の Amazon リソースネーム (ARN) の構築 AWS DMS](CHAP_Introduction.AWS.ARN.md)」をご参照ください。

タグはリソース承認用にキャッシュに格納されます。そのため、AWS DMS リソースに対するタグの追加や更新には数分かかることがあります。

## API
<a name="CHAP_Tagging.API"></a>

AWS DMS API を使用して AWS DMS リソースのタグを追加、一覧表示、または削除できます。
+ AWS DMS リソースにタグを追加するには、[https://docs.aws.amazon.com/dms/latest/APIReference/API_AddTagsToResource.html](https://docs.aws.amazon.com/dms/latest/APIReference/API_AddTagsToResource.html) オペレーションを使用します。
+ AWS DMS リソースに割り当てられているタグを一覧表示するには、[https://docs.aws.amazon.com/dms/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/dms/latest/APIReference/API_ListTagsForResource.html) オペレーションを使用します。
+ AWS DMS リソースからタグを削除するには、[https://docs.aws.amazon.com/dms/latest/APIReference/API_RemoveTagsFromResource.html](https://docs.aws.amazon.com/dms/latest/APIReference/API_RemoveTagsFromResource.html) オペレーションを使用します。

必要な ARN を作成する方法の詳細については、「[の Amazon リソースネーム (ARN) の構築 AWS DMS](CHAP_Introduction.AWS.ARN.md)」をご参照ください。

AWS DMS API を使用して XML を操作する場合、タグでは以下のスキーマを使用します：

```
<Tagging>
  <TagSet>
  	<Tag>
  		<Key>Project</Key>
  		<Value>Trinity</Value>
  	</Tag>
  	<Tag>
  		<Key>User</Key>
  		<Value>Jones</Value>
  	</Tag>
  </TagSet>
</Tagging>
```

以下の表に示しているのは、使用可能な XML タグとその特性のリストです。キーと値では大文字と小文字が区別されます。例えば、project=Trinity と PROJECT=Trinity は 2 つの別個のタグです。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/dms/latest/userguide/CHAP_Tagging.html)