

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Aurora DSQL 中標記資源
<a name="CHAP_tagging"></a>

在 AWS 中，標籤是您定義並與 Aurora DSQL 資源 (例如叢集) 建立關聯的使用者定義鍵值對。標籤是選擇性的。若提供索引鍵，對應值為選用項。

您可以使用 AWS 管理主控台、AWS CLI 或 AWS SDK 來新增、列出及刪除 Aurora DSQL 叢集上的標籤。您可以使用 AWS 主控台在建立叢集期間或之後新增標籤。若要在建立叢集後標記叢集，請使用 AWS CLI 的 `TagResource` 操作。

## 使用名稱標籤標記叢集
<a name="SECTION_tagging-name"></a>

Aurora DSQL 建立叢集時，會自動分配全域唯一識別符作為 Amazon Resource Name (ARN)。若想為叢集指派易於辨識的名稱，建議使用標籤。

若使用 Aurora DSQL 主控台建立叢集，Aurora DSQL 會自動建立標籤。該標籤索引鍵為**名稱**，自動生成的值代表叢集名稱。該值可設定，因此可為叢集指派更易辨識的名稱。若叢集具有名稱標籤及其關聯值，可在 Aurora DSQL 主控台中查看該值。

## 標記需求
<a name="SECTION_tagging-requirements"></a>

標籤均擁有以下要求：
+ 索引鍵字首不能是 `aws:`。
+ 索引鍵在標籤集內必須是唯一的。
+ 索引鍵必須介於 1 到 128 個允許的字元之間。
+ 值必須介於 0 到 256 個允許的字元之間。
+ 值在每個標籤集中不需要是唯一的。
+ 索引鍵和值允許使用字母、數字、空格及下列符號：\_ . : / = \+ - @。
+ 金鑰和值會區分大小寫。

## 標籤使用注意事項
<a name="SECTION_tagging-usage-notes"></a>

使用 Aurora DSQL 標籤時，請注意以下事項。
+ 使用 AWS CLI 或 Aurora DSQL API 操作時，請務必提供 Aurora DSQL 資源的 Amazon Resource Name (ARN)。如需更多資訊，請參閱 [Aurora DSQL 資源的 Amazon Resource Name (ARNs) 格式](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/authentication-authorization.html#authentication-authorization-arn-format)。
+ 每個資源皆有一個標籤集，此為指派給該資源之一或多個標籤的集合。
+ 每個資源每個標籤集最多可擁有 50 個標籤。
+ 如果您刪除資源，任何關聯的標籤也會遭到刪除。
+ 可在建立資源時新增標籤，並可使用以下 API 操作檢視及修改標籤：`TagResource`、`UntagResource` 和 `ListTagsForResource`。
+ 可將標籤用於 IAM 政策。可透過 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)。