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

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

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 は、タグにセマンティックな意義は適用せず、タグは厳密に文字列として解釈されます。AWSDMS は、リソースの作成時に使用した設定に応じて、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 のタグセット内にキーバリューのペアを使用できます。

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

タグ付け要素 説明
TagSet タグセットは Amazon RDS リソースに割り当てられたすべてのタグのコンテナ。リソースごとに設定できるタグは 1 つのみ。TagSet は、AWS DMS API を介してのみ使用できる。
Tag タグはユーザー定義のキーバリューペア。単一のタグセットには 1~10 個のタグを含めることができる。
Key

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

キーはタグセットに一意である必要がある。例えば、project/Trinity と project/Xanadu のように、キーは同じで値が異なるキーペアをタグセットに含めることはできない。

Value

値は、タグのオプションの値。文字列値の長さは 1~256 の Unicode 文字で、プレフィックスとして「dms:」または「aws:」を付けることはできない。文字列には、Unicode 文字、数字、空白、「_」、「.」、「/」、「=」、「+」、「-」(Java 正規表現: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$") のセットのみを含めることができる。

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