Amazon Aurora Global Database リソースのタグ付け

Aurora Global Database 機能を使用すると、グローバルデータベース内のさまざまなレベルでリソースに RDS タグを適用できます。AWS リソースまたは Aurora リソースでタグを使用する方法を確認したい場合は、グローバルデータベース内でタグを適用する前に「Amazon Aurora および Amazon RDS リソースのタグ付け」を参照してください。

タグは、グローバルデータベース内の以下の種類のリソースにタグを適用できます。

グローバルデータベース内で割り当てることができるタグの種類の例をいくつか示します。

グローバルデータベースのタグ付けに関する AWS CLI の例

以下の AWS CLI の例は、グローバルデータベース内のすべてのタイプの Aurora リソースのタグを指定して調べる方法を示しています。

create-global-cluster コマンドを使用して、グローバルクラスターコンテナのタグを指定できます。次の例では、グローバルクラスターを作成し、2 つのタグを割り当てます。タグには tag1 キーと tag2 キーがあります。

$  aws rds create-global-cluster --global-cluster-identifier my_global_cluster_id \
  --engine aurora-mysql --tags Key=tag1,Value=val1 Key=tag2,Value=val2

describe-global-clusters コマンドを使用して、グローバルクラスターコンテナのタグを一覧表示できます。タグを使用する場合は、通常、このコマンドを最初に実行して、グローバルクラスターの Amazon リソースネーム (ARN) を取得します。タグを使用するための後続のコマンドでは、ARN をパラメータとして使用します。次のコマンドは、TagList 属性のタグ情報を表示します。また、後の例でパラメータとして使用する ARN も表示します。

$  aws rds describe-global-clusters --global-cluster-identifier my_global_cluster_id
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            "GlobalClusterArn": "my_global_cluster_arn",
            ...
            "TagList": [
                {
                    "Value": "val1",
                    "Key": "tag1"
                },
                {
                    "Value": "val2",
                    "Key": "tag2"
                }
            ]
        }
    ]
}

add-tags-to-resource コマンドを使用して新しいタグを追加できます。このコマンドでは、識別子の代わりにグローバルクラスターの Amazon リソースネーム (ARN) を指定します。既存のタグと同じ名前で新しいタグを追加すると、既存のタグ値は上書きされます。タグ値にスペースまたは特殊文字を含める場合は、オペレーティングシステムまたはコマンドシェルに応じた引用符で値を囲みます。次の例では、前の例に示したグローバルクラスターのタグを変更します。最初、クラスターには tag1 キーと tag2 キーを含むタグがありました。コマンドが完了すると、グローバルクラスターには tag3 キーが含む新しいタグが追加され、tag1 キーを含むタグには異なる値が含まれます。

$  aws rds add-tags-to-resource --resource-name my_global_cluster_arn \
  --tags Key=tag1,Value="new value for tag1" Key=tag3,Value="entirely new tag"

$  aws rds describe-global-clusters --global-cluster-identifier my_global_cluster_id
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            ...
            "TagList": [
                {
                    "Value": "new value for tag1",
                    "Key": "tag1"
                },
                {
                    "Value": "val2",
                    "Key": "tag2"
                },
                {
                    "Value": "entirely new tag",
                    "Key": "tag3"
                }
            ]
        }
    ]
}

remove-tags-from-resource コマンドを使用して、グローバルクラスターからタグを削除できます。このコマンドでは、タグ値なしで、タグキーのセットのみを指定します。次の例では、前の例に示したグローバルクラスターのタグを変更します。最初、クラスターにはキーとして tag1、tag2、tag3 を含むタグがありました。コマンドが完了すると、tag1 キーを含むタグのみが残ります。

$  aws rds remove-tags-from-resource --resource-name my_global_cluster_arn --tag-keys tag2 tag3

$  aws rds describe-global-clusters --global-cluster-identifier my_global_cluster_id
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            ...
            "TagList": [
                {
                    "Value": "new value for tag1",
                    "Key": "tag1"
                }
            ]
        }
    ]
}