メニュー
Amazon Relational Database Service
ユーザーガイド (API Version 2014-10-31)

Amazon RDS リソースのタグ付け

Amazon RDS タグを使用して Amazon RDS リソースにメタデータを追加できます。また、これらのタグを IAM ポリシーで使用して、Amazon RDS リソースへのアクセスを管理したり、Amazon RDS リソースに適用できるアクションを制御したりできます。さらに、これらのタグを類似のリソースに付けて、それらのリソースの費用をグループ化することで、コストを追跡できます。

以下のすべての Amazon RDS リソースにタグを付けることができます

IAM ポリシーでタグ付きリソースへのアクセスを管理する方法については、「Amazon RDS に対する認証とアクセスコントロール」を参照してください。

Amazon RDS リソースタグの概要

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

タグを使用して、ユーザー独自のコスト構造を反映するように AWS 請求を整理します。そのためには、AWS アカウントにサインアップして、タグキー値が含まれた AWS アカウントの請求書を取得する必要があります。次に、結合したリソースのコストを見るには、同じタグキー値のリソースに従って請求書情報を整理します。たとえば、複数のリソースに特定のアプリケーション名のタグを付け、請求情報を整理することで、複数のサービスを利用しているアプリケーションの合計コストを確認することができます。詳細については、AWS 請求情報とコスト管理情報についての「コスト配分とタグ付け」を参照してください。

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

AWS は、タグに意味を適用しません。タグは文字列として厳密に解釈されます。リソース作成時に使用する設定によっては、Amazon RDS によって DB インスタンスまたは他の Amazon RDS リソースにタグが設定されることがあります。たとえば、Amazon RDS によって DB インスタンスが本稼働用またはテスト用であることを示すタグが追加されることがあります。

DB インスタンスタグの特徴は以下のとおりです。

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

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

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

AWS マネジメントコンソール、コマンドラインインターフェイス、または Amazon RDS API を使用して、Amazon RDS リソースに対してタグを追加、一覧表示、削除できます。コマンドラインインターフェイスまたは Amazon RDS API を使用するときは、操作する Amazon RDS リソースの Amazon リソースネーム (ARN) を指定する必要があります。ARN の作成の詳細については、「Amazon RDS 用 ARN の構築」を参照してください。

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

タグのコピー

DB インスタンスを作成または復元するとき、DB インスタンスから DB インスタンスのスナップショットにタグがコピーされるように指定できます。タグをコピーすると、DB スナップショットとソース DB インスタンスのメタデータが確実に一致し、また、DB スナップショットとソース DB インスタンスのアクセスポリシーが確実に一致するようになります。タグは、デフォルトではコピーされません。

次のアクションでタグが DB スナップショットにコピーされるように指定できます。

  • DB インスタンスの作成

  • DB インスタンスの復元

  • リードレプリカの作成.

  • DB スナップショットのコピー

rds-create-db-snapshot AWS CLI コマンドの --tag-key パラメータの値を含めた場合 (または、CreateDBSnapshot API アクションにタグを少なくとも 1 つ指定した場合)、RDS はソース DB インスタンスから新しい DB スナップショットにタグをコピーしません。この機能は、ソース DB インスタンスの --copy-tags-to-snapshot (CopyTagsToSnapshot) オプションが有効になっている場合でも、適用されます。このアプローチを使用すると、新しい DB インスタンスに適用されないタグを追加することなく、DB スナップショットから DB インスタンスのコピーを作成できます。AWS CLI の create-db-snapshot コマンド (または CreateDBSnapshot Amazon RDS API アクション) を使用して DB スナップショットを作成した後、このトピックで説明しているように、タグを追加することができます。

AWS マネジメントコンソール

Amazon RDS リソースにタグを追加するプロセスはすべてのリソースで同様です。以下の手順では、Amazon RDS DB インスタンスにタグを付加する方法を示します。

DB インスタンスにタグを追加するには

  1. AWS マネジメントコンソールにサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[Instances] を選択します。

    注記

    [DB Instances] ペインで DB インスタンスのリストをフィルタするには、[Viewing] ボックスの横にあるボックスにテキスト文字列を入力します。その文字列を含む DB インスタンスのみが表示されます。

  3. タグを付加する DB インスタンスを選択します。インラインの概要が表示されます。

  4. インラインの概要で、詳細アイコンを選択して詳細セクションを開きます。

     コンソールの詳細アイコン
  5. 詳細セクションで、下にスクロールし、[Tags] を選択してタグセクションを開きます。

  6. [Add/Edit Tags] を選択します。[Tag DB instance] ペインが表示されます。

     コンソールの [Tag DB Instances] ペイン
  7. [Add another Tag] を選択します。

  8. タグのキーと値を入力し、[Save Tags] を選択します。

DB インスタンスからタグを削除するには

  1. AWS マネジメントコンソールにサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインの [Instances] をクリックします。

    注記

    [DB Instances] ペインで DB インスタンスのリストをフィルタするには、[Viewing] ボックスの横にあるボックスにテキスト文字列を入力します。その文字列を含む DB インスタンスのみが表示されます。

  3. タグを削除する対象の DB インスタンスを選択します。インラインの概要が表示されます。

  4. インラインの概要で、詳細アイコンを選択して詳細セクションを開きます。

     コンソールの詳細アイコン
  5. 詳細セクションで、下にスクロールし、[Tags] を選択してタグセクションを開きます。

  6. [Add/Edit Tags] を選択します。[Tag DB instance] ペインが表示されます。

     コンソールの [Tag DB Instances] ペイン
  7. 削除するタグの横にある [Remove] 列の赤色の X を選択し、[Save Tags] を選択します。

CLI

AWS CLI を使用して DB インスタンスのタグを追加、一覧表示、または削除できます。

  • Amazon RDS リソースに 1 つ以上のタグを追加するには、AWS CLI コマンド add-tags-to-resource を使用します。

  • Amazon RDS リソースのタグを一覧表示するには、AWS CLI コマンド list-tags-for-resource を使用します。

  • Amazon RDS リソースから 1 つ以上のタグを削除するには、AWS CLI コマンド remove-tags-from-resource を使用します。

必要な ARN を作成する方法の詳細については、「Amazon RDS 用 ARN の構築」を参照してください。

API

Amazon RDS API を使用して DB インスタンスのタグを追加、一覧表示、または削除できます。

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

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

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

必要な ARN を作成する方法の詳細については、「Amazon RDS 用 ARN の構築」を参照してください。

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

Copy
<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 つのタグセットのみです。Amazon RDS API によってのみタグセットを操作できます。
Tag タグはユーザー定義のキーと値のペアです。1〜50 個のタグをタグセットに含めることができます。
キー

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

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

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

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

関連トピック