翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # MemoryDB リソースのタグ付け クラスターと他の MemoryDB リソースを管理しやすくするために、タグ形式で各リソースに独自のメタデータを割り当てることができます。タグを使用すると、例えば用途別、所有者別、環境別などのさまざまな方法で AWS リソースを分類できます。これは同じタイプのリソースが多数ある場合に役立ちます。割り当てたタグに基づいて、特定のリソースをすばやく識別できます。ここではタグとその作成方法について説明します。 **警告** ベストプラクティスとして、機密データをタグに含めないようお勧めします。 ## タグの基本 タグとはAWS リソースに割り当てるラベルです。タグはそれぞれ、1 つのキーとオプションの 1 つの値で設定されており、どちらもお客様側が定義します。タグを使用すると、AWS リソースを用途、所有者などのさまざまな方法で分類できます。例えば、各インスタンスの所有者とユーザーグループを追跡しやすくするため、アカウントの MemoryDB クラスターに対して一連のタグを定義できます。 各リソースタイプのニーズを満たす一連のタグキーを考案することをお勧めします。一貫性のある一連のタグキーを使用することで、リソースの管理が容易になります。追加したタグに基づいてリソースを検索およびフィルタリングできます。効果的なリソースのタグ付け戦略を実装する方法の詳細については、「[AWS ホワイトペーパーのタグ付けのベストプラクティス](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf)」を参照してください。 タグには、MemoryDB に関連する意味はなく、完全に文字列として解釈されます。また、タグは自動的にリソースに割り当てられます。タグのキーと値は編集でき、タグはリソースからいつでも削除できます。タグの値は `null` に設定できます。特定のリソースについて既存のタグと同じキーを持つタグを追加した場合、以前の値は新しい値によって上書きされます。リソースを削除すると、リソースのタグも削除されます。 AWS マネジメントコンソール、AWS CLI、および MemoryDB API を使用してタグを操作できます。 IAM を使用している場合は、タグを作成、編集、削除する許可を持つ AWS アカウントのユーザーを制御できます。詳細については、「[リソースレベルのアクセス許可](iam.resourcelevelpermissions.md)」を参照してください。 ## タグを付けることができるリソース アカウントに既に存在するほとんどの MemoryDB リソースにタグ付けできます。以下の表に、タグ付けをサポートするリソースを示します。AWS マネジメントコンソール を使用している場合、リソースにタグを適用するには、[タグエディタ](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) を使用します。一部のリソースの画面では、リソースの作成時にリソースのタグを指定できます。例えば、Name のキーと指定した値をタグ付けします。ほとんどの場合、リソースの作成後すぐに (リソースの作成時ではなく) コンソールによりタグが適用されます。コンソールではリソースを **[名前]** タグに応じて整理できますが、このタグには MemoryDB サービスに対する意味論的意味はありません。 さらに、リソース作成アクションによってはリソースの作成時にリソースのタグを指定できます。リソースの作成時にタグを適用できない場合はリソース作成プロセスがロールバックされます。これにより、リソースがタグ付きで作成されるか、まったく作成されないようになるため、タグ付けされていないリソースが存在することがなくなります。作成時にリソースにタグ付けすることで、リソース作成後にカスタムタグ付けスクリプティングを実行する必要がなくなります。 Amazon MemoryDB API、AWS CLI、または AWS SDK を使用している場合は、関連する MemoryDB API アクションの `Tags` パラメータを使用して、タグを適用できます。具体的には次の 2 つです。 + `CreateCluster` + `CopySnapshot` + `CreateParameterGroup` + `CreateSubnetGroup` + `CreateSnapshot` + `CreateACL` + `CreateUser` + `CreateMultiRegionCluster` 次の表では、タグ付け可能な‭ MemoryDB リソースと、MemoryDB API、AWS CLI、または ‭AWS‬‬ SDK ‬を使用して作成時にタグ付け可能なリソースについて説明します。 **MemoryDB リソースのタグ付けのサポート** | リソース | タグをサポート | 作成時のタグ付けをサポート | | --- | --- | --- | | parametergroup | はい | はい | | subnetgroup | はい | はい | | クラスター | はい | はい | | スナップショット | はい | はい | | ユーザー | はい | はい | | acl | はい | はい | | multiregioncluster | はい | はい | 作成時のタグ付けをサポートする MemoryDB API アクションに、IAM ポリシーのタグベースでリソースレベルの許可を適用し、作成時のリソースタグ付けができるユーザーとグループを細かくコントロールできます。リソースは、作成時から適切に保護されます。タグはリソースに即座に適用されます。したがって、リソースの使用を制御するタグベースのリソースレベルの許可は、ただちに有効になります。リソースはより正確に追跡および報告されます。新しいリソースにタグ付けの使用を適用し、リソースで設定されるタグキーと値をコントロールできます。 詳細については、「[リソースのタグ付けの例](#tagging-your-resources-example)」を参照してください。 請求用のリソースへのタグ付けの詳細については、「[コスト配分タグによるコストのモニタリング](tagging.md)」を参照してください。 ## クラスターとスナップショット、およびマルチリージョンクラスターのタグ付け リクエストオペレーションの一部としてタグ付けには、次のルールが適用されます。 + **CreateCluste**: + `--cluster-name` が供給された場合: リクエストにタグが含まれている場合、クラスターにはタグ付けされます。 + `--snapshot-name` が供給された場合: タグがリクエストに含まれている場合、クラスターはそれらのタグのみでタグ付けされます。タグがリクエストに含まれていない場合、スナップショットタグはクラスターに追加されます。 + **CreateSnapshot**: + `--cluster-name` が供給された場合: タグがリクエストに含まれている場合、リクエストタグのみがスナップショットに追加されます。タグがリクエストに含まれていない場合、クラスタータグがスナップショットに追加されます。 + 自動スナップショットでは: タグは、クラスタータグから伝播されます。 + **CopySnapshot**: タグがリクエストに含まれている場合、リクエストタグのみがスナップショットに追加されます。タグがリクエストに含まれていない場合、コピー元のスナップショットタグがコピーされたスナップショットに追加されます。 + **TagResource**、**UntagResource** : タグはリソースに追加されたり、リソースから削除されたりします。 ## マルチリージョンクラスターのタグ付け MemoryDB マルチリージョンクラスターはグローバルリソースです。そのため、MemoryDB マルチリージョンがサポートされている任意のリージョンで関連する API を呼び出すことで、マルチリージョンクラスターでタグを指定、変更、または一覧表示できます。リージョンサポートの詳細については、「[前提条件と制限事項](multi-region.prereq.md)」を参照してください。 マルチリージョンクラスターのタグは、リージョンクラスターのタグから独立しています。マルチリージョンクラスターには、リージョンクラスターのタグを含むさまざまなタグセットを指定できます。これらのタグ間に階層的なつながりはなく、これらのリソースタイプ間の階層を通じてコピーされません。 `TagResource` および `UntagResource` API を使用してタグを追加または削除した場合、ListTags API のレスポンスに最新の有効なタグがすぐに表示されない可能性があります。これは、特にマルチリージョンクラスターの場合に、タグの整合性が最終的に確保されるためです。 ## タグの制限 タグには以下のような基本制限があります。 + リソースあたりのタグの最大数 - 50 件 + タグキーはリソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。 + キーの最大長 – 128 Unicode 文字 (UTF-8) + 値の最大長 - 256 Unicode 文字 (UTF-8)。 + MemoryDB ではタグ内に任意の文字を使用できますが、他のサービスでは制限がある場合があります。すべてのサービスで使用できる文字は、UTF-8 で表現できる文字、数字、およびスペースに加えて、 \$1 - = . \$1 : / @ です。 + タグのキーと値は大文字と小文字が区別されます。 + `aws:` プレフィックスは AWS 用に限定されています。タグにこのプレフィックスが付いたタグキーがある場合、タグのキーまたは値を編集、削除することはできません。`aws:` プレフィックスを持つタグはリソースあたりのタグ数の制限時には計算されません。 タグのみに基づいてリソースを終了、停止、終了することはできません。リソース識別子を指定する必要があります。例えば、`DeleteMe` というタグキーを使用してタグ付けしたスナップショットを削除するには`DeleteSnapshot` のようなスナップショットのリソース識別子を指定して `snap-1234567890abcdef0` アクションを使用する必要があります。 タグ付けできる MemoryDB リソースの詳細については、「[タグを付けることができるリソース](#tagging-your-resources)」を参照してください。 ## リソースのタグ付けの例 + 新しいクラスターにタグを追加する。 ``` aws memorydb tag-resource \ --resource-arn arn:aws:memorydb:us-east-1:111111222233:cluster/my-cluster \ --tags Key="project",Value="XYZ" Key="memorydb",Value="Service" ``` + タグを使用したクラスターの作成。 ``` aws memorydb create-cluster \ --cluster-name testing-tags \ --description cluster-test \ --subnet-group-name test \ --node-type db.r6g.large \ --acl-name open-access \ --tags Key="project",Value="XYZ" Key="memorydb",Value="Service" ``` + タグ付きのスナップショットを作成します。 この場合、リクエストでタグを追加すると、クラスターにタグが含まれている場合でも、スナップショットはリクエストタグのみを受け取ります。 ``` aws memorydb create-snapshot \ --cluster-name testing-tags \ --snapshot-name bkp-testing-tags-mycluster \ --tags Key="work",Value="foo" ``` # コスト配分タグによるコストのモニタリング MemoryDB でリソースにコスト配分タグを追加する場合、リソースのタグ値に基づいて請求書の費用をグループ化してコストを追跡できます。 MemoryDB コスト配分タグは、MemoryDB リソースを定義してそのリソースに関連付けるキーと値のペアです。キーと値は大文字と小文字が区別されます。タグキーを使用してカテゴリを定義し、タグ値をそのカテゴリの項目にすることができます。例えば、「`CostCenter`」というタグキーと「`10010`」というタグ値を定義して、リソースがコストセンター 10010 に割り当てられていることを示すことができます。また、`Environment` などのキーと、`test` や `production` などの値を使用して、リソースがテスト用なのか本稼働用なのかを示すこともできます。リソースに関連付けられているコストの追跡が簡単になるように、一貫した一連のタグキーを使用することをお勧めします。 コスト配分タグを使用して AWS の請求書を分類し、自分のコスト構造を反映させます。そのためには、サインアップして、タグキー値が含まれた AWS アカウントの請求書を取得する必要があります。次に、結合したリソースのコストを見るには、同じタグキー値のリソースに従って請求書情報を整理します。例えば、複数のリソースに特定のアプリケーション名のタグを付け、請求情報を整理することで、複数のサービスを利用しているアプリケーションの合計コストを確認することができます。 タグを組み合わせてさらに細かくコストを追跡することもできます。例えば、リージョンごとのサービスのコストを追跡するために、`Service` と `Region` というタグキーを使用できます。1 つのリソースでは値を `MemoryDB` と `Asia Pacific (Singapore)` にし、別のリソースでは値を `MemoryDB` と `Europe (Frankfurt)` にします。これによって、MemoryDB の合計コストをリージョンごとに表示できます。詳細については、[「AWS Billing ユーザーガイド」](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)の*「コスト配分タグの使用」*(Use Cost Allocation Tags) を参照してください。 Memcached クラスターに MemoryDB コスト配分タグを追加できます。タグの追加やリスト、変更、削除を行った場合、そのオペレーションは、指定したクラスターにのみ適用されます。 **MemoryDB コスト配分タグの特徴** + コスト配分タグは、ARN として CLI および API オペレーションで指定された MemoryDB リソースに適用されます。resource-type は "cluster" です。 ARN 形式: `arn:aws:memorydb:::/` サンプル ARN: `arn:aws:memorydb:us-east-1:1234567890:cluster/my-cluster` + タグキーは、必須のタグ名です。キーの文字列値は、長さが 1～128 文字の Unicode 文字です。`aws:` をプレフィックスとして使用することはできません。文字列には、一連の Unicode 文字、数字、空白、下線 ( \$1 )、ピリオド ( . )、コロン ( : )、バックスラッシュ ( \$1 )、等号 ( = )、プラス記号 ( \$1 )、ハイフン ( - )、またはアットマーク ( @ ) を含めることができます。 + タグ値は、オプションのタグの値です。値の文字列値は、長さが 1～256 文字の Unicode 文字です。`aws:` をプレフィックスとして使用することはできません。文字列には、一連の Unicode 文字、数字、空白、下線 ( \$1 )、ピリオド ( . )、コロン ( : )、バックスラッシュ ( \$1 )、等号 ( = )、プラス記号 ( \$1 )、ハイフン ( - )、またはアットマーク ( @ ) を含めることができます。 + MemoryDB リソースには、最大 50 個のタグを設定できます。 + 値はタグセット内で一意である必要はありません。例えば、タグセット内に `Service` と `Application` というキーがあり、両方の値として `MemoryDB` を指定できます。 AWS はタグに意味論的意味を適用しません。タグは厳密に文字列として解釈されます。‭AWS‬ は MemoryDB リソースにタグを自動的に設定しません。 # AWS CLI を使用したコスト配分タグの管理 AWS CLI を使用して、コスト配分タグを追加、変更、または削除できます。 サンプル arn: `arn:aws:memorydb:us-east-1:1234567890:cluster/my-cluster` **Topics** + [AWS CLI を使用したタグの一覧表示](#tagging.managing.cli.List) + [AWS CLI を使用したタグの追加](#tagging.managing.cli.Add) + [AWS CLI を使用したタグの変更](#tagging.managing.cli.modify) + [AWS CLI を使用したタグの削除](#tagging.managing.cli.Remove) ## AWS CLI を使用したタグの一覧表示 [‬list-tags‭](https://docs.aws.amazon.com/cli/latest/reference/memorydb/list-tags.html) ‬オペレーションを‬使用すると、AWS CLI を使用して既存のMemoryDB リソースのタグを一覧表示できます。 次のコードは、AWS CLI を使用して、us-east-1 リージョンの MemoryDB クラスター `my-cluster` のタグをリスト表示します。 Linux、macOS、Unix の場合: ``` aws memorydb list-tags \ --resource-arn arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster ``` Windows の場合: ``` aws memorydb list-tags ^ --resource-arn arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster ``` このオペレーションの出力は、リソースのすべてのタグを示した次のリストのようになります。 ``` { "TagList": [ { "Value": "10110", "Key": "CostCenter" }, { "Value": "EC2", "Key": "Service" } ] } ``` リソースにタグが見つからない場合は、空の TagList が出力されます。 ``` { "TagList": [] } ``` 詳細については、MemoryDB の AWS CLI の [list-tags](https://docs.aws.amazon.com/cli/latest/reference/memorydb/list-tags.html) を参照してください。 ## AWS CLI を使用したタグの追加 [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/memorydb/tag-resource.html) CLI オペレーションを行い、AWS CLI を使用して、既存の MemoryDB リソースにタグを追加できます。タグキーがリソースに存在しない場合は、キーと値がリソースに追加されます。キーが既にリソースに存在する場合、キーに関連付けられた値は新しい値に更新されます。 次のコードは、‭AWS CLI を使用して、それぞれ `memorydb` と `us-east-1` の値を持つキー `Service` と ‬`Region` をus-east-1 リージョン内のクラスター‭ `my-cluster` に追加します。‬‬‬‬‬‬‬ Linux、macOS、Unix の場合: ``` aws memorydb tag-resource \ --resource-arn arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster \ --tags Key=Service,Value=memorydb \ Key=Region,Value=us-east-1 ``` Windows の場合: ``` aws memorydb tag-resource ^ --resource-arn arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster ^ --tags Key=Service,Value=memorydb ^ Key=Region,Value=us-east-1 ``` このオペレーションの出力は、次のオペレーションのリソースのすべてのタグを示した以下のリストのようになります。 ``` { "TagList": [ { "Value": "memorydb", "Key": "Service" }, { "Value": "us-east-1", "Key": "Region" } ] } ``` 詳細については、「MemoryDB [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/memorydb/tag-resource.html) の AWS CLI」を参照してください。 オペレーション [‬create-cluster‭](https://docs.aws.amazon.com/cli/latest/reference/memorydb/create-cluster.html)‬ ‬を使用して新しいクラスターを作成するときに、AWS CLI‬ を使用してクラスターにタグを追加することもできます。‬‬‬ ## AWS CLI を使用したタグの変更 AWS CLI‬ を使用して、MemoryDB クラスターのタグを変更できます。 タグを変更するには: + [‬tag-resource‭](https://docs.aws.amazon.com/cli/latest/reference/memorydb/tag-resource.html) ‬を使用して、新しいタグ‬と値を追加するか、既存のタグに関連付けられている値を変更します。 + 指定したタグをリソースから削除するには、‭[‬untag-resource](https://docs.aws.amazon.com/cli/latest/reference/memorydb/untag-resource.html)‬ を使用します。 どちらのオペレーションでも、指定のクラスターのタグとその値を示すリストが出力されます。 ## AWS CLI を使用したタグの削除 AWS CLI を使用すると、[‬untag-resource‭](https://docs.aws.amazon.com/cli/latest/reference/memorydb/untag-resource.html)‬ ‬オペレーションを‬使用して MemoryDB クラスターからタグを削除できます。 次のコードは、‭AWS CLI‬ を使用して、us-east-1 リージョンのクラスター `my-cluster` からキー `Service` と `Region` を含むタグを削除します。 Linux、macOS、Unix の場合: ``` aws memorydb untag-resource \ --resource-arn arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster \ --tag-keys Region Service ``` Windows の場合: ``` aws memorydb untag-resource ^ --resource-arn arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster ^ --tag-keys Region Service ``` このオペレーションの出力は、次のオペレーションのリソースのすべてのタグを示した以下のリストのようになります。 ``` { "TagList": [] } ``` 詳細については、MemoryDB の AWS CLI の [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/memorydb/untag-resource.html) を参照してください。 # MemoryDB API を使用したコスト配分タグの管理 MemoryDB API を使用して、コスト配分タグを追加、変更、または削除できます。 コスト配分タグは、MemoryDB 用 クラスターに適用されます。タグ付けされるクラスターは、ARN (Amazon リソースネーム) を使用して指定されます。 サンプル arn: `arn:aws:memorydb:us-east-1:1234567890:cluster/my-cluster` **Topics** + [MemoryDB API を使用したタグの一覧表示](#tagging.managing.api.List) + [MemoryDB API を使用したタグの追加](#tagging.managing.api.Add) + [MemoryDB API を使用したタグの変更](#tagging.managing.api.modify) + [MemoryDB API を使用したタグの削除](#tagging.managing.api.Remove) ## MemoryDB API を使用したタグの一覧表示 [‬ListTags‭](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_ListTags.html)‬ ‬オペレーションを使用すると‬、MemoryDB API を使用して既存のリソースのタグを一覧表示できます。 次のコードは、MemoryDB API を使用して、us-east-1 リージョンのリソース `my-cluster` のタグをリスト表示します。 ``` https://memory-db.us-east-1.amazonaws.com/ ?Action=ListTags &ResourceArn=arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Version=2021-01-01 &Timestamp=20210802T192317Z &X-Amz-Credential= ``` ## MemoryDB API を使用したタグの追加 [‬TagResource‭](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_TagResource.html)‬ ‬オペレーションを‬使用すると、MemoryDB API を使用して、既存の MemoryDB クラスターにタグを追加できます。タグキーがリソースに存在しない場合は、キーと値がリソースに追加されます。キーが既にリソースに存在する場合、キーに関連付けられた値は新しい値に更新されます。 次のコードは、MemoryDB ‭API を使用して、us-east-1 リージョンのリソース `my-cluster`‬ に、それぞれ値 `memorydb` と `us-east-1` を持つキー `Service` と `Region` を追加します。‭ ``` https://memory-db.us-east-1.amazonaws.com/ ?Action=TagResource &ResourceArn=arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Tags.member.1.Key=Service &Tags.member.1.Value=memorydb &Tags.member.2.Key=Region &Tags.member.2.Value=us-east-1 &Version=2021-01-01 &Timestamp=20210802T192317Z &X-Amz-Credential= ``` 詳細については、「[TagResource](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_TagResource.html)」を参照してください。 ## MemoryDB API を使用したタグの変更 MemoryDB API を使用して、MemoryDB クラスターのタグを変更できます。 タグの値を変更するには: + [TagResource](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_TagResource.html) オペレーションを使用して新しいタグと値を追加するか、既存のタグの値を変更します。 + リソースからタグを削除するには、‭[ UntagResource‭](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_UntagResource.html) を使用します。‬‬‬‬‬‬ どちらのオペレーションでも、指定のリソースのタグとその値を示すリストが出力されます。 ## MemoryDB API を使用したタグの削除 MemoryDB API を使用すると、[‬UntagResource‭](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_UntagResource.html) オペレーションを使用して既存の MemoryDB ‬‬クラスターからタグを削除できます。 次のコードは、‭MemoryDB‬ API を使用して、リージョン us-east-1 のクラスター `my-cluster` からキー ‭`Service` と ‬‭`Region` を持つタグを削除します。 ``` https://memory-db.us-east-1.amazonaws.com/ ?Action=UntagResource &ResourceArn=arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster &SignatureVersion=4 &SignatureMethod=HmacSHA256 &TagKeys.member.1=Service &TagKeys.member.2=Region &Version=2021-01-01 &Timestamp=20210802T192317Z &X-Amz-Credential= ```