本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 AWS Database Migration Service 中标记资源
<a name="CHAP_Tagging"></a>

您可以在 AWS Database Migration Service（AWS DMS）中使用标签向资源添加元数据。此外，这些标签可与 AWS Identity and Access Management（IAM）策略结合使用，以管理对 AWS DMS 资源的访问并控制可将什么操作应用于 AWS DMS 资源。最后，您可以将具有类似标签的资源的费用分组在一起，使用这些标签来跟踪成本。

所有 AWS DMS 资源均可加标签：
+ Certificates
+ 数据提供商
+ 数据迁移
+ 了解如何查看、监控和管理 SageMaker 端点。
+ 事件订阅
+ 实例配置文件
+ 迁移项目
+ 复制实例
+ 复制子网组
+ 复制任务

AWS DMS 标签是由您定义的名称-值对，与某种 AWS DMS 资源关联。此名称也叫密钥。为键提供值为可选操作。您可使用标签向 AWS DMS 资源分配任意信息。标签密钥可用于定义 (例如) 一个类别，而标签值可以是该类别中的一个项目。例如，可定义“project”标签键和“Salix”标签值，表示向 Salix 项目分配了 AWS DMS 资源。您也可使用标签通过 environment=test 或 environment=production 等键指定 AWS DMS 资源用于测试或生产。我们建议使用一组具有一致性的标签键，以便更轻松地跟踪与 AWS DMS 资源关联的元数据。

使用标签来组织 AWS 账单以反映您自身的成本结构。要执行此操作，请注册以获取包含标签键值的 AWS 账户账单。然后，如需查看组合资源的成本，请按有同样标签键值的资源组织您的账单信息。例如，您可以将特定的应用程序名称用作几个资源的标签，然后组织账单信息，以查看在数个服务中的使用该应用程序的总成本。有关更多信息，请参阅 *AWS Billing 用户指南* 中的[使用成本分配标签](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。

每个 AWS DMS 资源都有一组标签，其中包含分配给该 AWS DMS 资源的所有标签。标签集可以包含多达十个标签，也可以为空。如果向 AWS DMS 资源添加一个标签，而该标签的键与资源上某个现有的标签相同，则新值将覆盖旧值。

AWS 不会对您的标记应用任何语义意义；所有标记都会严格地作为字符串进行解析。AWS根据您在创建资源时使用的设置，DMS 可能会在 AWS DMS 资源上设置标签。

下面列表描述了 AWS DMS 标签的特征。
+ 标签键是标签的名称，属于必填内容。该字符串值的长度可以是 1 到 128 个 Unicode 字符，并且不能以“aws:”或“dms:”为前缀。字符串只能包含 Unicode 字母、数字、空格、“\$1”、“.”、“/”、“=”、“\$1”、“-”的集合（Java 正则表达式：`"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`）。
+ 标签值是标签的可选字符串值。该字符串值的长度可以是 1 到 256 个 Unicode 字符，并且不能以“aws:”或“dms:”为前缀。字符串只能包含 Unicode 字母、数字、空格、“\$1”、“.”、“/”、“=”、“\$1”、“-”的集合（Java 正则表达式：`"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`）。

  在标签集中，值不必具有唯一性，且可为空值。例如，在“项目/Trinity”和“成本 - 中心/Trinity”的一个标签集中，可以存在键值对。

您可以使用 AWS CLI 或 AWS DMS API 添加、列出和删除 AWS DMS 资源上的标签。在使用 AWS CLI 或 AWS DMS API 时，必须提供要使用的 AWS DMS 资源的 Amazon 资源名称（ARN）。有关构造 ARN 的详细信息，请参阅[为其构造亚马逊资源名称 (ARN) AWS DMS](CHAP_Introduction.AWS.ARN.md)。

注意，对标签进行缓存以用于授权。因此，如果添加和更新 AWS DMS 资源上的标签，可能需要几分钟后标签才可用。

## API
<a name="CHAP_Tagging.API"></a>

您可使用 AWS DMS API 为 AWS DMS 资源添加、列出或删除标签。
+ 要向 AWS DMS 资源添加标签，请使用 [https://docs.aws.amazon.com/dms/latest/APIReference/API_AddTagsToResource.html](https://docs.aws.amazon.com/dms/latest/APIReference/API_AddTagsToResource.html) 操作。
+ 要列出分配给 AWS DMS 资源的标签，请使用 [https://docs.aws.amazon.com/dms/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/dms/latest/APIReference/API_ListTagsForResource.html) 操作。
+ 要从 AWS DMS 资源删除标签，请使用 [https://docs.aws.amazon.com/dms/latest/APIReference/API_RemoveTagsFromResource.html](https://docs.aws.amazon.com/dms/latest/APIReference/API_RemoveTagsFromResource.html) 操作。

要了解有关如何构建所需 ARN 的更多信息，请参阅[为其构造亚马逊资源名称 (ARN) AWS DMS](CHAP_Introduction.AWS.ARN.md)。

在通过 AWS DMS API 使用 XML 时，标签会使用如下架构：

```
<Tagging>
  <TagSet>
  	<Tag>
  		<Key>Project</Key>
  		<Value>Trinity</Value>
  	</Tag>
  	<Tag>
  		<Key>User</Key>
  		<Value>Jones</Value>
  	</Tag>
  </TagSet>
</Tagging>
```

下表提供了允许使用的 XML 标签及其特征的列表。请注意，密钥和值的内容是区分大小写的。例如，project=Trinity 和 PROJECT=Trinity 是两个不同的标签。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/dms/latest/userguide/CHAP_Tagging.html)