AWS Glue 中的标记 API - AWS Glue
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

AWS Glue 中的标记 API

数据类型

Tag 结构

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

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

Fields

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

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

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

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

Operations

TagResource 操作(Python:tag_resource)

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

Request

  • 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 个字节。

    要添加到此资源的标签。

Response

  • 无响应参数。

Errors

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • EntityNotFoundException

UntagResource 操作(Python:untag_resource)

删除资源的标签。

Request

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

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

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

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

Response

  • 无响应参数。

Errors

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • EntityNotFoundException

GetTags 操作(Python:get_tags)

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

Request

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

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

Response

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

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

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

    请求的标签。

Errors

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • EntityNotFoundException