AWS Glue 中的标记 API - AWS Glue
 —  数据类型  —标签 —  操作  —TagResource (tag_resource)UntagResource (untag_resource)GetTags (get_tags)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

如果我们为英文版本指南提供翻译，那么如果存在任何冲突，将以英文版本指南为准。在提供翻译时使用机器翻译。

AWS Glue 中的标记 API

数据类型

Tag 结构

Tag 对象表示用户可分配给 AWS 资源的标签。每个标签都包含您定义的一个键和一个可选值。

有关标签以及如何控制对 AWS Glue 中资源的访问的更多信息，请参阅开发人员指南中的 AWS Glue 中的 AWS 标签和指定 AWS Glue 资源 ARN。

字段

  • key – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

    标签键。在对象上创建标签时需要这个键。键区分大小写，并且不得包含前缀 aws。

  • value – UTF-8 字符串，不超过 256 个字节。

    标签值。在对象上创建标签时，值是可选的。值区分大小写，并且不得包含前缀 aws。

操作

TagResource 操作（Python：tag_resource）

为资源添加标签。标签是可分配给 AWS 资源的标记。在 AWS Glue 中，您只能为特定资源添加标签。有关可添加标签的资源的信息，请参阅 AWS Glue 中的 AWS 标签。

请求

  • ResourceArn – 必需：UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 AWS Glue ARN string pattern 匹配。

    要向其添加标签的 AWS Glue 资源的 ARN。有关 AWS Glue 资源 ARN 的更多信息，请参阅 AWS Glue ARN 字符串模式。

  • TagsToAdd – 必需：键值对的映射数组，不超过 50 对。

    每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

    每个值是一个 UTF-8 字符串，不超过 256 个字节。

    要添加到此资源的标签。

响应

  • 无响应参数。

错误

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • EntityNotFoundException

UntagResource 操作（Python：untag_resource）

删除资源的标签。

请求

  • ResourceArn – 必需：UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 AWS Glue ARN string pattern 匹配。

    要从中删除标签的资源的 Amazon 资源名称 (ARN)。

  • TagsToRemove – 必需：UTF-8 字符串数组，不超过 50 个字符串。

    要从该资源中删除的标签。

响应

  • 无响应参数。

错误

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • EntityNotFoundException

GetTags 操作（Python：get_tags）

检索与资源关联的标签的列表。

请求

  • ResourceArn – 必需：UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 AWS Glue ARN string pattern 匹配。

    要检索其标签的资源的 Amazon 资源名称 (ARN)。

响应

  • Tags – 键值对的映射数组，不超过 50 对。

    每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

    每个值是一个 UTF-8 字符串，不超过 256 个字节。

    请求的标签。

错误

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • EntityNotFoundException