标记 Amazon OpenSearch Service 域 - Amazon Opensearch Service
标签示例使用标签 (控制台)使用标签 (Amazon CLI)使用标签（Amazon 开发工具包）
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=test 或 environment=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 参考中定义的所有操作，包括 AddTags、ListTags 和 RemoveTags 操作。有关安装和使用 Amazon 开发工具包的更多信息，请参阅 Amazon 软件开发工具包。