本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
为 Amazon OpenSearch 服务域名添加标签
标签允许您将任意信息分配给 Amazon S OpenSearch ervice 域,这样您就可以对这些信息进行分类和筛选。标签是您定义并与 OpenSearch 服务域关联的键值对。您可以使用这些标签通过对标签相似的资源的费用进行分组来跟踪成本。 AWS 不会对你的标签应用任何语义含义。标签严格按字符串进行解释。所有标签均包含以下元素:
每个 OpenSearch 服务域都有一个标签集,其中包含分配给该 OpenSearch 服务域的所有标签。 AWS 不会自动为 OpenSearch 服务域分配任何标签。标签集可以包含 0 到 50 个标签。如果使用与现有标记相同的键向域添加标记,则新值将覆盖旧值。
标签示例
您可以使用密钥定义类别,而值作为该类别中的项目。例如,您可以将标签键定义为project
,标签值为Salix
,表示 OpenSearch 服务域已分配给 Salix 项目。您也可以使用诸如或之类的密钥使用标签将 OpenSearch 服务域指定为用于测试environment=test
或生产environment=production
。尝试使用一组一致的标签密钥,以便更轻松地跟踪与 OpenSearch 服务域关联的元数据。
您还可以使用标签来整理 AWS 账单,以反映您自己的成本结构。为此,请注册以获取包含标签键值的 AWS 账户 账单。然后,如需查看组合资源的成本,请按有同样标签键值的资源组织您的账单信息。例如,您可以使用键值对标记多个 OpenSearch 服务域,然后整理账单信息以查看多个服务中每个域的总费用。有关更多信息,请参阅 https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html 账单和成本管理文档中的AWS 使用成本分配标签。
注意
对标签进行缓存以用于授权。因此,在 OpenSearch 服务域上添加和更新标签可能需要几分钟才能发布。
使用标签 (控制台)
控制台是标记域的最简单方法。
创建标签(控制台)
-
转至 https://aws.amazon.com
,然后选择 Sign In to the Console (登录控制台)。 -
在 “分析” 下,选择 “亚马逊 OpenSearch 服务”。
-
选择您要将标签添加到的域,然后转到 Tags(标签)选项卡。
-
选择 Manage(管理)和 Add new tag(添加新标签)。
-
输入一个标签键和可选的值。
-
选择保存。
要删除标签,请按照相同步骤操作并在 Manage tags(管理标签)页面中选择 Remove(删除)。
有关使用控制台处理标签的更多信息,请参阅《AWS 管理控制台入门指南》中的标签编辑器。
使用标签 (AWS CLI)
您可以使用 AWS CLI 带--add-tags命令的创建资源标签。
语法
add-tags --arn=<domain_arn> --tag-list
Key=<key>,Value=<value>
参数 | 描述 |
---|---|
--arn |
附加标签的 OpenSearch 服务域的 Amazon 资源名称。 |
--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 服务域中移除标签。
语法
remove-tags --arn=<domain_arn> --tag-keys
Key=<key>,Value=<value>
参数 | 描述 |
---|---|
--arn |
附加标签的 OpenSearch 服务域的亚马逊资源名称 (ARN)。 |
--tag-keys |
要从服务域中移除的一组以空格分隔的键值对。 OpenSearch |
示例
以下示例从之前示例中创建的 logs 域中删除两个标签:
aws opensearch remove-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-keys service instances
您可以使用以下--list-tags命令查看 OpenSearch 服务域的现有标签:
语法
list-tags --arn=<domain_arn>
参数 | 描述 |
---|---|
--arn |
附加标签的 OpenSearch 服务域的亚马逊资源名称 (ARN)。 |
示例
以下示例列出了 logs 域的所有资源标签:
aws opensearch list-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs
使用标签 (AWS SDK)
AWS 软件开发工具包(Android 和 iOS 软件开发工具包除外)支持《亚马逊 OpenSearch 服务 API 参考》中定义的所有操作,包括AddTags
ListTags
、和RemoveTags
操作。有关安装和使用软件开发 AWS 工具包的更多信息,请参阅AWS 软件开发套件
Python
此示例使用适用于 Python 的 AWS 开发工具包 (Boto) 中的OpenSearchServiceDOMAIN_ARN
、TAG_KEY
和 TAG_VALUE
的值。
import boto3 from botocore.config import Config # import configuration DOMAIN_ARN = '' # ARN for the domain. i.e "arn:aws:es:us-east-1:123456789012:domain/my-domain TAG_KEY = '' # The name of the tag key. i.e 'Smileyface' TAG_VALUE = '' # The value assigned to the tag. i.e 'Practicetag' # defines the configurations parameters such as region my_config = Config(region_name='us-east-1') client = boto3.client('opensearch', config=my_config) # defines the client variable def addTags(): """Adds tags to the domain""" response = client.add_tags(ARN=DOMAIN_ARN, TagList=[{'Key': TAG_KEY, 'Value': TAG_VALUE}]) print(response) def listTags(): """List tags that have been added to the domain""" response = client.list_tags(ARN=DOMAIN_ARN) print(response) def removeTags(): """Remove tags that have been added to the domain""" response = client.remove_tags(ARN=DOMAIN_ARN, TagKeys=[TAG_KEY]) print('Tag removed') return response