비용 추적 및 규정 준수를 위해 Amazon ECS 리소스에 태그를 지정하려면 어떻게 해야 합니까?
Amazon Elastic Container Service(Amazon ECS) 리소스에 태그를 지정하여 비용과 규정 준수를 추적하고 싶습니다.
간략한 설명
태그를 사용하여 Amazon ECS 리소스에 사용자 지정 메타데이터를 할당합니다.
해결 방법
참고: AWS Command Line Interface(AWS CLI) 명령을 실행할 때 오류가 발생하면 AWS CLI의 오류 해결을 참조하십시오. 또한 최신 AWS CLI 버전을 사용하고 있는지 확인하십시오.
계정 수준에서 리소스 태그 지정 권한 활성화
클러스터 또는 서비스를 생성할 때 태그를 사용하고 만들려면 ecs:TagResource 권한이 있어야 합니다. 또한 리소스를 생성하는 데 필요한 작업(예: ecsCreateCluster)에 대한 권한도 있어야 합니다.
AWS 계정 수준에서 현재 태그 지정 권한 부여 상태를 보려면 다음 list-account-settings 명령을 실행합니다.
aws ecs list-account-settings --effective-settings
명령 출력에서 태그 지정 권한을 활성화했는지 확인합니다. 태그 지정 권한을 활성화하지 않은 경우 다음 put-account-setting-default 명령을 실행하여 활성화합니다.
aws ecs put-account-setting-default --name tagResourceAuthorization --value on --region regionname
참고: regionname을 AWS 리전으로 바꾸십시오.
올바른 ARN 형식 사용
Amazon ECS 리소스에 태그를 지정하려면 새 ARN 및 ID 형식을 사용해야 합니다. Amazon ECS 배포를 새 ARN 및 리소스 ID 형식으로 마이그레이션해야 할 수 있습니다.
IAM 엔터티에 필요한 권한이 있는지 확인하고 태그 제한 확인
Amazon ECS 서비스에 태그를 추가할 수 없는 경우 AWS Identity and Access Management(IAM) 엔터티에 필요한 권한이 있는지 검증하십시오. 자세한 내용은 Amazon ECS 작업의 태그 지정 문제를 해결하려면 어떻게 해야 합니까?에서 IAM 엔터티에 필요한 권한이 있는지 확인하고 태그 제한 확인 섹션을 참조하십시오.
Amazon ECS 관리형 태그를 청구에 사용
enableECSManagedTags 파라미터 활성화
Amazon ECS 관리형 태그를 사용하면 Amazon ECS가 클러스터 정보, 작업 정의 또는 서비스 태그로 새로 시작된 모든 작업에 자동으로 태그를 지정합니다. 또한 Amazon ECS는 작업에 연결된 Amazon Elastic Block Store(Amazon EBS) 볼륨에 태그를 지정합니다. PropagateTags 파라미터는 기본적으로 활성화되지 않습니다. 태그를 작업 정의 또는 서비스에서 작업으로 복사하려면 파라미터를 활성화합니다.
서비스를 생성할 때 enableECSManagedTags 파라미터를 활성화하려면 다음 create-service 명령을 실행합니다.
aws ecs create-service \ --cluster clustername \ --service-name servicename \ --task-definition taskdefinitionname \ --desired-count 1 \ --launch-type FARGATE \ --enable-ecs-managed-tags \ --network-configuration "awsvpcConfiguration={subnets=[subnet-ABCD],securityGroups=[sg-ABC],assignPublicIp=ENABLED}"
참고: clustername을 클러스터 이름으로, servicename을 서비스 이름으로, taskdefinitionname을 작업 정의 이름으로 바꾸십시오. 네트워크 구성을 --network-configuration 옵션에 추가합니다.
작업을 실행할 때 enableECSManagedTags 파라미터를 활성화하려면 다음 run-task 명령을 실행합니다.
aws ecs run-task \ --cluster clustername \ --task-definition taskdefinitionname \ --launch-type FARGATE \ --enable-ecs-managed-tags \ --network-configuration "awsvpcConfiguration={subnets=[subnet-ABC],securityGroups=[sg-ABC]}"
참고: clustername을 클러스터 이름으로 바꾸고 taskdefinitionname을 작업 정의 이름으로 바꾸십시오. 네트워크 구성을 --network-configuration 옵션에 추가합니다.
Amazon ECS 관리형 태그 활성화
Amazon ECS 콘솔 또는 AWS CLI를 사용하여 관리형 태그를 활성화할 수 있습니다.
Amazon ECS 콘솔
다음 단계를 완료하십시오.
- Amazon ECS 콘솔을 엽니다.
- Amazon ECS 리소스의 리전을 선택합니다.
- 탐색 창에서 Task definitions(작업 정의)를 선택합니다.
- 리소스 목록에서 작업 정의를 선택한 다음, Actions(작업)를 선택합니다.
- Create service(서비스 생성) 또는 Run task(작업 실행)를 선택합니다.
- Task tagging configuration(작업 태그 지정 구성)에서 Enable ECS managed tags(ECS 관리형 태그 활성화)를 선택합니다.
참고: 작업 정의 또는 서비스의 태그를 작업에 복사하려면 태그 전파 시작에서 리소스를 선택합니다. 기본적으로 PropagateTags 파라미터는 전파하지 않음으로 설정됩니다.
AWS CLI
다음 update-service 명령을 실행합니다.
aws ecs update-service --cluster clustername --service servicename --enable-ecs-managed-tags --force-new-deployment
참고: servicename을 서비스 이름으로, clustername을 클러스터 이름으로 바꾸십시오.
태그 전파 설정
태그 전파는 기본적으로 비활성화됩니다. 특정 서비스에서 PropagateTags를 활성화했는지 확인하려면 다음 describe-services 명령을 실행합니다.
aws ecs describe-services --services servicename --cluster clustername --region region --query 'services[*].propagateTags' --output text
참고: servicename을 서비스 이름으로, clustername을 클러스터 이름으로, region을 해당 리전으로 바꾸십시오.
서비스를 생성할 때 태그 전파를 추가하려면 다음 create-service 명령을 실행합니다.
aws ecs create-service \ --cluster clustername \ --service-name servicename \ --task-definition taskdefinitionname \ --desired-count 1 \ --launch-type FARGATE \ --enable-ecs-managed-tags \ --propagate-tags TASK_DEFINITION-SERVICE \ --network-configuration "awsvpcConfiguration={subnets=[subnet-ABCD],securityGroups=[sg-ABC],assignPublicIp=ENABLED}"
참고: clustername을 클러스터 이름으로, servicename을 서비스 이름으로, taskdefinitionname을 작업 정의로 바꾸십시오. 또한 작업을 전파하려는 위치에 따라 FARGATE를 시작 유형으로 바꾸고 TASK_DEFINITION-SERVICE를 TASK_DEFINITION 또는 SERVICE로 바꾸십시오. 네트워크 구성을 --network-configuration 옵션에 추가합니다.
작업을 실행할 때 태그 전파를 추가하려면 다음 run-task 명령을 실행합니다.
aws ecs run-task \ --cluster clustername \ --task-definition taskdefinitionname \ --launch-type FARGATE \ --enable-ecs-managed-tags \ --propagate-tags TASK_DEFINITION-SERVICE \ --network-configuration "awsvpcConfiguration={subnets=[subnet-ABC],securityGroups=[sg-ABC]}"
참고: clustername을 클러스터 이름으로 바꾸고 taskdefinitionname을 작업 정의로 바꾸십시오. 또한 작업을 전파하려는 위치에 따라 FARGATE를 시작 유형으로 바꾸고 TASK_DEFINITION-SERVICE를 TASK_DEFINITION 또는 SERVICE로 바꾸십시오. 네트워크 구성을 --network-configuration 옵션에 추가합니다.
기존 서비스에 태그 전파를 추가하려면 다음 update-service 명령을 실행합니다.
aws ecs update-service --cluster clustername --service servicename --propagate-tags Task_definition-service --force-new-deployment
참고: clustername을 클러스터 이름으로, servicename을 서비스 이름으로, task_definition-service을 전파하고자 하는 위치로 바꾸십시오.
결제 보고서에 표시되도록 비용 할당 태그를 활성화해야 합니다.
참고: 태그가 활성화되는 데 최대 24시간이 걸릴 수 있습니다.
관련 정보
- 언어
- 한국어

This article was reviewed and updated on 2026-04-09.
관련 콘텐츠
AWS 공식업데이트됨 2년 전