# Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 엔드포인트 버전 4
<a name="task-metadata-endpoint-v4-fargate"></a>

**중요**  
Amazon EC2 인스턴스에서 호스팅된 Amazon ECS 작업을 사용하는 경우 [Amazon ECS 작업 메타데이터 엔드포인트](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint.html)를 참조하세요.

Fargate 플랫폼 버전 `1.4.0`부터 `ECS_CONTAINER_METADATA_URI_V4`라는 환경 변수가 태스크의 각 컨테이너에 주입됩니다. 작업 메타데이터 엔드포인트 버전 4를 쿼리하면 다양한 작업 메타데이터와 [Docker 통계](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)를 작업에 사용할 수 있습니다.

작업 메타데이터 엔드포인트 버전 4는 버전 3 엔드포인트와 유사하지만 컨테이너 및 작업에 대한 추가 네트워크 메타데이터를 제공합니다. `/stats` 엔드포인트를 쿼리할 때도 추가 네트워크 지표를 사용할 수 있습니다.

작업 메타데이터 엔드포인트는 기본적으로 플랫폼 버전 `1.4.0` 이상을 사용하는 AWS Fargate에서 실행되는 모든 Amazon ECS 작업에 대해 켜집니다.

**참고**  
나중에 새 태스크 메타데이터 엔드포인트 버전을 생성할 필요가 없도록 버전 4 출력에 메타데이터를 추가할 수 있습니다. 기존 메타데이터를 제거하거나 메타데이터 필드 이름을 변경하지 않습니다.

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

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

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

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

`${ECS_CONTAINER_METADATA_URI_V4}/stats`  
이 경로는 Docker 컨테이너에 대한 Docker 통계를 반환합니다. 반환된 각 통계에 대한 자세한 내용은 Docker API 설명서의 [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)를 참조하세요.  
AWS Fargate의 Amazon ECS 태스크는 컨테이너 통계를 반환하기 전에 \~1초 동안 컨테이너를 실행해야 합니다.

`${ECS_CONTAINER_METADATA_URI_V4}/task/stats`  
이 경로는 태스크와 연결된 모든 컨테이너에 대한 Docker 통계를 반환합니다. 반환된 각 통계에 대한 자세한 내용은 Docker API 설명서의 [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)를 참조하세요.  
AWS Fargate의 Amazon ECS 태스크는 컨테이너 통계를 반환하기 전에 \~1초 동안 컨테이너를 실행해야 합니다.