# 在 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 资源名称（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 资源名称（ARN）。有关更多信息，请参阅[适用于 Aurora DSQL 资源的 Amazon 资源名称（ARN）格式](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/authentication-authorization.html#authentication-authorization-arn-format)。
+ 每个资源都有一个标签集，它是分配给该资源的一个或多个标签的集合。
+ 每个资源的每个标签集内最多有 50 个标签。
+ 如果删除资源，则会删除所有关联的标签。
+ 您可以在创建资源时添加标签，也可以使用以下 API 操作来查看和修改标签：`TagResource`、`UntagResource` 和 `ListTagsForResource`。
+ 可以将标签与 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)。