为 Amazon DocumentDB 资源添加标签 - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

为 Amazon DocumentDB 资源添加标签

您可以使用 Amazon DocumentDB(具有 MongoDB 兼容性)标签向 Amazon DocumentDB 资源添加元数据。这些标签可与Amazon Identity and Access Management(IAM) 策略,以管理对 Amazon DocumentDB 资源的访问并控制可将什么操作应用于资源。您还可以将具有类似标签的资源的费用分组在一起,使用标签来跟踪成本。

您可以为以下 Amazon DocumentDB 资源添加标签:

  • 集群

  • 实例

  • 快照

  • 集群快照

  • 参数组

  • 集群参数组

  • 安全组

  • 子网组

Amazon DocumentDB 资源标签概述

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

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

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

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

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

您可以将Amazon Web Services Management Console或Amazon CLI可在 Amazon DocumentDB 资源上添加、列出和删除标签。使用 Amazon CLI 时,必须提供要使用的资源的 Amazon 资源名称 (ARN)。有关 Amazon DocumentDB ARN 的更多信息,请参阅了解 Amazon DocumentDB Amazon 资源名称 (ARN)

标签约束

以下限制适用于 Amazon DocumentDB 标签:

  • 每个资源的最大标签数-10

  • 最大长度 - 128 个 Unicode 字符

  • 最大长度 - 256 个 Unicode 字符

  • 的有效字符 - UTF-8 字符集中的大写和小写字母、位、空格及以下字符:_ . : / = + -@ (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$")

  • 标签键和值区分大小写。

  • 前缀 aws: 无法用于标签键或值;将其保留供 Amazon 使用。

在 Amazon DocumentDB 资源上添加和更新标签

您最多可以将 10 个标签添加到资源,使用Amazon Web Services Management Console或Amazon CLI。

使用 Amazon Web Services Management Console

无论您将标签添加到哪个资源,向资源添加标签的过程都是相似的。在本示例中,您向集群添加标签。

要使用控制台向集群添加标签或更新标签

  1. 登录到Amazon Web Services Management Console,然后打开 Amazon DocumentDB 控制台https://console.aws.amazon.com/docdb

  2. 从导航窗格中,选择集群

  3. 选择要将标签添加到的集群的名称。

  4. 向下滚动到标签部分,然后选择 编辑

  5. 对于每个要添加到此资源的标签,请执行以下操作:

    1. 要添加新标签,请在框中输入标签的名称。要更改标签的值,请在列中找到标签的名称。

    2. 要赋予标签新建或更新的值,在框中,为标签输入一个值。

    3. 如果要添加多个标签,请选择添加。否则,完成后,选择保存

使用 Amazon CLI

无论您将标签添加到哪个资源,向资源添加标签的过程都是相似的。在本示例中,您向集群添加三个标签。第二个标签 key2 没有值。

使用带有这些参数的 Amazon CLI 操作 add-tags-to-resource

Parameters

  • --resource-name— 要将标签添加到的 Amazon DocumentDB 资源的 ARN。

  • --tags— 要添加到格式为的此资源的标签(键/值对)的列表到此资源Key=key-name,Value=tag-value

对于 Linux、macOS 或 Unix:

aws docdb add-tags-to-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3

对于 Windows:

aws docdb add-tags-to-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3

add-tags-to-resource 操作不会生成任何输出。要查看操作结果,请使用 list-tags-for-resource 操作。

列出 Amazon DocumentDB 资源上的标签

您可以将Amazon Web Services Management Console或Amazon CLI获取 Amazon DocumentDB 资源的标签列表。

使用 Amazon Web Services Management Console

无论您将标签添加到哪个资源,在资源上列出标签的过程都是相似的。在本示例中,您为集群列出标签。

要使用控制台列出集群上的标签

  1. 从打开 Amazon DocumentDB 控制台https://console.aws.amazon.com/docdb

  2. 从导航窗格中,选择集群

  3. 选择要为之列出标签的集群的名称。

  4. 要查看此资源上的标签列表,向下滚动到标签部分。

使用 Amazon CLI

无论您为哪个资源列出标签,在资源上列出标签的过程都是相似的。在本示例中,您在集群上列出标签。

使用带有这些参数的 Amazon CLI 操作 list-tags-for-resource

Parameters

  • --resource-name— 必需。您要列出其标签的 Amazon DocumentDB 资源的 ARN。

对于 Linux、macOS 或 Unix:

aws docdb list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster

对于 Windows:

aws docdb list-tags-for-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster

此操作的输出将类似于下文(JSON 格式)。

{ "TagList": [ { "Key": "key1", "Value": "value1" }, { "Key": "key2", "Value": "" }, { "Key": "key3", "Value": "value3" } ] }

删除 Amazon DocumentDB 资源的标签

您可以将Amazon Web Services Management Console或Amazon CLI可删除 Amazon DocumentDB 资源的标签。

使用 Amazon Web Services Management Console

无论您将标签添加到哪个资源,从资源中删除标签的过程都是相似的。在本示例中,您从集群中删除标签。

使用控制台从集群中删除标签

  1. 从打开 Amazon DocumentDB 控制台https://console.aws.amazon.com/docdb

  2. 从导航窗格中,选择集群

  3. 选择要从中删除标签的集群的名称。

  4. 向下滚动到标签部分,然后选择 编辑

  5. 如果您要从该资源中删除所有标签,请选择 Remove all (删除所有)。否则,对于每个要从此资源删除的标签,请执行以下操作:

    1. 查找列中的标签的名称。

    2. 在同一行上选择删除作为标签值。

    3. 完成后,选择保存

使用 Amazon CLI

无论您从哪个资源删除标签,从资源中删除标签的过程都是相似的。在本示例中,您从集群中删除标签。

使用带有这些参数的 Amazon CLI 操作 remove-tags-from-resource

  • --resource-name— 必需。要从中删除标签的 Amazon DocumentDB 资源的 ARN。

  • --tag-keys— 必需。要从此资源中删除的标签值列表。

对于 Linux、macOS 或 Unix:

aws docdb remove-tags-from-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3

对于 Windows:

aws docdb remove-tags-from-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3

removed-tags-from-resource 操作不会生成任何输出。要查看操作结果,请使用 list-tags-for-resource 操作。