# EC2의 Amazon ECS 작업에 대해 사용 가능한 작업 메타데이터 Amazon ECS 컨테이너 에이전트는 다양한 태스크 메타데이터와 [Docker 통계](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)를 조회하는 메서드를 제공합니다. 이를 일컬어 태스크 메타데이터 엔드포인트라고 합니다. 다음과 같은 버전을 사용할 수 있습니다. + 태스크 메타데이터 엔드포인트 버전 4 – 다양한 메타데이터와 Docker 통계를 컨테이너에 제공합니다. 네트워크 속도 데이터도 제공할 수 있습니다. Amazon ECS 컨테이너 에이전트 버전 `1.39.0` 이상에서 실행되는 Amazon EC2 Linux 인스턴스에서 시작된 Amazon ECS 태스크에 제공됩니다. `awsvpc` 네트워크 모드를 사용하는 Amazon EC2 Windows 인스턴스의 경우, Amazon ECS 컨테이너 에이전트 버전이 `1.54.0` 이상이어야 합니다. 자세한 정보는 [Amazon ECS 작업 메타데이터 엔드포인트 버전 4](task-metadata-endpoint-v4.md)을 참조하세요. + 태스크 메타데이터 엔드포인트 버전 3 – 다양한 메타데이터 및 Docker 통계를 컨테이너에 제공합니다. Amazon ECS 컨테이너 에이전트 버전 `1.21.0` 이상에서 실행되는 Amazon EC2 Linux 인스턴스에서 시작된 Amazon ECS 태스크에 제공됩니다. `awsvpc` 네트워크 모드를 사용하는 Amazon EC2 Windows 인스턴스의 경우, Amazon ECS 컨테이너 에이전트 버전이 `1.54.0` 이상이어야 합니다. 자세한 정보는 [Amazon ECS 작업 메타데이터 엔드포인트 버전 3](task-metadata-endpoint-v3.md)을 참조하세요. + 태스크 메타데이터 엔드포인트 버전 2 - Amazon ECS 컨테이너 에이전트 버전 `1.17.0` 이상에서 실행되는 Amazon EC2 Linux 인스턴스에서 시작된 Amazon ECS 태스크에 제공됩니다. `awsvpc` 네트워크 모드를 사용하는 Amazon EC2 Windows 인스턴스의 경우, Amazon ECS 컨테이너 에이전트 버전이 `1.54.0` 이상이어야 합니다. 자세한 내용은 [Amazon ECS 작업 메타데이터 엔드포인트 버전 2](task-metadata-endpoint-v2.md) 섹션을 참조하세요. Amazon ECS 태스크가 Amazon EC2에서 호스팅되거나 태스크가 `host` 네트워크 모드를 사용하고 Amazon ECS 관리형 인스턴스에서 호스팅되는 경우 [인스턴스 메타데이터 서비스(IMDS) 엔드포인트](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html)를 사용하여 태스크 호스트 메타데이터에 액세스할 수도 있습니다. 다음 명령을 작업을 호스팅하는 인스턴스 내에서 실행하면 호스트 인스턴스의 ID가 나열됩니다. ``` curl http://169.254.169.254/latest/meta-data/{{instance-id}} ``` Amazon ECS 태스크가 Amazon EC2에서 IPv6 전용 구성으로 호스팅되는 경우 IPv6 IMDS 엔드포인트를 사용하여 태스크 호스트 메타데이터에 액세스할 수 있습니다. 작업을 호스팅하는 인스턴스 내에서 다음 명령을 실행하면 IPv6에서 호스트 인스턴스의 ID가 나열됩니다. ``` curl http://[fd00:ec2::254]/latest/meta-data/{{instance-id}} ``` IPv6 IMDS 엔드포인트에 액세스하려면 컨테이너 인스턴스에서 IPv6 IMDS 엔드포인트를 활성화하고 선택한 SDK의 IMDS 자격 증명 제공자를 사용하여 메타데이터 서비스 엔드포인트 모드를 `IPv6`으로 구성합니다. 컨테이너 인스턴스에 대해 IPv6 IMDS 엔드포인트 활성화에 대한 자세한 내용은 *Amazon EC2 사용 설명서*의 [인스턴스 메타데이터 서비스 옵션 구성](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html)을 참조하세요. SDK용 IMDS 자격 증명 공급자에 대한 자세한 내용은 *AWS SDK 및 도구 참조 안내서*의 [IMDS 자격 증명 제공자](https://docs.aws.amazon.com/sdkref/latest/guide/feature-imds-credentials.html)를 참조하세요. **참고** `awsvpcTrunking` 계정 설정이 활성화된 경우 IPv6 IMDS 엔드포인트에 액세스할 수 없습니다. `awsvpcTrunking`이 활성화된 경우 컨테이너 인스턴스 IAM 역할 자격 증명에 액세스하려면 대신 태스크 IAM 역할을 사용할 수 있습니다. 태스크 IAM 역할에 대한 자세한 내용은 [Amazon ECS 작업 IAM 역할](task-iam-roles.md) 섹션을 참조하세요. 엔드포인트에서 얻을 수 있는 정보는 `{{instance-id}}`와 같은 범주로 구분됩니다. 엔드포인트를 사용하여 얻을 수 있는 호스트 인스턴스 메타데이터의 다양한 범주에 대한 자세한 내용은 [인스턴스 메타데이터 범주](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html#instancedata-data-categories)를 참조하세요.