Amazon ECS 작업 메타데이터 엔드포인트 버전 3
중요
태스크 메타데이터 버전 3 엔드포인트는 더 이상 능동적으로 관리되지 않습니다. 최신 메타데이터 엔드포인트 정보를 가져오려면 태스크 메타데이터 버전 4 엔드포인트를 업데이트하는 것이 좋습니다. 자세한 내용은 Amazon ECS 작업 메타데이터 엔드포인트 버전 4 섹션을 참조하세요.
AWS Fargate에 호스팅된 Amazon ECS 작업을 사용하는 경우 Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 엔드포인트 버전 3을 참조하세요.
Amazon ECS 컨테이너 에이전트의 버전 1.21.0부터 에이전트는 ECS_CONTAINER_METADATA_URI라는 이름의 환경 변수를 작업의 각 컨테이너에 주입합니다. 태스크 메타데이터 버전 3 엔드포인트를 쿼리하면 다양한 태스크 메타데이터와 Docker 통계bridge 네트워크 모드를 사용하는 태스크의 경우 /stats 엔드포인트를 쿼리할 때 네트워크 지표를 사용할 수 있습니다.
태스크 메타데이터 엔드포인트 버전 3 기능은 기본적으로 플랫폼 버전 v1.3.0 이상에서 Fargate 시작 유형을 사용하는 태스크에서 사용할 수 있으며, EC2 시작 유형을 사용하면서 버전 1.21.0 이상의 Amazon EC2 컨테이너 에이전트를 실행하는 Amazon EC2 Linux 인프라 또는 Amazon ECS 컨테이너 에이전트 버전 1.54.0을 실행하고 awsvpc 네트워크 모드를 사용하는 Amazon ECS2 Windows 인프라에서 시작되는 태스크에도 사용할 수 있습니다. 자세한 내용은 Amazon ECS Linux 컨테이너 인스턴스 관리 섹션을 참조하세요.
에이전트를 최신 버전으로 업데이트하여 이전 버전의 컨테이너 인스턴스에서 이 기능에 대한 지원을 추가할 수 있습니다. 자세한 정보는 Amazon ECS 컨테이너 에이전트 업데이트을 참조하세요.
중요
Fargate 시작 유형 및 v1.3.0 이전 버전의 플랫폼을 사용하는 태스크의 경우 태스크 메타데이터 버전 2 엔드포인트가 지원됩니다. 자세한 정보는 Amazon ECS 작업 메타데이터 엔드포인트 버전 2을 참조하세요.
작업 메타데이터 엔드포인트 버전 3 경로
다음의 태스크 메타데이터 엔드포인트를 컨테이너에 사용할 수 있습니다.
${ECS_CONTAINER_METADATA_URI}-
이 경로는 컨테이너에 대한 메타데이터 JSON을 반환합니다.
${ECS_CONTAINER_METADATA_URI}/task-
이 경로는 태스크와 연결된 모든 컨테이너의 컨테이너 ID 및 이름 목록을 포함하여 태스크에 대한 메타데이터 JSON을 반환합니다. 이 엔드포인트의 응답에 대한 자세한 내용은 Amazon ECS 작업 메타데이터 v3 JSON 응답 섹션을 참조하세요.
${ECS_CONTAINER_METADATA_URI}/taskWithTags-
이 경로는
ListTagsForResourceAPI를 사용하여 검색할 수 있는 태스크와 컨테이너 인스턴스 태그 외에도/task엔드포인트에 포함된 태스크에 대한 메타데이터를 반환합니다. ${ECS_CONTAINER_METADATA_URI}/stats-
이 경로는 특정 Docker 컨테이너에 대한 Docker 통계 JSON을 반환합니다. 반환된 각 통계에 대한 자세한 내용은 Docker API 설명서의 ContainerStats
를 참조하세요. ${ECS_CONTAINER_METADATA_URI}/task/stats-
이 경로는 태스크와 연결된 모든 컨테이너에 대한 Docker 통계 JSON을 반환합니다. 반환된 각 통계에 대한 자세한 내용은 Docker API 설명서의 ContainerStats
를 참조하세요.
