リソースタグの概要タグの制約タグの追加または更新するにはタグを一覧表にするタグの削除

Amazon DocumentDB リソースへのタグ付け

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

次の Amazon DocumentDB リソースにタグ付けができます。

クラスター
インスタンス
スナップショット
クラスタースナップショット
パラメータグループ
クラスターパラメータグループ
セキュリティグループ
[サブネットグループ]

Amazon DocumentDB リソースタグの概要

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

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

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

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

スナップショットにタグを追加することはできますが、請求書にはこのグループが反映されません。

AWS Management Console またはを使用して、Amazon DocumentDB リソースのタグ AWS CLI を追加、一覧表示、削除できます。を使用する場合は AWS CLI、使用するリソースの Amazon リソースネーム (ARN) を指定する必要があります。Amazon DocumentDB ARN の詳細については、Amazon DocumentDB Amazon リソースネーム (ARN) の理解を参照してください。

タグの制約

Amazon DocumentDB タグには以下の制限があります。

リソースあたりのタグの最大数は 10 です
キーの最大長 - 128 文字 (Unicode)
値の最大長 - 256 文字 (Unicode)
[キー] と [値] に使用できる文字 - アルファベットの大文字と小文字 (UTF-8 文字セット)、数字、スペース、次の文字です (_ . : / = + - および @) (Java 正規表現: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$")。
タグのキーと値では、大文字と小文字が区別されます。
プレフィックス aws: をタグキーや値に使用することはできません。 AWS用に予約されています。

Amazon DocumentDB リソースでのタグの追加と更新

AWS Management Console またはを使用して、リソースに最大 10 個のタグを追加できます AWS CLI。

Using the AWS Management Console

リソースにタグを追加するプロセスは、タグの追加先となるリソースにかかわらず、似ています。この例では、クラスターにタグを追加します。

コンソールを使用してクラスターにタグを追加または更新するには

にサインインし AWS Management Console、https://console.aws.amazon.com/docdb で Amazon DocumentDB コンソールを開きます。
ナビゲーションペインで、[クラスター] を選択します。
タグを追加するクラスターの名前を指定します。
[タグ] セクションまで下にスクロールし、[編集] を選択します。
このリソースに追加するタグごとに、以下が必要になります。
1. 新しいタグを追加するには、[キー] ボックスにタグの名前を入力します。タグの値を変更するには、[キー] 列でタグの名前を見つけます。
2. 新規または更新された値にタグに付けるには、[値] ボックスにタグの値を入力します。
3. さらにタグを追加する場合は、[追加] を選択します。それ以外の場合は、完了したら、[保存] を選択します。

Using the AWS CLI

リソースにタグを追加するプロセスは、タグの追加先となるリソースにかかわらず、似ています。この例では、クラスターに 3 つのタグを追加します。2 番目のタグ key2 には値がありません。

これらのパラメータadd-tags-to-resourceで AWS CLI オペレーションを使用します。

パラメータ

--resource-name — タグを追加する Amazon DocumentDB リソースの ARN。
--tags Key=key-name,Value=tag-value 形式でこのリソースに追加するタグ (キーと値のペア) のリスト。

Linux、macOS、Unix の場合:


aws docdb add-tags-to-resource \
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3

Windows の場合:


aws docdb add-tags-to-resource ^
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3

add-tags-to-resource オペレーションでは何も出力されません。オペレーションの結果を表示するには、list-tags-for-resource オペレーションを使用します。

Amazon DocumentDB リソースでのタグのリスト表示

AWS Management Console またはを使用して AWS CLI 、Amazon DocumentDB リソースのタグのリストを取得できます。

Using the AWS Management Console

リソースのタグをリスト表示するプロセスは、タグの追加先となるリソースにかかわらず、似ています。この例では、クラスターのタグをリストします。

コンソールを使用してクラスター上のタグをリスト表示するには

Amazon DocumentDB コンソールを、次の場所で開きます。https://console.aws.amazon.com/docdb
ナビゲーションペインで、[クラスター] を選択します。
タグをリスト表示するクラスターの名前を指定します。
このリソースのタグをリスト表示するには、[タグ] セクションまで下にスクロールします。

Using the AWS CLI

リソースのタグをリスト表示するプロセスは、タグをリスト表示するリソースにかかわらず、似ています。この例では、クラスターのタグをリストします。

これらのパラメータlist-tags-for-resourceで AWS CLI オペレーションを使用します。

パラメータ

--resource-name — 必須タグを追加する Amazon DocumentDB リソースの ARN。

Linux、macOS、Unix の場合:


aws docdb list-tags-for-resource \
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster

Windows の場合:


aws docdb list-tags-for-resource ^
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster

このオペレーションによる出力は、次のようになります（JSON 形式）。


{
    "TagList": [
        {
            "Key": "key1",
            "Value": "value1"
        },
        {
            "Key": "key2",
            "Value": ""
        },
        {
            "Key": "key3",
            "Value": "value3"
        }
    ]
}

Amazon DocumentDB リソースからのタグの削除

AWS Management Console またはを使用して AWS CLI 、Amazon DocumentDB リソースからタグを削除できます。

Using the AWS Management Console

リソースからタグを削除するプロセスは、タグの追加先となるリソースにかかわらず、似ています。この例では、クラスターからタグを削除します。

コンソールを使用してクラスターからタグを削除するには

Amazon DocumentDB コンソールを、次の場所で開きます。https://console.aws.amazon.com/docdb
ナビゲーションペインで、[クラスター] を選択します。
タグを削除するクラスターの名前を指定します。
[タグ] セクションまで下にスクロールし、[編集] を選択します。
このリソースからすべてのタグを削除するには、[すべて削除] を選択します。それ以外の場合、このリソースから削除するタグごとに、以下を実行します。
1. [キー] 列で、タグの名前を見つけます。
2. タグキーと同じ行で [削除] を選択します。
3. 完了したら、[保存] を選択します。

Using the AWS CLI

リソースからタグを削除するプロセスは、タグの削除元となるリソースにかかわらず、似ています。この例では、クラスターからタグを削除します。

これらのパラメータremove-tags-from-resourceで AWS CLI オペレーションを使用します。

--resource-name — 必須タグを追加する Amazon DocumentDB リソースの ARN。
--tag-keys — 必須このリソースから削除するタグキーのリスト。

Linux、macOS、Unix の場合:


aws docdb remove-tags-from-resource \
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tag-keys key1 key3

Windows の場合:


aws docdb remove-tags-from-resource ^
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tag-keys key1 key3

removed-tags-from-resource オペレーションでは何も出力されません。オペレーションの結果を表示するには、list-tags-for-resource オペレーションを使用します。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

Amazon DocumentDB ARN の理解

Amazon DocumentDB のメンテナンス