通过 API 操作使用标签 - Amazon Athena
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

通过 API 操作使用标签

您还可以使用带可选标签参数的 CreateWorkGroup API 操作,通过这些参数为工作组传递一个或多个标签。要添加、删除或列出标签,可以使用以下 AWS API 操作:TagResourceUntagResourceListTagsForResource

Athena 中的标签 API 操作
API 名称 操作描述
TagResource 在具指定 ARN 的工作组中添加或覆盖一个或多个标签。
UntagResource 从具指定 ARN 的工作组中删除一个或多个标签。
ListTagsForResource 列出具指定 ARN 的工作组资源的一个或多个标签。

有关更多信息,请参阅Amazon Athena API 参考

例 TagResource

在以下示例中,我们将向 workgroupA 添加两个标签:

List<Tag> tags = new ArrayList<>(); tags.add(new Tag().withKey("tagKey1").withValue("tagValue1")); tags.add(new Tag().withKey("tagKey2").withValue("tagValue2")); TagResourceRequest request = new TagResourceRequest() .withResourceARN("arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA") .withTags(tags); client.tagResource(request);
注意

请勿同时将重复的标签键添加到同一个工作组。如果这样操作,Athena 会发布一条错误消息。如果在单独的 TagResource 操作中使用现有标签键标记工作组,则新的标签值将覆盖旧值。

例 UntagResource

在以下示例中,我们将从 workgroupA 中删除 tagKey2

List<String> tagKeys = new ArrayList<>(); tagKeys.add("tagKey2"); UntagResourceRequest request = new UntagResourceRequest() .withResourceARN("arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA") .withTagKeys(tagKeys); client.untagResource(request);

例 ListTagsForResource

在以下示例中,我们将列出 workgroupA 的标签:

ListTagsForResourceRequest request = new ListTagsForResourceRequest() .withResourceARN("arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA"); ListTagsForResourceResult result = client.listTagsForResource(request); List<Tag> resultTags = result.getTags();