给 Amazon Neptune 资源加标签 - Amazon Neptune
添加标签概览在控制台中进行标记使用 CLI 进行标记使用 API 进行标记
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=test 或 environment=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/Trinity 和 cost-center/Trinity 的标签集中，可以存在键-值对。

注意

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

您可以使用 Amazon Web Services Management Console Amazon CLI、或 Neptune API 在海王星资源上添加、列出和删除标签。使用 Amazon CLI 或 Neptune API 时，必须为要使用的海王星资源提供亚马逊资源名称 (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命令（或 Nep CreateDBClusterSnapshot tune API 操作）创建数据库快照后，您可以按照本主题后面的说明添加标签。

在 Neptune 中使用标记 Amazon Web Services Management Console

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

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

  1. 登录 Amazon 管理控制台，打开亚马逊 Neptune 控制台，网址为 https://console.aws.amazon.com/neptune/home。

  2. 在导航窗格中，选择实例。

    注意

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

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

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

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

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

  7. 为标签键和值键入一个值。

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

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

  9. 选择 Add。

删除数据库实例的标签

  1. 登录 Amazon 管理控制台，打开亚马逊 Neptune 控制台，网址为 https://console.aws.amazon.com/neptune/home。

  2. 在导航窗格中，选择实例。

    注意

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

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

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

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

  6. 选择要删除的标签。

  7. 选择删除，然后在删除标签窗口中选择删除。

在 Neptune 中使用标记 Amazon CLI

可以使用 Amazon CLI 为 Neptune 中的数据库实例添加、列出或删除标签。

要了解有关如何构建所需 Amazon 资源名称 (ARN) 的更多信息，请参阅为 Neptune 构建 ARN。

使用 API 在 Neptune 中加标签

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

要了解有关如何构建所需 ARN 的更多信息，请参阅为 Neptune 构建 ARN。

在通过 Neptune API 使用 XML 时，标签会使用如下架构：

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

下表提供了允许使用的 XML 标签及其特征的列表。Key 和 Value 的值都区分大小写。例如，project=Trinity 和 PROJECT=Trinity 是两个不同的标签。

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

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

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