AWS Glue 中的标记 API - AWS Glue
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