本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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