标记 APIs 在AWSGlue中 - AWS Glue
 —  数据类型  —Tag (标签) —  操作  —TagResource (标签_资源)UntagResource (untag_资源)GetTags (获取标签)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

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

标记 APIs 在AWSGlue中

数据类型

Tag 结构

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

有关标签和控制AWSGlue中资源访问的更多信息,请参阅 AWS胶水中的AWS标签 和 指定AWSGlue资源 ARNs 开发者指南中的。

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。有关AWSGlue资源的更多信息 ARNs,请参阅 AWSGaleARN字符串图案.

  • 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