Amazon ECS 태스크 메타데이터 V4 JSON 응답

다음 정보는 태스크 메타데이터 엔드포인트(${ECS_CONTAINER_METADATA_URI_V4}/task) JSON 응답에서 반환돼요. 이는 태스크에 연결된 각 컨테이너의 메타데이터와 함께 태스크와 관련된 메타데이터를 포함합니다.

출처: 문서

본문

Cluster — 태스크가 속한 Amazon ECS 클러스터의 Amazon Resource Name(ARN) 또는 짧은 이름.
ServiceName — 태스크가 속한 서비스의 이름. 태스크가 서비스와 연결되어 있으면 ServiceName이 Amazon EC2 및 Amazon ECS Anywhere 컨테이너 인스턴스에 나타납니다. 참고: ServiceName 메타데이터는 Amazon ECS 컨테이너 에이전트 버전 1.63.1 이상을 사용할 때만 포함됩니다.
VPCID — Amazon EC2 컨테이너 인스턴스의 VPC ID. 이 필드는 Amazon EC2 인스턴스에만 나타나요. 참고: VPCID 메타데이터는 Amazon ECS 컨테이너 에이전트 버전 1.63.1 이상을 사용할 때만 포함됩니다.
TaskARN — 컨테이너가 속한 태스크의 Amazon Resource Name(ARN).
Family — 태스크의 Amazon ECS 태스크 정의 패밀리(family).
Revision — 태스크의 Amazon ECS 태스크 정의 리비전.
DesiredStatus — Amazon ECS가 제공하는 태스크의 원하는 상태(desired status).
KnownStatus — Amazon ECS가 제공하는 태스크의 알려진 상태(known status).
Limits — 태스크 수준에서 지정된 리소스 제한. 예를 들어 CPU(vCPU 단위)와 메모리. 리소스 제한이 정의되지 않으면 이 파라미터는 생략됩니다.
PullStartedAt — 첫 컨테이너 이미지 풀이 시작된 타임스탬프.
PullStoppedAt — 마지막 컨테이너 이미지 풀이 완료된 타임스탬프.
AvailabilityZone — 태스크가 있는 가용 영역. 참고: AvailabilityZone 메타데이터는 플랫폼 버전 1.4 이상(Linux) 또는 1.0.0(Windows)을 사용하는 Fargate 태스크에서만 사용할 수 있습니다.
LaunchType — 태스크가 사용하는 런치 타입. 클러스터 용량 공급자를 사용할 때 이는 태스크가 Fargate 또는 EC2 인프라를 사용하는지 나타냅니다. 참고: LaunchType 메타데이터는 Amazon ECS Linux 컨테이너 에이전트 버전 1.45.0 이상(Linux) 또는 1.0.0 이상(Windows)을 사용할 때만 포함됩니다.
Containers — 태스크와 연결된 각 컨테이너의 컨테이너 메타데이터 목록.

각 컨테이너에 대한 메타데이터:

DockerId — 컨테이너의 Docker ID. Fargate를 사용할 때 id는 32자리 16진수 뒤에 10자리 숫자가 붙는 형태입니다.
Name — 태스크 정의에 지정된 컨테이너의 이름.
DockerName — Docker에 제공된 컨테이너 이름. Amazon ECS 컨테이너 에이전트는 단일 인스턴스에서 같은 태스크 정의의 여러 복사본이 실행될 때 이름 충돌을 피하기 위해 컨테이너의 고유한 이름을 생성해요.
Image — 컨테이너의 이미지.
ImageID — 이미지 매니페스트의 SHA-256 다이제스트. repository-url/image@sha256:digest 형식으로 이미지를 풀하는 데 사용할 수 있는 다이제스트입니다.
Ports — 컨테이너에 노출된 포트. 노출된 포트가 없으면 이 파라미터는 생략됩니다.
Labels — 컨테이너에 적용된 레이블. 적용된 레이블이 없으면 이 파라미터는 생략됩니다.
DesiredStatus — Amazon ECS가 제공하는 컨테이너의 원하는 상태.
KnownStatus — Amazon ECS가 제공하는 컨테이너의 알려진 상태.
ExitCode — 컨테이너의 종료 코드. 컨테이너가 종료되지 않았으면 이 파라미터는 생략됩니다.
Limits — 컨테이너 수준에서 지정된 리소스 제한. 예를 들어 CPU(CPU 단위로 표시)와 메모리. 리소스 제한이 정의되지 않으면 이 파라미터는 생략됩니다.
CreatedAt — 컨테이너가 만들어진 타임스탬프. 컨테이너가 아직 만들어지지 않았으면 이 파라미터는 생략됩니다.
StartedAt — 컨테이너가 시작된 타임스탬프. 컨테이너가 아직 시작되지 않았으면 이 파라미터는 생략됩니다.
FinishedAt — 컨테이너가 중지된 타임스탬프. 컨테이너가 아직 중지되지 않았으면 이 파라미터는 생략됩니다.
Type — 컨테이너의 유형. 태스크 정의에 지정된 컨테이너는 NORMAL 유형입니다. Amazon ECS 컨테이너 에이전트가 내부 태스크 리소스 프로비저닝에 사용하는 다른 컨테이너 유형은 무시해도 돼요.
LogDriver — 컨테이너가 사용하는 로그 드라이버. 참고: LogDriver 메타데이터는 Amazon ECS Linux 컨테이너 에이전트 버전 1.45.0 이상을 사용할 때만 포함됩니다.
LogOptions — 컨테이너에 정의된 로그 드라이버 옵션. 참고: LogOptions 메타데이터는 Amazon ECS Linux 컨테이너 에이전트 버전 1.45.0 이상을 사용할 때만 포함됩니다.
ContainerARN — 컨테이너의 Amazon Resource Name(ARN). 참고: ContainerARN 메타데이터는 Amazon ECS Linux 컨테이너 에이전트 버전 1.45.0 이상을 사용할 때만 포함됩니다.
Networks — 네트워크 모드와 IP 주소 같은 컨테이너의 네트워크 정보. 네트워크 정보가 정의되지 않으면 이 파라미터는 생략됩니다.
RestartCount — 컨테이너가 다시 시작된 횟수. 참고: RestartCount 메타데이터는 컨테이너에 대해 재시작 정책이 활성화된 경우에만 포함됩니다. 자세한 내용은 컨테이너 재시작 정책으로 Amazon ECS 태스크의 개별 컨테이너 재시작(Restart individual containers in Amazon ECS tasks with container restart policies)을 참고하세요.
ExecutionStoppedAt — 태스크의 DesiredStatus가 STOPPED로 이동한 타임스탬프. 이는 essential 컨테이너가 STOPPED로 이동할 때 발생합니다.