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

为 Amazon Neptune 资源添加标签

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

所有 Neptune 管理资源都可加标签,其中包括:

  • 数据库实例数

  • 数据库集群

  • 只读副本

  • 数据库快照

  • 数据库集群快照

  • 事件订阅

  • 数据库参数组

  • 数据库集群参数组

  • 数据库子网组

Neptune 资源标签概述

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

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

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

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

  • 标签键是标签的名称,属于必填内容。该字符串值的长度可以在 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}_.:/=+\\-]*)$”)。

    在标签集中,值不必具有唯一性,且可为空值。例如,在 project/Trinitycost-center/Trinity 的标签集中,可以存在键-值对。

注意

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

可以使用 Amazon Web Services 管理控制台、Amazon CLI 或 Neptune API 添加、列出和删除 Neptune 资源上的标签。在使用 Amazon CLI 或 Neptune API 时,必须提供要使用的 Neptune 资源的 Amazon 资源名称 (ARN)。有关构造 ARN 的详细信息,请参阅为 Neptune 构建 ARN

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

在 Neptune 中复制标签

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

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

  • 创建数据库实例。

  • 还原数据库实例。

  • 创建只读副本。

  • 复制数据库快照。

注意

如果您包括 create-db-cluster-snapshot Amazon CLI 命令的 --tag-key 参数的值(或至少为 CreateDBClusterSnapshot API 操作提供一个标签),则 Neptune 不会将源数据库实例中的标签复制到新数据库快照。即使源数据库实例已启用 --copy-tags-to-snapshot(CopyTagsToSnapshot) 选项也是如此。

这意味着,您可以从数据库快照创建数据库实例的副本,而无需添加不适用于新数据库实例的标签。使用 Amazon CLI create-db-cluster-snapshot 命令(或 CreateDBClusterSnapshot Neptune API 操作)创建数据库快照后,您随后可以按本主题后面所述添加标签。