# Amazon ECS 작업 메타데이터 엔드포인트 버전 3
<a name="task-metadata-endpoint-v3"></a>

**중요**  
태스크 메타데이터 버전 3 엔드포인트는 더 이상 능동적으로 관리되지 않습니다. 최신 메타데이터 엔드포인트 정보를 가져오려면 태스크 메타데이터 버전 4 엔드포인트를 업데이트하는 것이 좋습니다. 자세한 내용은 [Amazon ECS 작업 메타데이터 엔드포인트 버전 4](task-metadata-endpoint-v4.md) 섹션을 참조하세요.  
AWS Fargate에 호스팅된 Amazon ECS 작업을 사용하는 경우 [Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 엔드포인트 버전 3](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v3-fargate.html)을 참조하세요.

Amazon ECS 컨테이너 에이전트의 버전 1.21.0부터 에이전트는 `ECS_CONTAINER_METADATA_URI`라는 이름의 환경 변수를 작업의 각 컨테이너에 주입합니다. 태스크 메타데이터 버전 3 엔드포인트를 쿼리하면 다양한 태스크 메타데이터와 [Docker 통계](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)를 태스크에 사용할 수 있습니다. `bridge` 네트워크 모드를 사용하는 태스크의 경우 `/stats` 엔드포인트를 쿼리할 때 네트워크 지표를 사용할 수 있습니다.

태스크 메타데이터 엔드포인트 버전 3 기능은 기본적으로 플랫폼 버전 v1.3.0 이상에서 Fargate를 사용하는 태스크 및 EC2를 사용하면서 Amazon EC2 Linux 인프라(Amazon ECS 컨테이너 에이전트의 버전 1.21.0 이상에서 실행됨) 또는 Amazon EC2 Windows 인프라(Amazon ECS 컨테이너 에이전트의 버전 `1.54.0` 이상에서 실행됨)에서 시작되고 `awsvpc` 네트워크 모드를 사용하는 태스크에서 활성화됩니다. 자세한 내용은 [Amazon ECS Linux 컨테이너 인스턴스 관리](manage-linux.md) 섹션을 참조하세요.

에이전트를 최신 버전으로 업데이트하여 이전 버전의 컨테이너 인스턴스에서 이 기능에 대한 지원을 추가할 수 있습니다. 자세한 내용은 [Amazon ECS 컨테이너 에이전트 업데이트](ecs-agent-update.md) 섹션을 참조하세요.

**중요**  
Fargate 및 v1.3.0 이전 버전의 플랫폼을 사용하는 태스크의 경우 태스크 메타데이터 버전 2 엔드포인트가 지원됩니다. 자세한 내용은 [Amazon ECS 작업 메타데이터 엔드포인트 버전 2](task-metadata-endpoint-v2.md) 섹션을 참조하세요.

## 작업 메타데이터 엔드포인트 버전 3 경로
<a name="task-metadata-endpoint-v3-paths"></a>

다음의 태스크 메타데이터 엔드포인트를 컨테이너에 사용할 수 있습니다.

`${ECS_CONTAINER_METADATA_URI}`  
이 경로는 컨테이너에 대한 메타데이터 JSON을 반환합니다.

`${ECS_CONTAINER_METADATA_URI}/task`  
이 경로는 태스크와 연결된 모든 컨테이너의 컨테이너 ID 및 이름 목록을 포함하여 태스크에 대한 메타데이터 JSON을 반환합니다. 이 엔드포인트의 응답에 대한 자세한 내용은 [Amazon ECS 작업 메타데이터 v3 JSON 응답](task-metadata-endpoint-v3-response.md) 섹션을 참조하세요.

`${ECS_CONTAINER_METADATA_URI}/taskWithTags`  
이 경로는 `ListTagsForResource` API를 사용하여 검색할 수 있는 태스크와 컨테이너 인스턴스 태그 외에도 `/task` 엔드포인트에 포함된 태스크에 대한 메타데이터를 반환합니다.

`${ECS_CONTAINER_METADATA_URI}/stats`  
이 경로는 특정 Docker 컨테이너에 대한 Docker 통계 JSON을 반환합니다. 반환된 각 통계에 대한 자세한 내용은 Docker API 설명서의 [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)를 참조하세요.

`${ECS_CONTAINER_METADATA_URI}/task/stats`  
이 경로는 태스크와 연결된 모든 컨테이너에 대한 Docker 통계 JSON을 반환합니다. 반환된 각 통계에 대한 자세한 내용은 Docker API 설명서의 [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)를 참조하세요.