本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
为 Amazon Neptune 资源添加标签
您可以使用 Amazon Neptune 标签向您的 Neptune 资源添加元数据。此外,您还可以将标签与Amazon Identity and Access Management(IAM) 策略用于管理对 Neptune 资源的访问并控制可将什么操作应用于这些资源。最后,您可以将具有类似标签的资源的费用分组在一起,使用标签来跟踪成本。
所有 Neptune 资源都可添加标签,其中包括:
数据库实例
数据库集群
只读副本
数据库快照
数据库集群快照
事件订阅
数据库参数组
数据库集群参数组
数据库子网组
Neptune 资源标签概述
Amazon Neptune 标签是由您定义的名称-值对,与某种 Neptune 资源关联。此名称也叫键。为键提供值为可选操作。可使用标签向 Neptune 资源分配任意信息。例如,您可以使用标签键定义一个类别,而标签值可以是该类别中的一个项目。例如,您可能定义 “project” 标签键和 “Salix” 标签值,以指示将 Neptune 资源分配给 Salix 项目。您也可以使用标签通过以下键指定 Neptune 资源用于测试或生产。environment=test
要么environment =production
. 我们建议使用一组具有一致性的标签键,以使跟踪与 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 添加、列出和删除 Neptune 资源上的标签。使用Amazon CLI或者 Neptune API,必须提供要使用的 Neptune 资源的 Amazon 资源名称 (ARN)。有关构造 ARN 的详细信息,请参阅为 Neptune 构造 ARN。
对标签进行缓存以用于授权。因此,可能先用几分钟添加和更新 Neptune 资源上的标签,然后标签才可用。
在 Neptune 中复制标签
在创建或还原数据库实例时,您可以指定将数据库实例中的标签复制到数据库实例的快照。复制标签将确保数据库快照的元数据与源数据库实例的元数据匹配,并且数据库快照的任何访问策略与源数据库实例的任何访问策略匹配。默认情况下不复制标签。
您可以为以下操作指定将标签复制到数据库快照:
创建数据库实例。
还原数据库实例。
创建只读副本。
复制数据库快照。
如果您包含的值--tag-key
的参数创建数据库集群快照 Amazon CLI命令(或者至少提供一个标签给CreateDBClusterSnapshotAPI 操作),Neptune 不会将标签从源数据库实例复制到新的数据库快照。即使源数据库实例已启用 --copy-tags-to-snapshot
(CopyTagsToSnapshot
) 选项也是如此。
这意味着,您可以从数据库快照创建数据库实例的副本,而无需添加不适用于新数据库实例的标签。在使用Amazon CLI create-db-cluster-snapshot
命令(或CreateDBClusterSnapshot
Neptune 后,您随后可以按本主题后面所述添加标签。
在 Neptune 中使用Amazon Web Services Management Console
为 Amazon Neptune 资源加标签的过程对于所有资源均类似。以下过程演示如何为 Neptune 数据库实例添加标签。
要向数据库实例添加标签,请执行以下操作:
登录到Amazon并通过以下网址打开 Amazon Neptune 控制台:https://console.aws.amazon.com/neptune/home
. -
在导航窗格中,选择 Instances (实例)。
注意 要在实例窗格中筛选数据库实例列表,请在筛选实例框中键入文本字符串。只会显示包含该字符串的数据库实例。
-
选择您要为其添加标签的数据库实例。
-
选择实例操作,然后选择查看详细信息。
-
在详细信息部分中,向下滚动到标签部分。
-
选择 Add。将显示添加标签窗口。
-
为标签键和值键入一个值。
-
要添加其他标签,您可以选择添加其他标签,并为其标签键和值键入一个值。
将该步骤重复执行所需的次数。
-
选择 Add。
删除数据库实例的标签
登录到Amazon并通过以下网址打开 Amazon Neptune 控制台:https://console.aws.amazon.com/neptune/home
. -
在导航窗格中,选择 Instances (实例)。
注意 要在实例窗格中筛选数据库实例列表,请在筛选实例框中键入文本字符串。只会显示包含该字符串的数据库实例。
-
选择您要为其添加标签的数据库实例。
-
选择实例操作,然后选择查看详细信息。
-
在详细信息部分中,向下滚动到标签部分。
选择要删除的标签。
-
选择删除,然后在删除标签窗口中选择删除。
在 Neptune 中使用Amazon CLI
您可以使用为 Neptune 中的数据库实例添加、列出或删除标签。Amazon CLI.
要将一个或多个标签添加到 Neptune 资源,请使用Amazon CLI命令
add-tags-to-resource
.要列出 Neptune 资源上的标签,请使用Amazon CLI命令
list-tags-for-resource
.要从 Neptune 资源中删除一个或多个标签,请使用Amazon CLI命令
remove-tags-from-resource
.
要了解有关如何构建所需 Amazon 资源名称 (ARN) 的更多信息,请参阅为 Neptune 构造 ARN。
使用 API 在 Neptune 中进行标签
您可以使用 Neptune API 为数据库实例添加、列出或删除标签。
要向 Neptune 资源添加标签,请使用
AddTagsToResource
operation.要列出分配给 Neptune 资源的标签,请使用
ListTagsForResource
.要从 Neptune 资源中删除标签,请使用
RemoveTagsFromResource
operation.
要了解有关如何构建所需 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 资源的所有标签的容器。每个资源只能有一个标签集。你使用TagSet 只能通过 Neptune API。 |
Tag |
标签是用户定义的键值对。一个标签集中可以有 1 到 50 个标签。 |
Key |
密钥是标签必需的名称。该字符串值的长度可以在 1 到 128 个 Unicode 字符之间,并且不能带有前缀“ 密钥在标签集中必须具有唯一性。例如,标签集中不能有键相同但值不同的键-值对,如 |
值 | 值是标签的可选内容。该字符串值的长度可以在 1 到 256 个 Unicode 字符之间,并且不能带有前缀“ 在标签集中,值不必具有唯一性,且可为空值。例如,在 |