本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 中標記 APIs AWS Glue
<a name="aws-glue-api-tags"></a>

## 資料類型
<a name="aws-glue-api-tags-objects"></a>
+ [Tag 結構](#aws-glue-api-tags-Tag)

## Tag 結構
<a name="aws-glue-api-tags-Tag"></a>

`Tag` 物件代表您可以指派給 AWS 資源的標籤。每個標籤皆包含由您定義的一個金鑰與一個選用值。

如需 中標籤和控制資源存取的詳細資訊 AWS Glue，請參閱 開發人員指南中的 [AWS 中的標籤 AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html)和[指定 AWS Glue 資源 ARNs](https://docs.aws.amazon.com/glue/latest/dg/glue-specifying-resource-arns.html)。

**欄位**
+ `key` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。

  標籤金鑰。如果要在物件上建立標籤，您必須擁有金鑰。這份金鑰會區分大小寫，而且前綴不可為 aws。
+ `value` – UTF-8 字串，長度不可超過 256 個位元組。

  標籤值。如果要在物件上建立標籤，這個值為選用性。這個值區分大小寫，而且前綴不可為 aws。

## 作業
<a name="aws-glue-api-tags-actions"></a>
+ [TagResource 動作 (Python: tag\$1resource)](#aws-glue-api-tags-TagResource)
+ [UntagResource 動作 (Python: untag\$1resource)](#aws-glue-api-tags-UntagResource)
+ [GetTags 動作 (Python: get\$1tags)](#aws-glue-api-tags-GetTags)

## TagResource 動作 (Python: tag\$1resource)
<a name="aws-glue-api-tags-TagResource"></a>

為資源加上標籤。標籤是您可以指派給 AWS 資源的標籤。在 中 AWS Glue，您只能標記特定資源。如需哪些資源可供標記的資訊，請參閱 [AWS Glue中的AWS 標籤](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html)。

除了呼叫標籤相關 API 的標記許可外，您還需要呼叫連線上標記 API 的 `glue:GetConnection` 許可，以及呼叫資料庫上標記 API 的 `glue:GetDatabase` 許可。

**請求**
+ `ResourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 10240 個位元組，且需符合[Custom string pattern #50](aws-glue-api-common.md#regex_50)。

  要新增標籤之 AWS Glue 資源的 ARN。如需 AWS Glue 資源 ARNs 的詳細資訊，請參閱 [AWS Glue ARN 字串模式](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-common.html#aws-glue-api-regex-aws-glue-arn-id)。
+ `TagsToAdd` – *必要：*索引鍵/值對的對應陣列，不可超過 50 對。

  每個金鑰均為 UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。

  每個值都是 UTF-8 字串，長度不可超過 256 個位元組。

  要新增至此資源的標籤。

**回應**
+ *無回應參數。*

**錯誤**
+ `ResourceNotFoundException`

## UntagResource 動作 (Python: untag\$1resource)
<a name="aws-glue-api-tags-UntagResource"></a>

從整合資源移除指定的標籤。

**請求**
+ `ResourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 10240 個位元組，且需符合[Custom string pattern #50](aws-glue-api-common.md#regex_50)。

  整合資源的 Amazon Resource Name (ARN)。
+ `TagsToRemove` – *必要：*UTF-8 字串的陣列，不可超過 50 個字串。

  要從資源移除的中繼資料標籤的清單。

**回應**
+ *無回應參數。*

**錯誤**
+ `ResourceNotFoundException`

## GetTags 動作 (Python: get\$1tags)
<a name="aws-glue-api-tags-GetTags"></a>

擷取與資源關聯之標籤的清單。

**請求**
+ `ResourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 10240 個位元組，且需符合[Custom string pattern #50](aws-glue-api-common.md#regex_50)。

  要從中擷取這些標籤之資源的 Amazon Resource Name (ARN)。

**回應**
+ `Tags` – 金鑰值對的映射陣列，不超過 50 對。

  每個金鑰均為 UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。

  每個值都是 UTF-8 字串，長度不可超過 256 個位元組。

  要求的標籤。

**錯誤**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `EntityNotFoundException`