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

标记 Amazon Elasticsearch Service 域

可以使用 Amazon ES 标签将元数据添加到 Amazon ES 域。AWS 不会对您的标签应用任何语义意义。标签严格按字符串进行解释。所有标签均包含以下元素。

标签元素 描述
标记密钥 标签键是标签的名称,属于必填内容。标签键在其附加的 Amazon ES 域中必须是唯一的。有关对标签键和值的基本限制的列表,请参阅用户定义的标签限制
标记值 标签值则是一个可选的标签字符串值。标签值可为 null,且在标签集中不必具有唯一性。例如,在“项目/Trinity”和“成本 - 中心/Trinity”的一个标签集中,可以存在键值对。有关对标签键和值的基本限制的列表,请参阅用户定义的标签限制

每个 Amazon ES 域都有一组标签,其中包含分配给该 Amazon ES 域的所有标签。AWS 不会自动在任何 Amazon ES 域上设置任何标签。一个标签集可以包含最多 50 个标签,也可以为空。如果向 Amazon ES 域添加一个标签,而该标签的键与资源上某个现有的标签相同,则新值将覆盖旧值。

最后,通过将具有类似标签的资源的支出集中在一起,您可以使用这些标签跟踪成本。Amazon ES 域是由您定义的名称-值对,与某个 Amazon ES 域关联。此名称也叫。可使用标签向 Amazon ES 域分配任意信息。举例来说,标签键可用于定义一个类别,而标签值可以是该类别中的一个项目。例如,可定义“project”标签键和“Salix”标签值,表示向 Salix 项目分配了 Amazon ES 域。您也可以使用标签通过 environment=testenvironment=production 等键指定 Amazon ES 域用于测试或生产。我们建议使用一组具有一致性的标签键,以使跟踪与 Amazon ES 域关联的元数据变得更轻松。

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

注意

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

使用标签 (控制台)

请使用以下步骤创建资源标签。

创建标签 (控制台)

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

  2. Analytics (分析) 下,选择 Elasticsearch Service

  3. 在导航窗格中,选择您的 Amazon ES 域。

  4. 在域控制面板上,选择 Manage tags (管理标签)

  5. Key (键) 列中,输入标签键。

  6. (可选)在 Value (值) 列中,输入标签值。

  7. 选择 Submit

删除标签 (控制台)

使用以下过程可删除资源标签。

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

  2. Analytics (分析) 下,选择 Elasticsearch Service

  3. 在导航窗格中,选择您的 Amazon ES 域。

  4. 在域控制面板上,选择 Manage tags (管理标签)

  5. 在要删除的标签的旁边,选择 Remove (删除)

  6. 选择 Submit

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

使用标签 (AWS CLI)

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

语法

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

参数 说明
--arn 附加标签的 Amazon ES 域的 Amazon 资源名称。
--tag-list 采用以下格式设置空格分隔的键值对:Key=<key>,Value=<value>

示例

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

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

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

语法

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

参数 说明
--arn 附加标签的 Amazon ES 域的 Amazon 资源名称 (ARN)。
--tag-keys 设置您要从 Amazon ES 域中移除的空格分隔的键-值对。

示例

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

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

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

语法

list-tags --arn=<domain_arn>

参数 说明
--arn 附加标签的 Amazon ES 域的 Amazon 资源名称 (ARN)。

示例

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

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

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

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