在 AWS Database Migration Service 中标记资源 - AWS 数据库迁移服务

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

在 AWS Database Migration Service 中标记资源

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

所有 AWS DMS 资源均可加标签:

  • 证书

  • 数据提供商

  • 数据迁移

  • 端点

  • 事件订阅

  • 实例配置文件

  • 迁移项目

  • 复制实例

  • 复制子网组

  • 复制任务

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

使用标签来组织AWS账单以反映您自身的成本结构。要执行此操作,请注册以获取包含标签键值的 AWS 账户 账单。然后,如需查看组合资源的成本,请按有同样标签键值的资源组织您的账单信息。例如,您可以将特定的应用程序名称用作几个资源的标签,然后组织账单信息,以查看在数个服务中的使用该应用程序的总成本。有关更多信息,请参阅 AWS Billing 用户指南 中的使用成本分配标签

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

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

下面列表描述了 AWS DMS 标签的特征。

  • 标签密钥是标签的名称,属于必填内容。该字符串值的长度可以是 1 到 128 个 Unicode 字符,并且不能以“aws:”或“dms:”为前缀。字符串只能包含 Unicode 字母、数字、空格、“_”、“.”、“/”、“=”、“+”、“-”的集合(Java 正则表达式:"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$")。

  • 标签值则是一个可选的标签字符串值。该字符串值的长度可以是 1 到 256 个 Unicode 字符,并且不能以“aws:”或“dms:”为前缀。字符串只能包含 Unicode 字母、数字、空格、“_”、“.”、“/”、“=”、“+”、“-”的集合(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 的详细信息,请参阅构造一个 Amazon 资源名称 (ARN) AWS DMS

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

API

您可使用 AWS DMS API 为 AWS DMS 资源添加、列出或删除标签。

要了解有关如何构建所需 ARN 的更多信息,请参阅构造一个 Amazon 资源名称 (ARN) AWS DMS

在通过 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 是两个不同的标签。

标签元素 描述
标签集 标签集是分配给 Amazon RDS 资源的所有标签的容器。每个资源只能有一个标签集。您只可以通过 AWS DMS API 使用标签集。
标签 标签是用户定义的键值对。一个标签集中可以有 1 到 10 个标签。

密钥是标签必需的名称。该字符串值的长度可以是 1 到 128 个 Unicode 字符,并且不能以“dms:”或“aws:”为前缀。字符串只能包含 Unicode 字母、数字、空格、“_”、“.”、“/”、“=”、“+”、“-”的集合(Java 正则表达式:"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$")。

密钥在标签集中必须具有唯一性。例如,标签集中不能有键相同但值不同的键-值对,如 project/Trinity 和 project/Xanadu。

值是标签的可选内容。该字符串值的长度可以是 1 到 256 个 Unicode 字符,并且不能以“dms:”或“aws:”为前缀。字符串只能包含 Unicode 字母、数字、空格、“_”、“.”、“/”、“=”、“+”、“-”的集合(Java 正则表达式:"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$")。

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