AWS Database Migration Service でのリソースへのタグ付け - AWSデータベース移行サービス
API

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

AWS Database Migration Service でのリソースへのタグ付け

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ユーザーガイド の「コスト配分タグの使用」をご参照ください。

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

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

AWS DMS タグの特徴を以下に挙げます。

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

  • タグ値は、タグの省略可能な文字列値です。文字列値は、1 ～ 256 文字の Unicode 文字です。「aws:」または「dms:」をプレフィックスとして使用することはできません。文字列には、一連の Unicode 文字、数字、空白、「_」、「.」、「/」、「=」、「+」、「-」 (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」をご参照ください。

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

API

AWS DMS API を使用して AWS DMS リソースのタグを追加、一覧表示、または削除できます。

  • AWS DMS リソースにタグを追加するには、AddTagsToResource オペレーションを使用します。

  • AWS DMS リソースに割り当てられているタグを一覧表示するには、ListTagsForResource オペレーションを使用します。

  • AWS DMS リソースからタグを削除するには、RemoveTagsFromResource オペレーションを使用します。

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

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 つの別個のタグです。

タグ付け要素 説明
タグセット タグセットは、Amazon RDS リソースに割り当てられるすべてのタグのコンテナです。リソースごとに割り当て可能なのは 1 つのタグセットのみです。AWS DMS API によってのみタグセットを操作できます。
Tag タグはユーザー定義のキーと値のペアです。1 ～ 10 個のタグをタグセットに含めることができます。
キー

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

キーはタグセットに対して一意である必要があります。例えば、タグセットでキーが同じで値が異なるキーと値のペアは使用できません。例えば、project/Trinity や project/Xanadu は使用できません。
値

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

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