# Amazon ECS 관리형 인스턴스에 대한 태그
<a name="instance-details-tags-managed-instances"></a>

Amazon ECS 관리형 인스턴스는 비용 최적화에 사용할 수 있는 사용자 지정 태그 및 AWS에 의해 추가된 태그의 조합을 지원합니다. 결제에서 태그 사용에 대한 자세한 내용은 [결제에 태그 사용](ecs-using-tags.md#tag-resources-for-billing) 섹션을 참조하세요.

## AWS에서 추가한 태그
<a name="instance-details-tags-managed-instances-system"></a>

 AWS는 용량 공급자가 생성한 각 Amazon ECS 관리형 인스턴스에 다음 태그를 추가합니다.
+ Amazon ECS는 Amazon ECS 관리형 인스턴스에 예약 태그 `AmazonECSCreated` 및 `AmazonECSManaged`를 자동으로 추가합니다.
+ Amazon ECS는 각 인스턴스에 다음 시스템 태그를 추가합니다.
  + *키*가 `aws:ecs:clusterName`이고 *값*이 클러스터 이름으로 설정된 태그.
  + *키*가 `aws:ecs:capacityProviderName`이고 *값*이 용량 공급자 이름으로 설정된 태그.
  + Amazon ECS 관리형 인스턴스의 경우 *키*가 `aws:ecs:containerInstanceId`이고 *값*이 컨테이너 인스턴스 ID인 태그.
+ Amazon EC2는 값이 `ecs-managed-instances`인 `aws:ec2:managed-launch` 시스템 태그를 추가합니다. 또한 Amazon EC2는 관리형 인스턴스를 생성하는 데 사용된 시작 템플릿과 관리형 인스턴스가 속한 Amazon EC2 Fleet을 나타내는 시스템 태그를 추가합니다.

## 사용자 지정 태그
<a name="instance-details-tags-managed-instances-custom"></a>

용량 공급자에 태그를 추가하고 `propagateTags` 속성을 사용하여 태그 전파를 활성화함으로써 Amazon ECS 관리형 인스턴스에 사용자 지정 태그를 추가할 수 있습니다. 용량 공급자의 태그는 해당 용량 공급자가 시작하는 관리형 인스턴스로 전파됩니다.

다음 용량 공급자 정의 예제에서는 `propagateTags`에 대해 `CAPACITY_PROVIDER` 값을 사용하여 용량 공급자를 생성할 때 용량 공급자로부터 태그를 지정하고 전파하는 방법을 보여줍니다.

```
{
    "name": "my-cluster-managed-instances-cp",
    "cluster": "my-cluster",
     "tags": [
                {
                "key":"tag_key",
                "value":"tag_value"
                }
            ],
    "managedInstancesProvider": {
        "infrastructureRoleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole",
        "propagateTags": "CAPACITY_PROVIDER",
        "instanceLaunchTemplate": {
            "ec2InstanceProfileArn": "arn:aws:iam::123456789012:instance-profile/ecsInstanceProfile",
            "networkConfiguration": {
                "subnets": [
                    "subnet-abcdef01234567",
                    "subnet-bcdefa98765432"
                ],
                "securityGroups": [ 
                    "sg-0123456789abcdef"
                ]
            }
        }
    }
}
```

**참고**  
용량 공급자에 새 태그를 추가하면 새로 추가된 태그는 기존 인스턴스로 전파되지 않고 새로 생성된 인스턴스로 전파됩니다.
고객은 EC2 인스턴스에 직접 태그를 추가할 수 있지만 해당 태그는 용량 공급자로 다시 전파되지는 않습니다.
[기존 리소스에 태그 추가(AWS CLI)](tag-resources-console.md#tag-resources-api-sdk) 또는 [기존 리소스에 태그 추가(Amazon ECS 콘솔)](tag-resources-console.md#adding-or-deleting-tags)를 사용하여 용량 공급자에 태그를 지정하거나 태그를 해제할 수도 있습니다.

Amazon ECS 관리형 인스턴스 용량 공급자에 대한 자세한 내용은 [Amazon ECS 관리형 인스턴스 용량 공급자](managed-instances-capacity-providers-concept.md) 섹션을 참조하세요.