为 Amazon RDS 资源添加标签

可以使用 Amazon RDS 标签向您的 Amazon RDS 资源添加元数据。您可以使用标签自行添加有关数据库实例、快照、Aurora 集群等资源的符号。此举可以帮助您记录 Amazon RDS 资源。您还可以将标签与自动维护程序结合使用。

特别是，您可以将这些标签用于 IAM policy。您可以使用这些标签管理对 RDS 资源的访问，并控制可将什么操作应用于 RDS 资源。您还可以将具有类似标签的资源的费用分组在一起，使用标签来跟踪成本。

您可以标记以下 Amazon RDS 资源：

Amazon RDS 资源标签概述

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

此外，您可以在 IAM 策略中使用条件控制访问基于资源标签的 Amazon 资源。您可以使用全局 aws:ResourceTag/tag-key 条件键完成此操作。有关更多信息，请参阅《Amazon Identity and Access Management 用户指南》中的控制对 Amazon 资源的访问。

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

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

可以使用 Amazon Web Services Management Console、Amazon CLI 或 Amazon RDS API 添加、列出和删除 Amazon RDS 资源上的标签。在使用 CLI 或 API 时，确保提供要使用的 RDS 资源的 Amazon 资源名称（ARN）。有关构造 ARN 的详细信息，请参阅构建 Amazon RDS 的 ARN。

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

结合使用标签与 IAM 进行访问控制

您可以将标签与 IAM policy 结合使用来管理对 Amazon RDS 资源的访问。还可以使用标签来控制可将什么操作应用于 Amazon RDS 资源。

有关使用 IAM 策略管理对标记资源的访问的信息，请参阅Amazon RDS 的 Identity and Access Management。

使用标签生成详细的账单报告

您还可以将具有类似标签的资源的费用分组在一起，使用标签来跟踪成本。

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

添加、列出和删除标签

以下步骤说明如何对与数据库实例相关的资源执行典型的标记操作。

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

使用 Amazon 标签编辑器

您可以使用 Amazon Web Services Management Console 标签编辑器在 Amazon 中浏览和编辑 RDS 资源上的标签。有关更多信息，请参阅 Amazon Resource Groups 用户指南中的标签编辑器。

复制标签到数据库实例快照

在创建或还原数据库实例时，您可以指定将数据库实例中的标签复制到数据库实例的快照。复制标签可确保数据库快照的元数据与源数据库实例的元数据匹配。它还确保数据库快照的任何访问策略也与源数据库实例的访问策略相匹配。

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

在大多数情况下，默认不复制标签。不过，从数据库快照还原数据库实例时，RDS 会检查您是否指定新标签。如果是，新标签将添加到还原的数据库实例中。如果没有新的标签，RDS 会在创建快照时将源数据库实例中的标签添加到还原的数据库实例中。

为防止来自源数据库实例的标签添加到还原的数据库实例中，建议在还原数据库实例时指定新标签。

教程：使用标签指定要停止的数据库实例

假设您正在开发或测试环境中创建大量数据库实例。您需要将所有这些数据库实例保留几天。一些数据库实例会在夜间运行测试。另一些数据库实例可以在夜间停止运行，并在第二天重新开始运行。以下示例说明如何为适合在夜间停止运行的数据库实例分配标签。之后，该示例显示脚本如何检测哪些数据库实例具有该标签及随后停止这些数据库实例。在此示例中，键值对的值部分无关紧要。存在stoppable标签表示数据库实例具有此用户定义的属性。

您可以在每天结束时运行此类脚本，以确保停止非必要的数据库实例。还可以使用实用程序（例如 cron）安排任务，如每晚执行此类检查。例如，您可以这样做，以防某些数据库实例被误运行。在此，您可以对准备待检查数据库实例列表的命令进行微调。

以下命令生成数据库实例列表，但只生成处于available状态的数据库实例的列表。该脚本可以忽略已停止的数据库实例，因为它们将具有不同的状态值，如stopped或stopping。

$ aws rds describe-db-instances \
  --query '*[].{DBInstanceArn:DBInstanceArn,DBInstanceStatus:DBInstanceStatus}|[?DBInstanceStatus == `available`]|[].{DBInstanceArn:DBInstanceArn}' \
  --output text
arn:aws:rds:us-east-1:123456789102:db:db-instance-2447
arn:aws:rds:us-east-1:123456789102:db:db-instance-3395
arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance
arn:aws:rds:us-east-1:123456789102:db:pg2-db-instance

使用标签在 Amazon Backup 中启用备份

Amazon Backup 是一项完全托管的备份服务，可在云中以及本地方便地集中管理和自动执行跨 Amazon 服务的数据备份。您可以在 Amazon Backup 中管理 Amazon RDS 数据库实例的备份。

要在 Amazon Backup 中启用备份，您可以使用资源标记将数据库实例与备份计划关联起来。

此示例假定您已在 Amazon Backup 中创建了一个备份计划。您对数据库实例使用的标签与备份计划中使用的标签完全相同，如下图所示。

有关 Amazon Backup 的更多信息，请参阅 Amazon Backup 开发人员指南。

您可以使用 Amazon Web Services Management Console、Amazon CLI 或 RDS API 为数据库实例分配标签。以下示例适用于控制台和 CLI。

为数据库实例分配标签

1. 登录Amazon Web Services Management Console并通过以下网址打开 Amazon RDS 控制台：https://console.aws.amazon.com/rds/。

2. 在导航窗格中，选择 Databases (数据库)。

3. 选择要为其分配标签的数据库实例的链接。

4. 在数据库详细信息页面上，选择Tags（标签）选项卡。

5. 在Tags（标签）下，选择 Add tags（添加标签）。

6. 在 Add tags（添加标签）下：

   1. 在 Tag key（标签键）中输入 BackupPlan。

   2. 在 Value（值）中输入 Test。

   3. 选择 Add。

结果随后显示在 Tags（标签）下。

为数据库实例分配标签

• 使用以下 CLI 命令：

  对于 Linux、macOS 或 Unix：

  aws rds add-tags-to-resource \
    --resource-name arn:aws:rds:us-east-1:123456789012:db:new-orcl-db \
    --tags Key=BackupPlan,Value=Test

  对于 Windows：

  aws rds add-tags-to-resource ^
    --resource-name arn:aws:rds:us-east-1:123456789012:db:new-orcl-db ^
    --tags Key=BackupPlan,Value=Test

add-tags-to-resource CLI 命令没有返回输出。

确认数据库实例已标记

• 使用以下 CLI 命令：

  对于 Linux、macOS 或 Unix：

  aws rds list-tags-for-resource \
    --resource-name arn:aws:rds:us-east-1:123456789012:db:new-orcl-db

  对于 Windows：

  aws rds list-tags-for-resource ^
    --resource-name arn:aws:rds:us-east-1:123456789012:db:new-orcl-db

list-tags-for-resource CLI 命令将返回以下输出：

{
    "TagList": [
        {
            "Key": "BackupPlan",
            "Value": "Test"
        }
    ]
}