AWS Glue 中的标记 API - AWS Glue

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 标签

除了调用标签相关的 API 的标记权限外,您还需要在连接上调用标记 API 的 glue:GetConnection 权限以及对数据库调用标记 API 的 glue:GetDatabase 权限。

请求
  • ResourceArn必填:UTF-8 字符串,长度不少于 1 个字节或超过 10240 个字节,与 Custom string pattern #22 匹配。

    要向其添加标签的 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 个字节,与 Custom string pattern #22 匹配。

    要从中删除标签的资源的 Amazon Resource Name(ARN)。

  • TagsToRemove必填:UTF-8 字符串数组,不超过 50 个字符串。

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

响应
  • 无响应参数。

错误
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • EntityNotFoundException

GetTags 操作(Python:get_tags)

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

请求
  • ResourceArn必填:UTF-8 字符串,长度不少于 1 个字节或超过 10240 个字节,与 Custom string pattern #22 匹配。

    要检索其标签的资源的 Amazon Resource Name(ARN)。

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

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

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

    请求的标签。

错误
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • EntityNotFoundException