# Amazon ECS 작업 메타데이터 V4 JSON 응답
<a name="task-metadata-endpoint-v4-response"></a>

다음 정보가 태스크 메타데이터 엔드포인트(`${ECS_CONTAINER_METADATA_URI_V4}/task`) JSON 응답에서 반환됩니다. 여기에는 태스크 내 각 컨테이너의 메타데이터와 해당 태스크와 연결된 메타데이터가 포함됩니다.

`Cluster`  
태스크가 속한 Amazon ECS 클러스터의 Amazon 리소스 이름(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 리소스 이름(ARN)입니다.

`Family`  
태스크에 대한 Amazon ECS 태스크 정의의 패밀리입니다.

`Revision`  
작업에 대한 Amazon ECS 태스크 정의의 개정입니다.

`DesiredStatus`  
Amazon ECS의 태스크에 대해 원하는 상태입니다.

`KnownStatus`  
Amazon ECS의 태스크에 대해 알려진 상태입니다.

`Limits`  
작업 수준에서 지정된 리소스 제한입니다(예: CPU(vCPU로 표시) 및 메모리). 리소스 제한이 정의되지 않은 경우 이 파라미터가 생략됩니다.

`PullStartedAt`  
첫 번째 컨테이너 이미지 풀이 시작된 시간에 대한 타임스탬프입니다.

`PullStoppedAt`  
마지막 컨테이너 이미지 풀이 완료된 시간에 대한 타임스탬프입니다.

`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 리소스 이름(ARN)입니다.  
이 `ContainerARN` 메타데이터는 Amazon ECS Linux 컨테이너 버전 `1.45.0` 이상을 사용할 때만 포함됩니다.  
`Networks`  
컨테이너에 대한 네트워크 정보(예: 네트워크 모드 및 IP 주소)입니다. 네트워크 정보가 정의되지 않은 경우 이 파라미터가 생략됩니다.  
`RestartCount`  
컨테이너가 재시작된 횟수입니다.  
`RestartCount` 메타데이터는 컨테이너에 대해 재시작 정책이 활성화된 경우에만 포함됩니다. 자세한 내용은 [컨테이너 재시작 정책이 있는 Amazon ECS 작업의 개별 컨테이너 재시작](container-restart-policy.md) 섹션을 참조하세요.

`ExecutionStoppedAt`  
태스크의 `DesiredStatus`가 `STOPPED`로 이동한 시간에 대한 타임스탬프입니다. 이 동작은 필수 컨테이너가 `STOPPED`로 이동할 때 발생합니다.