Amazon Relational Database Service
用户指南 (API Version 2014-10-31)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

标记 Amazon RDS 资源

您可使用 Amazon RDS 标签向您的 Amazon RDS 资源添加元数据。此外,这些标签可与 IAM 策略结合使用,以管理对 Amazon RDS 资源的访问并控制可将什么操作应用于 Amazon RDS 资源。最后,通过将具有类似标签的资源的支出集中在一起,这些标签可用于跟踪成本。

所有 Amazon RDS 资源均可加标签

  • 数据库实例

  • 数据库集群

  • 只读副本

  • 数据库快照

  • 数据库集群快照

  • 预留数据库实例

  • 事件订阅

  • 数据库选项组

  • 数据库参数组

  • 数据库集群参数组

  • 数据库安全组

  • 数据库子网组

有关使用 IAM 策略管理对标记资源的访问的信息,请参阅Amazon RDS 的身份验证和访问控制

Amazon RDS 资源标签概述

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

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

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

AWS 不会对您的标记应用任何语义意义;所有标记都会严格地作为字符串进行解析。Amazon RDS 可以在数据库实例或其他 Amazon RDS 资源上设置标签,这取决于您创建资源时使用的设置。例如,Amazon RDS 可添加一个标签来指示数据库实例用于生产或测试。

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

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

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

注意

您可以将标签添加到快照中,但您的账单不会反映该组。

可使用 AWS 管理控制台、命令行界面或 Amazon RDS API 添加、列出和删除 Amazon RDS 资源上的标签。在使用命令行界面或 Amazon RDS API 时,必须提供要使用的 Amazon RDS 资源的 Amazon 资源名称 (ARN)。有关构造 ARN 的详细信息,请参阅构建 Amazon RDS 的 ARN

对标签进行缓存以用于授权。因此,可能先用几分钟添加和更新 Amazon RDS 资源上的标签,然后标签才可用。

复制标签

在创建或还原数据库实例时,您可以指定将数据库实例中的标签复制到数据库实例的快照。复制标签将确保数据库快照的元数据与源数据库实例的元数据匹配,并且数据库快照的任何访问策略与源数据库实例的任何访问策略匹配。默认情况下不复制标签。

您可以为以下操作指定将标签复制到数据库快照:

  • 创建数据库实例。

  • 还原数据库实例。

  • 创建只读副本。

  • 复制数据库快照。

注意

如果您为 create-db-snapshot AWS CLI 命令的 --tag-key 参数包含了一个值 (或向 CreateDBSnapshot API 操作提供了至少一个标签),则 RDS 不会将源数据库实例中的标签复制到新的数据库快照。即使源数据库实例已启用 (--copy-tags-to-snapshot (CopyTagsToSnapshot) 选项,此功能也适用。如果您采用此方法,则可以从数据库快照创建数据库实例的副本且无需添加不适用于新数据库实例的标签。使用 AWS CLI create-db-snapshot 命令 (或 CreateDBSnapshot Amazon RDS API 操作) 创建数据库快照后,您随后可以按本主题后面所述添加标签。

AWS 管理控制台

为 Amazon RDS 资源加标签的过程对于所有资源均类似。以下过程展示如何为 Amazon RDS 数据库实例加标签。

要向数据库实例添加标签,请执行以下操作:

  1. 登录 AWS 管理控制台 并通过以下网址打开 Amazon RDS 控制台:https://console.amazonaws.cn/rds/

  2. 在导航窗格中,选择 Instances

    注意

    要在实例窗格中筛选数据库实例列表,请在筛选实例框中键入文本字符串。只会显示包含该字符串的数据库实例。

  3. 选择您要为其添加标签的数据库实例。

  4. 选择实例操作,然后选择查看详细信息

  5. 在详细信息部分中,向下滚动到标签部分。

  6. 选择 Add。将显示添加标签窗口。

     “添加标签”窗口
  7. 标签键键入一个值。

  8. 要添加其他标签,您可以选择添加其他标签,并为其标签键键入一个值。

    将该步骤重复执行所需的次数。

  9. 选择 Add

要从数据库实例删除标签,请执行以下操作

  1. 登录 AWS 管理控制台 并通过以下网址打开 Amazon RDS 控制台:https://console.amazonaws.cn/rds/

  2. 在导航窗格中,选择 Instances

    注意

    要在实例窗格中筛选数据库实例列表,请在筛选实例框中键入文本字符串。只会显示包含该字符串的数据库实例。

  3. 选择您要为其添加标签的数据库实例。

  4. 选择实例操作,然后选择查看详细信息

  5. 在详细信息部分中,向下滚动到标签部分。

  6. 选择要删除的标签。

     “标签”部分
  7. 选择删除,然后在删除标签窗口中选择删除

CLI

您可使用 AWS CLI 为数据库实例添加、列出或删除标签。

要了解有关如何构建所需 ARN 的更多信息,请参阅构建 Amazon RDS 的 ARN

API

您可使用 Amazon RDS API 为数据库实例添加、列出或删除标签。

要了解有关如何构建所需 ARN 的更多信息,请参阅构建 Amazon RDS 的 ARN

在通过 Amazon RDS 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 资源的所有标签的容器。每个资源只能有一个标签集。您只可以通过 Amazon RDS API 使用标签集。
标签 标签是用户定义的键值对。一个标签集中可以有 1 到 50 个标签。
密钥

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

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

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

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

相关主题