标记 Amazon OpenSearch Service 域 - Amazon Opensearch Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

标记 Amazon OpenSearch Service 域

标签允许您将任意信息分配给 Amazon OpenSearch Service 域,以便您可以对该信息进行分类和筛选。标签是由您定义的键-值对,与 Amazon OpenSearch Service 域关联。通过将具有类似标记的资源的费用分组,您可以使用这些标记来跟踪成本,Amazon 不会对标记应用任何语义。标签严格按字符串进行解释。所有标签均包含以下元素:

标签元素 描述 必填
标记密钥

标签键是标签的名称。密钥必须是附加到的 OpenSearch Service 域的唯一密钥。有关对标签键和值的基本限制的列表,请参阅用户定义的标签限制

标记值

标签值则是标签字符串值。标签值可为 null,且在标签集中不必具有唯一性。例如,在“项目/Trinity”和“成本 - 中心/Trinity”的一个标签集中,可以存在键值对。有关对标签键和值的基本限制的列表,请参阅用户定义的标签限制

每个 OpenSearch Service 域都有标签集,其中包含分配给该 OpenSearch Service 域的所有标签。Amazon不会自动将任何标签分配给 OpenSearch Service 域。标签集可以包含 0 到 50 个标签。如果使用与现有标记相同的键向域添加标记,则新值将覆盖旧值。

标签示例

您可以使用密钥定义类别,而值作为该类别中的项目。例如,可定义标签键 project 和标签值 Salix,指示OpenSearch Service 域已分配给 Salix 项目。您还可以使用标签来指定 OpenSearch Service 域,通过使用键(如,environment=testenvironment=production)用于测试或生产。我们建议使用一组具有一致性的标签键,以使跟踪与 域关联的元数据变得更轻松。

您也可以使用标签来管理 Amazon 账单,使其反映您的成本结构。要执行此操作,请注册以获取包含标签键值的 Amazon Web Services 账户 账单。然后,如需查看组合资源的成本,请按有同样标签键值的资源组织您的账单信息。例如,您可以使用键-值对标记多个 OpenSearch Service 域,然后组织账单信息,查看在数个服务中的每个域的总成本。有关更多信息,请参阅 https://docs.amazonaws.cn/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html 账单和成本管理文档中的Amazon使用成本分配标签

注意

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

使用标签 (控制台)

控制台是标记域的最简单方法。

创建标签(控制台)

  1. 转至 https://aws.amazon.com,然后选择 Sign In to the Console (登录控制台)

  2. Analytics 下,选择 Amazon OpenSearch Service

  3. 选择您要将标签添加到的域,然后转到 Tags(标签)选项卡。

  4. 选择 Manage(管理)Add new tag(添加新标签)

  5. 输入一个标签键和可选的值。

  6. 选择保存

要删除标签,请按照相同步骤操作并在 Manage tags(管理标签)页面中选择 Remove(删除)

有关使用控制台处理标签的更多信息,请参阅《Amazon 管理控制台入门指南》中的标签编辑器

使用标签 (Amazon CLI)

可以结合使用 Amazon CLI 与 --add-tags 命令来创建资源标签。

Syntax(语法

add-tags --arn=<domain_arn> --tag-list Key=<key>,Value=<value>

参数 描述
--arn 附加标签的 OpenSearch Service 域的 Amazon Resource Name。
--tag-list 采用以下格式设置空格分隔的键值对:Key=<key>,Value=<value>

示例

以下示例为 logs 域创建两个标签:

aws opensearch add-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-list Key=service,Value=OpenSearch Key=instances,Value=m3.2xlarge

可以使用 remove-tags 命令从 OpenSearch Service 域删除标签。

语法

remove-tags --arn=<domain_arn> --tag-keys Key=<key>,Value=<value>

参数 描述
--arn 附加标签的 OpenSearch Service 域的 Amazon Resource Name (ARN)。
--tag-keys 设置您要从 OpenSearch Service 域中移除的空格分隔的键-值对。

示例

以下示例从之前示例中创建的 logs 域中删除两个标签:

aws opensearch remove-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-keys service instances

您可以通过 list-tags 命令查看一个 OpenSearch Service 域的现有标签:

Syntax(语法

list-tags --arn=<domain_arn>

参数 描述
--arn 附加标签的 OpenSearch Service 域的 Amazon Resource Name (ARN)。

示例

以下示例列出了 logs 域的所有资源标签:

aws opensearch list-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs

使用标签(Amazon 开发工具包)

Amazon 开发工具包(除 Android 和 iOS 开发工具包之外)支持 OpenSearch Service 配置 API 参考中定义的所有操作,包括 AddTagsListTagsRemoveTags 操作。有关安装和使用 Amazon 开发工具包的更多信息,请参阅 Amazon 软件开发工具包