Aurora DSQL でのリソースのタグ付け
AWS では、タグはユーザー定義のキーと値のペアであり、クラスターや CDC ストリームなどの Aurora DSQL リソースを定義して関連付けます。タグはオプションです。キーを指定する場合、値はオプションです。
AWS マネジメントコンソール、AWS CLI、または AWS SDK を使用して、Aurora DSQL クラスターおよび CDC ストリームのタグを追加、一覧表示、削除できます。AWS コンソールを使用して、リソースの作成中および作成後にタグを追加できます。AWS CLI を使用して作成後にリソースにタグを付けるには、TagResource オペレーションを使用します。
名前でクラスターにタグ付けする
Aurora DSQL は、Amazon リソースネーム (ARN) としてグローバルに一意の識別子が割り当てられたクラスターを作成します。クラスターにわかりやすい名前を割り当てる場合は、タグを使用することをお勧めします。
Aurora DSQL コンソールでコンソールを作成すると、Aurora DSQL は自動的にタグを作成します。このタグには、Name というキーと、クラスターの名前を表す自動生成された値があります。この値は設定可能であるため、クラスターにわかりやすい名前を割り当てることができます。クラスターに関連付けられた値を持つ Name タグがある場合は、Aurora DSQL コンソール全体で値を確認できます。
タグ付け要件
タグには、次の要件があります。
-
キーにプレフィックス
aws:を付けることはできません。 -
キーはタグセットごとに一意であることが必要です。
-
キーに使用できる文字数は 1～128 文字です。
-
値に使用できる文字数は 0～256 文字です。
-
値は、タグセットごとに一意にする必要はありません。
-
キーと値に使用できる文字は、数字、空白、および _ . : / = + - @ の記号です。
-
キーと値は大文字と小文字が区別されます。
CDC ストリームのタグ付け
CDC ストリームは個別にタグ付け可能なリソースです。ストリームの作成時に、CreateStream に --tags パラメータを渡すことでタグを追加でき、既存のストリームに対して、ストリーム ARN を指定して ListTagsForResource、TagResource、UntagResource を使用することで、タグの読み取り、追加、削除を行うことができます。CDC ストリームのタグは、親クラスターのタグや、送信先の Amazon Kinesis データストリームのタグとは別のものです。
CDC ストリーム ARN の形式は arn:aws:dsql: です。CDC ストリームの詳細については、「変更データキャプチャ (CDC) ストリーム」を参照してください。region:account-id:cluster/cluster-id/stream/stream-id
タグ付けの使用に関する注意事項
Aurora DSQL でタグを使用する場合は、次の点を考慮してください。
-
AWS CLI または Aurora DSQL API オペレーションを使用するときは、操作する Aurora DSQL リソースの Amazon リソースネーム (ARN) を指定する必要があります。詳細については、「Amazon Resource Name (ARNs) format for Aurora DSQL resources」を参照してください。
-
各リソースには、リソースに割り当てられた 1 つ以上のタグの集合であるタグセットが 1 つあります。
-
リソースごとに、タグセットあたり最大 50 個のタグを含めることができます。
-
リソースを削除した場合、関連付けられたタグが削除されます。
-
リソースの作成時にタグを追加できます。また、
TagResource、UntagResourceおよびListTagsForResourceの API オペレーションを使用してタグを表示および変更できます。 -
IAM ポリシーでタグを使用できます。これらを使用して、Aurora DSQL クラスターへのアクセスを管理したり、それらのリソースに適用できるアクションを制御したりできます。詳細については、「タグを使用した AWS リソースへのアクセスの制御」を参照してください。
-
タグは、AWS 全体で他のさまざまなアクティビティに使用できます。詳細については、「一般的なタグ付け戦略」を参照してください。
