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

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

Amazon Glue 中的标记 API

数据类型

Tag 结构

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

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

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

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

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

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

操作

TagResource 操作(Python:tag_resource)

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

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

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

    要向其添加标签的 Amazon Glue 资源的 ARN。有关 Amazon Glue 资源 ARN 的更多信息,请参阅 Amazon 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