本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
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 个字节。
要添加到此资源的标签。
响应
无响应参数。
错误
InvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionEntityNotFoundException
UntagResource 操作（Python：untag_resource）
删除资源的标签。
请求
-
ResourceArn– 必填：UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。要从中删除标签的资源的 Amazon Resource Name（ARN）。
-
TagsToRemove– 必填：UTF-8 字符串数组，不超过 50 个字符串。要从该资源中删除的标签。
响应
无响应参数。
错误
InvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionEntityNotFoundException
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 个字节。
请求的标签。
错误
InvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionEntityNotFoundException
