# Aurora DSQL でのリソースのタグ付け
AWS では、タグはユーザー定義のキーと値のペアであり、クラスターなどの Aurora DSQL リソースを定義して関連付けます。タグはオプションです。キーを指定する場合、値はオプションです。
AWS マネジメントコンソール、AWS CLI、または AWS SDK を使用して、Aurora DSQL クラスターのタグを追加、一覧表示、削除できます。AWS コンソールを使用して、クラスターの作成中および作成後にタグを追加できます。AWS CLI を使用して作成後にクラスターにタグを付けるには、`TagResource` オペレーションを使用します。
## 名前でクラスターにタグ付けする
Aurora DSQL は、Amazon リソースネーム (ARN) としてグローバルに一意の識別子が割り当てられたクラスターを作成します。クラスターにわかりやすい名前を割り当てる場合は、タグを使用することをお勧めします。
Aurora DSQL コンソールでコンソールを作成すると、Aurora DSQL は自動的にタグを作成します。このタグには、**Name** というキーと、クラスターの名前を表す自動生成された値があります。この値は設定可能であるため、クラスターにわかりやすい名前を割り当てることができます。クラスターに関連付けられた値を持つ Name タグがある場合は、Aurora DSQL コンソール全体で値を確認できます。
## タグ付け要件
タグには、次の要件があります。
+ キーにプレフィックス `aws:` を付けることはできません。
+ キーはタグセットごとに一意であることが必要です。
+ キーに使用できる文字数は 1～128 文字です。
+ 値に使用できる文字数は 0～256 文字です。
+ 値は、タグセットごとに一意にする必要はありません。
+ キーと値に使用できる文字は、数字、空白、および \$1 . : / = \$1 - @ の記号です。
+ キーと値は大文字と小文字が区別されます。
## タグ付けの使用に関する注意事項
Aurora DSQL でタグを使用する場合は、次の点を考慮してください。
+ AWS CLI または Aurora DSQL API オペレーションを使用するときは、操作する Aurora DSQL リソースの Amazon リソースネーム (ARN) を指定する必要があります。詳細については、「[Amazon Resource Name (ARNs) format for Aurora DSQL resources](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/authentication-authorization.html#authentication-authorization-arn-format)」を参照してください。
+ 各リソースには、リソースに割り当てられた 1 つ以上のタグの集合である*タグセット*が 1 つあります。
+ リソースごとに、タグセットあたり最大 50 個のタグを含めることができます。
+ リソースを削除した場合、関連付けられたタグが削除されます。
+ リソースの作成時にタグを追加できます。また、`TagResource`、`UntagResource` および `ListTagsForResource` の API オペレーションを使用してタグを表示および変更できます。
+ IAM ポリシーでタグを使用できます。これらを使用して、Aurora DSQL クラスターへのアクセスを管理したり、それらのリソースに適用できるアクションを制御したりできます。詳細については、「[タグを使用した AWS リソースへのアクセスの制御](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)」を参照してください。
+ タグは、AWS 全体で他のさまざまなアクティビティに使用できます。詳細については、「[一般的なタグ付け戦略](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html#tag-strategies)」を参照してください。