翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 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 ユーザーガイド* の [コスト配分タグを使用する](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) を参照してください。
各 Amazon DocumentDB リソースにはタグセットがあり、それぞれのリソースに割り当てられているすべてのタグが含まれています。タグセットには最大 10 個のタグを含めることができ、空にすることもできます。Amazon DocumentDB リソースに追加したタグのキーがそのリソースの既存のタグのキーと同じ場合、既存の値は新しい値によって上書きされます。
AWS は、タグに意味を適用しません。タグは文字列として厳密に解釈されます。リソース作成時に使用する設定によっては、Amazon DocumentDB によってインスタンスまたは他の Amazon DocumentDB リソースにタグが設定されることがあります。例えば、Amazon DocumentDB によってインスタンスが本稼働用またはテスト用であることを示すタグが追加されることがあります。
スナップショットにタグを追加することはできますが、請求書にはこのグループが反映されません。
AWS マネジメントコンソール または AWS CLI を使用して、Amazon DocumentDB リソースにタグの追加、一覧表示、または削除ができます。AWS CLI を使用するときは、操作するリソースの Amazon リソースネーム (ARN) を指定する必要があります。Amazon DocumentDB ARN の詳細については、[Amazon DocumentDB Amazon リソースネーム (ARN) の理解](documentdb-arns.md) を参照してください。
## タグの制約
Amazon DocumentDB タグには以下の制限があります。
+ リソースあたりのタグの最大数は 10 です
+ **キー**の最大長 - 128 文字 (Unicode)
+ **値**の最大長 - 256 文字 (Unicode)
+ [**キー**] と [**値**] に使用できる文字 - アルファベットの大文字と小文字 (UTF-8 文字セット)、数字、スペース、次の文字です (`_ . : / = + -` および `@`) (Java 正規表現: `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`)。
+ タグのキーと値では、大文字と小文字が区別されます。
+ プレフィックス `aws:` をタグキーや値に使用することはできません。AWS 用に予約されています。
## Amazon DocumentDB リソースでのタグの追加と更新
AWS マネジメントコンソール または AWS CLI を使用して、リソースに最大 10 個のタグを追加できます。
------
#### [ Using the AWS マネジメントコンソール ]
リソースにタグを追加するプロセスは、タグの追加先となるリソースにかかわらず、似ています。この例では、クラスターにタグを追加します。
**コンソールを使用してクラスターにタグを追加または更新するには**
1. AWS マネジメントコンソール にサインインして Amazon DocumentDB コンソール [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) を開きます。
1. ナビゲーションペインで、[**クラスター**] を選択します。
1. タグを追加するクラスターの名前を指定します。
1. [**タグ**] セクションまで下にスクロールし、[**編集**] を選択します。
1. このリソースに追加するタグごとに、以下が必要になります。
1. 新しいタグを追加するには、[**キー**] ボックスにタグの名前を入力します。タグの値を変更するには、[**キー**] 列でタグの名前を見つけます。
1. 新規または更新された値にタグに付けるには、[**値**] ボックスにタグの値を入力します。
1. さらにタグを追加する場合は、[**追加**] を選択します。それ以外の場合は、完了したら、[**保存**] を選択します。
------
#### [ Using the AWS CLI ]
リソースにタグを追加するプロセスは、タグの追加先となるリソースにかかわらず、似ています。この例では、クラスターに 3 つのタグを追加します。2 番目のタグ `key2` には値がありません。
これらのパラメータを指定して、AWS CLI オペレーション `add-tags-to-resource` を使用します。
**パラメータ**
+ **--resource-name** — タグを追加する Amazon DocumentDB リソースの ARN。
+ **--tags** `Key=key-name,Value=tag-value` 形式でこのリソースに追加するタグ (キーと値のペア) のリスト。
**Example**
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 マネジメントコンソール または AWS CLI を使用して、Amazon DocumentDB リソースのタグのリストを取得します。
------
#### [ Using the AWS マネジメントコンソール ]
リソースのタグをリスト表示するプロセスは、タグの追加先となるリソースにかかわらず、似ています。この例では、クラスターのタグをリストします。
**コンソールを使用してクラスター上のタグをリスト表示するには**
1. Amazon DocumentDB コンソールを、次の場所で開きます。[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)
1. ナビゲーションペインで、[**クラスター**] を選択します。
1. タグをリスト表示するクラスターの名前を指定します。
1. このリソースのタグをリスト表示するには、[**タグ**] セクションまで下にスクロールします。
------
#### [ Using the AWS CLI ]
リソースのタグをリスト表示するプロセスは、タグをリスト表示するリソースにかかわらず、似ています。この例では、クラスターのタグをリストします。
これらのパラメータを指定して、AWS CLI オペレーション `list-tags-for-resource` を使用します。
**パラメータ**
+ **--resource-name** — 必須 タグを追加する Amazon DocumentDB リソースの ARN。
**Example**
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 マネジメントコンソール または AWS CLI をクリックして Amazon DocumentDB リソースからタグを削除します。
------
#### [ Using the AWS マネジメントコンソール ]
リソースからタグを削除するプロセスは、タグの追加先となるリソースにかかわらず、似ています。この例では、クラスターからタグを削除します。
**コンソールを使用してクラスターからタグを削除するには**
1. Amazon DocumentDB コンソールを、次の場所で開きます。[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)
1. ナビゲーションペインで、[**クラスター**] を選択します。
1. タグを削除するクラスターの名前を指定します。
1. [**タグ**] セクションまで下にスクロールし、[**編集**] を選択します。
1. このリソースからすべてのタグを削除するには、[**すべて削除**] を選択します。それ以外の場合、このリソースから削除するタグごとに、以下を実行します。
1. [**キー**] 列で、タグの名前を見つけます。
1. タグキーと同じ行で [**削除**] を選択します。
1. 完了したら、**[保存]** を選択します。
------
#### [ Using the AWS CLI ]
リソースからタグを削除するプロセスは、タグの削除元となるリソースにかかわらず、似ています。この例では、クラスターからタグを削除します。
これらのパラメータを指定して、AWS CLI オペレーション `remove-tags-from-resource` を使用します。
+ **--resource-name** — 必須 タグを追加する Amazon DocumentDB リソースの ARN。
+ **--tag-keys** — 必須 このリソースから削除するタグキーのリスト。
**Example**
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` オペレーションを使用します。
------