기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon EMR on EKS 리소스 태그 지정
Amazon EMR on EKS 리소스 관리를 지원하려면 태그를 사용하여 각 리소스에 고유한 메타데이터를 할당할 수 있습니다. 이 주제에서는 태그 함수에 대한 개요를 제공하고 태그를 생성하는 방법을 보여줍니다.
**Topics**
+ [태그 기본 사항](#tag-resources-tag-basics)
+ [리소스에 태그 지정](#tag-resources-add-tags)
+ [태그 제한](#tag-resources-restrictions)
+ [AWS CLI 및 Amazon EMR on EKS API를 사용하여 태그 작업](#tag-resources-work-with-tags)
## 태그 기본 사항
태그는 AWS 리소스에 할당하는 레이블입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.
태그를 사용하면 용도, 소유자 또는 환경과 같은 속성별로 AWS 리소스를 분류할 수 있습니다. 동일한 유형의 리소스가 많은 경우 할당한 태그에 따라 특정 리소스를 빠르게 식별할 수 있습니다. 예를 들어, Amazon EMR on EKS 클러스터에 태그 세트를 정의하면 클러스터의 소유자 및 스택 수준을 추적하는 데 도움이 됩니다. 각 리소스 유형에 대해 일관된 태그 키 집합을 고안하는 것이 좋습니다. 그러면 추가하는 태그에 따라 리소스를 검색하고 필터링할 수 있습니다.
태그가 리소스에 자동으로 할당되는 것은 아닙니다. 태그를 추가한 후에는 언제든지 태그 키와 값을 편집하거나 리소스에서 태그를 제거할 수 있습니다. 리소스를 삭제하면 리소스에 대한 모든 태그도 삭제됩니다.
태그는 Amazon EMR on EKS에는 아무런 의미가 없으며 엄격하게 문자열로 해석됩니다.
태그 값에 빈 문자열은 지정할 수 있지만, null은 지정할 수 없습니다. 태그 키는 빈 문자열일 수 없습니다. 해당 리소스에 대해 키가 기존 태그와 동일한 태그를 추가하는 경우 새 값이 이전 값을 덮어씁니다.
AWS Identity and Access Management (IAM)를 사용하는 경우 태그 관리 권한이 있는 AWS 계정의 사용자를 제어할 수 있습니다.
태그 기반 액세스 제어 정책 예제는 [태그 기반 액세스 제어를 위한 정책](security_iam_TBAC.md) 섹션을 참조하세요.
## 리소스에 태그 지정
활성 상태인 새로운 가상 클러스터 또는 기존 가상 클러스터와 작업 실행에 태그를 지정할 수 있습니다. 작업 실행의 활성 상태로, `PENDING`, `SUBMITTED`, `RUNNING`, `CANCEL_PENDING`이 있습니다. 가상 클러스터의 활성 상태로, `RUNNING`, `TERMINATING`, `ARRESTED`가 있습니다. 자세한 내용은 [작업 실행 상태](emr-eks-jobs-states.md) 및 [가상 클러스터 상태](virtual-cluster.md#virtual-cluster-states) 섹션을 참조하세요.
가상 클러스터가 종료되면 태그가 정리되고 더 이상 태그에 액세스할 수 없습니다.
Amazon EMR on EKS API AWS CLI, 또는 AWS SDK를 사용하는 경우 관련 API 작업의 태그 파라미터를 사용하여 새 리소스에 태그를 적용할 수 있습니다. `TagResource` API 작업을 사용하여 기존 리소스에 태그를 적용할 수도 있습니다.
일부 리소스 생성 작업을 사용해서 리소스 생성 시 리소스의 태그를 지정할 수 있습니다. 이 경우 리소스를 생성하는 동안 태그를 적용할 수 없는 경우 리소스를 생성하지 못합니다. 이 매커니즘에서는 생성 중에 태그를 지정하려는 리소스가 지정된 태그와 함께 생성되거나 전혀 생성되지 않습니다. 생성 시 리소스에 태그를 지정하면 리소스 생성 후 사용자 지정 태깅 스크립트를 실행할 필요가 없습니다.
다음 테이블에서는 태그를 지정할 수 있는 Amazon EMR on EKS 리소스를 설명합니다.
****
| Resource | 태그 지원 | 태그 전달 지원 | 생성 시 태그 지정 지원(Amazon EMR on EKS API AWS CLI및 AWS SDK) | 생성을 위한 API(생성 중에 태그를 추가할 수 있음) |
| --- | --- | --- | --- | --- |
| 가상 클러스터 | 예 | 아니요. 가상 클러스터와 관련된 태그는 해당 가상 클러스터에 제출된 작업 실행에 전파되지 않습니다. | 예 | CreateVirtualCluster |
| 작업 실행 | 예 | 아니요 | 예 | StartJobRun |
## 태그 제한
태그에 적용되는 기본 제한은 다음과 같습니다.
+ 리소스당 최대 태그 수 – 50개
+ 각 리소스에 대해 각 태그 키는 고유하며 하나의 값만 가질 수 있습니다.
+ 최대 키 길이 - UTF-8 형식의 유니코드 문자 128자
+ 최대 값 길이 - UTF-8 형식의 유니코드 문자 256자
+ 여러 AWS 서비스 및 리소스에서 태깅 스키마를 사용하는 경우 다른 서비스에 허용되는 문자에 대한 제한이 있을 수 있습니다. 일반적으로 허용되는 문자는 UTF-8로 표시할 수 있는 문자, 숫자 및 공백과 특수 문자 \$1 - = . \$1 : / @입니다.
+ 태그 키와 값은 대소문자를 구분합니다.
+ 태그 값에 빈 문자열은 지정할 수 있지만, null은 지정할 수 없습니다. 태그 키는 빈 문자열일 수 없습니다.
+ 키 또는 값에 `aws:`, `AWS:` 또는 이러한 접두사의 대문자 또는 소문자 조합을 사용하지 않습니다. 이는 AWS 전용으로 예약되어 있습니다.
## AWS CLI 및 Amazon EMR on EKS API를 사용하여 태그 작업
다음 AWS CLI 명령 또는 Amazon EMR on EKS API 작업을 사용하여 리소스에 대한 태그를 추가, 업데이트, 나열 및 삭제합니다.
****
| Task | AWS CLI | API 작업 |
| --- | --- | --- |
| 하나 이상의 태그를 추가하거나 덮어씁니다. | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/emr-containers/tag-resource.html) | [TagResource](https://docs.aws.amazon.com/emr-on-eks/latest/APIReference/API_TagResource.html) |
| 리소스에 대한 태그 나열 | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/emr-containers/list-tags-for-resource.html) | [ListTagsForResource](https://docs.aws.amazon.com/emr-on-eks/latest/APIReference/API_ListTagsForResource.html) |
| 하나 이상의 태그를 삭제합니다. | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/emr-containers/untag-resource.html) | [UntagResource](https://docs.aws.amazon.com/emr-on-eks/latest/APIReference/API_UntagResource.html) |
다음 예제는 AWS CLI를 사용하여 리소스에 태그를 지정하거나 태그를 제거하는 방법을 보여줍니다.
**예제 1: 기존 클러스터에 태그 지정**
다음 명령은 기존 가상 클러스터에 태그를 지정합니다.
```
aws emr-containers tag-resource --resource-arn resource_ARN --tags team=devs
```
**예제 2: 기존 클러스터에서 태그 제거**
다음 명령은 기존 가상 클러스터에서 태그를 삭제합니다.
```
aws emr-containers untag-resource --resource-arn resource_ARN --tag-keys tag_key
```
**예제 3: 리소스의 태그 나열**
다음 명령은 기존 리소스와 연결된 태그를 나열합니다.
```
aws emr-containers list-tags-for-resource --resource-arn resource_ARN
```