# AWS Glue에서 API 태그 지정
<a name="aws-glue-api-tags"></a>

## 데이터 타입
<a name="aws-glue-api-tags-objects"></a>
+ [태그 구조](#aws-glue-api-tags-Tag)

## 태그 구조
<a name="aws-glue-api-tags-Tag"></a>

`Tag` 객체는 AWS 리소스에 할당할 수 있는 레이블을 나타냅니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.

AWS Glue의 태그 및 리소스 액세스 제어에 대한 자세한 내용은 개발자 가이드에서 [AWS Glue의 AWS 태그](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) 및 [AWS Glue 리소스 ARN 지정](https://docs.aws.amazon.com/glue/latest/dg/glue-specifying-resource-arns.html)을 참조하세요.

**Fields**
+ `key` – 1\~128바이트 길이의 UTF-8 문자열입니다.

  태그 키 객체에서 태그를 생성할 때 이 키는 필수입니다. 이 키는 대/소문자를 구분하며 접두사 aws를 포함해서는 안 됩니다.
+ `value` – 256바이트 이하 길이의 UTF-8 문자열입니다.

  태그 값 이 값은 객체에서 태그를 생성할 때 선택 사항입니다. 이 값은 대/소문자를 구분하며 접두사 aws를 포함해서는 안 됩니다.

## 작업
<a name="aws-glue-api-tags-actions"></a>
+ [TagResource 작업(Python: tag\_resource)](#aws-glue-api-tags-TagResource)
+ [UntagResource 작업(Python: untag\_resource)](#aws-glue-api-tags-UntagResource)
+ [GetTags 작업(Python: get\_tags)](#aws-glue-api-tags-GetTags)

## TagResource 작업(Python: tag\_resource)
<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` – *필수(Required):* [Custom string pattern #50](aws-glue-api-common.md#regex_50)과(와) 일치하는 1\~10,240바이트 길이의 UTF-8 문자열입니다.

  태그를 추가할 AWS Glue 리소스의 ARN입니다. AWS Glue 리소스 ARN에 대한 자세한 내용은 [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` – *필수(Required):* 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\~128바이트인 UTF-8 문자열입니다.

  각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

  이 리소스에 추가할 태그입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `ResourceNotFoundException`

## UntagResource 작업(Python: untag\_resource)
<a name="aws-glue-api-tags-UntagResource"></a>

통합 리소스에서 지정된 태그를 제거합니다.

**요청**
+ `ResourceArn` – *필수(Required):* [Custom string pattern #50](aws-glue-api-common.md#regex_50)과(와) 일치하는 1\~10,240바이트 길이의 UTF-8 문자열입니다.

  통합 리소스의 Amazon 리소스 이름(ARN)입니다.
+ `TagsToRemove` – *필수(Required):* 50개 이하의 문자열로 구성된 UTF-8 문자열의 배열입니다.

  리소스에서 제거할 메타데이터 태그의 목록입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `ResourceNotFoundException`

## GetTags 작업(Python: get\_tags)
<a name="aws-glue-api-tags-GetTags"></a>

리소스와 연결된 태그의 목록을 검색합니다.

**요청**
+ `ResourceArn` – *필수(Required):* [Custom string pattern #50](aws-glue-api-common.md#regex_50)과(와) 일치하는 1\~10,240바이트 길이의 UTF-8 문자열입니다.

  태그를 검색할 리소스의 Amazon 리소스 이름(ARN)입니다.

**응답**
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\~128바이트인 UTF-8 문자열입니다.

  각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

  요청된 태그입니다.

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `EntityNotFoundException`