AWS Batch 리소스에 태그 지정

AWS Batch 리소스 관리를 돕기 위해 태그 형식으로 각 리소스에 고유한 메타데이터를 할당할 수 있습니다. 이 주제에서는 태그를 설명하고 태그를 생성하는 방법을 보여 줍니다.

태그 기본 사항

태그는 AWS 리소스에 할당하는 레이블입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.

태그를 사용하면 AWS 리소스를 용도, 소유자, 환경과 같은 다양한 기준으로 분류할 수 있습니다. 동일한 유형의 리소스가 많은 경우 할당한 태그에 따라 특정 리소스를 빠르게 식별할 수 있습니다. 예를 들어 AWS Batch 서비스에 태그 집합을 정의하면 각 서비스의 소유자 및 스택 수준을 추적하는 데 도움이 됩니다. 각 리소스 유형에 대해 일관된 태그 키 집합을 고안하는 것이 좋습니다.

태그가 리소스에 자동으로 할당되는 것은 아닙니다. 태그를 추가한 후에는 언제든지 태그 키와 값을 편집하거나 리소스에서 태그를 제거할 수 있습니다. 리소스를 삭제하면 리소스 태그도 삭제됩니다.

태그는 AWS Batch에는 의미가 없으며 엄격하게 문자열로 해석됩니다. 태그의 값을 빈 문자열로 설정할 수 있지만 태그의 값을 Null로 설정할 수는 없습니다. 해당 리소스에 대해 키가 기존 태그와 동일한 태그를 추가하는 경우 새 값이 이전 값을 덮어씁니다.

AWS Management Console, AWS CLI, AWS Batch API를 사용하여 태그 관련 작업을 수행할 수 있습니다.

AWS Identity and Access Management(IAM)를 사용하는 경우 AWS 계정에서 태그를 생성, 편집 또는 삭제할 수 있는 권한이 있는 사용자를 제어할 수 있습니다.

 리소스에 태그 지정

신규 또는 기존 AWS Batch 컴퓨팅 환경, 작업, 작업 정의, 작업 대기열, 예약 정책에 태그를 지정할 수 있습니다.

AWS Batch 콘솔을 사용 중인 경우 관련 리소스 페이지의 태그탭을 사용하면 새로 생성된 리소스 또는 기존 리소스에 태그를 언제든지 적용할 수 있습니다.

AWS Batch API, AWS CLI 또는 AWS SDK를 사용 중인 경우 관련 API 작업의 tags 파라미터를 사용하여 새 리소스에 태그를 적용하거나 TagResource API 작업을 사용하여 기존 리소스에 태그를 적용할 수 있습니다. 자세한 내용은 TagResource를 참조하세요.

일부 리소스 생성 작업에서는 리소스 생성 시 리소스에 태그를 지정할 수 있습니다. 리소스 생성 중에 태그를 적용할 수 없는 경우 리소스 생성 프로세스는 실패합니다. 이로써 생성 중에 태그를 지정하려는 리소스는 지정된 태그와 함께 생성되거나 전혀 생성되지 않습니다. 생성 시 리소스에 태그를 지정하면 리소스 생성 후 사용자 지정 태그 지정 스크립트를 실행할 필요가 없습니다.

다음 표는 태그를 지정할 수 있는 AWS Batch 리소스와 생성 시 태그를 지정할 수 있는 리소스를 설명합니다.

AWS Batch 리소스 태그 지정 지원
리소스	태그 지원	태그 전달 지원	생성 시 태그 지정 지원(AWS Batch API, AWS CLI, AWS SDK)
AWS Batch 컴퓨팅 환경	예	아니요. 컴퓨팅 환경 태그는 다른 리소스로 전파되지 않습니다. 리소스 태그는 CreateComputeEnvironment API 작업에서 전달된 ComputeResources 객체의 태그 멤버에 지정됩니다.	예
AWS Batch 작업	예	예	예
AWS Batch 작업 정의	예	아니요	예
AWS Batch 작업 대기열	예	아니요	예
AWS Batch 예약 정책	예	아니요	예

태그 제한

태그에 적용되는 기본 제한은 다음과 같습니다.

• 리소스당 최대 태그 수 – 50개

• 각 리소스에 대해 각 태그 키는 고유하며 하나의 값만 가질 수 있습니다.

• 최대 키 길이 - UTF-8 형식의 유니코드 문자 128자

• 최대 값 길이 - UTF-8 형식의 유니코드 문자 256자

• 태그 지정 스키마를 여러 AWS 서비스와 리소스에서 사용하는 경우 다른 서비스에서 허용되는 문자에 제한이 있을 수 있음에 유의하세요. 일반적으로 허용되는 문자는 UTF-8로 표시할 수 있는 문자, 숫자 및 공백과 특수 문자 + - = . _ : / @입니다.

• 태그 키와 값은 대/소문자를 구분합니다.

• AWS 용도로 예약된 키 또는 값에는 aws:, AWS: 또는 이러한 접두사의 대문자 또는 소문자 조합을 사용하지 않습니다. 이 접두사가 지정된 태그 키나 값은 편집하거나 삭제할 수 없습니다. 이 접두사가 포함된 태그는 리소스당 태그 수 제한에 포함되지 않습니다.

콘솔을 사용한 태그 작업

AWS Batch 콘솔을 사용하면 신규 또는 기존 컴퓨팅 환경, 작업, 작업 정의, 작업 대기열과 연결된 태그를 관리할 수 있습니다.

생성 중 개별 리소스에서 태그 추가

AWS Batch 컴퓨팅 환경, 작업, 작업 정의, 작업 대기열 및 예약 정책을 생성할 때 해당 정책에 태그를 추가할 수 있습니다.

개별 리소스에 대한 태그 추가 및 삭제

AWS Batch를 사용하면 리소스 페이지에서 클러스터에 연결된 태그를 직접 추가하거나 삭제할 수 있습니다.

개별 리소스에서 태그를 추가하거나 삭제하려면

1. https://console.aws.amazon.com/batch/에서 AWS Batch 콘솔을 엽니다.

2. 탐색 모음에서 사용할 리전을 선택합니다.

3. 탐색 창에서 리소스 유형을 선택합니다(예: 작업 대기열).

4. 특정 리소스를 선택한 다음, 태그 편집을 선택합니다.

5. 필요에 따라 태그를 추가하거나 삭제합니다.

   • 태그를 추가하려면 목록 끝에 있는 빈 텍스트 상자에 키와 값을 지정합니다.

   • 태그를 삭제하려면 태그 옆의 버튼을 선택합니다.

6. 추가하거나 삭제하려는 각 태그에 대해 이 프로세스를 반복한 다음 태그 편집을 선택하여 작업을 마칩니다.

CLI 또는 API를 사용한 태그 작업

다음 AWS CLI 명령 또는 AWS Batch API 작업을 사용하여 리소스에 대한 태그를 추가, 업데이트, 나열 및 삭제합니다.

AWS Batch 리소스 태그 지정 지원
태스크	API 작업	AWS CLI	AWS Tools for Windows PowerShell
하나 이상의 태그를 추가하거나 덮어씁니다.	TagResource	tag-resource	Add-BATResourceTag
하나 이상의 태그를 삭제합니다.	UntagResource	untag-resource	Remove-BATResourceTag
리소스에 대한 태그를 나열합니다.	ListTagsForResource	list-tags-for-resource	Get-BATResourceTag

다음 예제는 AWS CLI를 사용하여 리소스에 태그를 지정하거나 태그를 제거하는 방법을 보여줍니다.

예제 1: 기존 리소스에 태그 지정

다음 명령은 기존 리소스에 태그를 지정합니다.

aws batch tag-resource --resource-arn resource_ARN --tags team=devs

예제 2: 기존 리소스에서 태그 제거

다음 명령은 기존 리소스에서 태그를 삭제합니다.

aws batch untag-resource --resource-arn resource_ARN --tag-keys tag_key

예제 3: 리소스의 태그 목록 조회

다음 명령은 기존 리소스와 연결된 태그를 나열합니다.

aws batch list-tags-for-resource --resource-arn resource_ARN

일부 리소스 생성 작업에서는 리소스를 생성할 때 태그를 지정할 수 있습니다. 다음 태스크는 생성 시 태그 지정을 지원합니다.

태스크	API 작업	AWS CLI	AWS Tools for Windows PowerShell
컴퓨팅 환경 생성	CreateComputeEnvironment	create-compute-environment	New-BATComputeEnvironment
작업 대기열 생성	CreateJobQueue	create-job-queue	New-BATJobQueue
예약 정책 생성	CreateSchedulingPolicy	create-scheduling-policy	New-BATSchedulingPolicy
작업 정의 등록	RegisterJobDefinition	register-task-definition	Register-BATJobDefinition
작업 제출	SubmitJob	submit-job	Submit-BATJob