

# Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 v3 JSON 응답
<a name="task-metadata-endpoint-v3-fargate-response"></a>

다음 정보가 태스크 메타데이터 엔드포인트(`${ECS_CONTAINER_METADATA_URI}/task`) JSON 응답에서 반환됩니다.

`Cluster`  
태스크가 속한 Amazon ECS 클러스터의 Amazon 리소스 이름(ARN) 또는 약어입니다.

`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 태스크에만 사용할 수 있습니다.

`Containers`  
태스크와 연결된 각 컨테이너에 대한 컨테이너 메타데이터의 목록입니다.    
`DockerId`  
컨테이너의 Docker ID입니다.  
`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 컨테이너 에이전트가 내부 작업 리소스 프로비저닝에 사용하는 기타 컨테이너 유형은 무시할 수 있습니다.  
`Networks`  
컨테이너에 대한 네트워크 정보(예: 네트워크 모드 및 IP 주소)입니다. 네트워크 정보가 정의되지 않은 경우 이 파라미터가 생략됩니다.

`ClockDrift`  
기준 시간과 시스템 시간의 차이에 대한 정보입니다. 이는 Linux 운영 체제에 적용됩니다. 이 기능은 Amazon Time Sync Service를 사용하여 클럭 정확도를 측정하고 컨테이너에 대한 클록 오류 범위를 제공합니다. 자세한 내용은 *Amazon EC2 Linux용 사용 설명서*의 [Linux 인스턴스에 대한 시간 설정](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html)을 참조하세요.    
`ReferenceTime`  
클록 정확도의 기초입니다. Amazon ECS는 NTP를 통해 협정 세계시(UTC) 글로벌 표준을 사용합니다(예: `2021-09-07T16:57:44Z`).  
`ClockErrorBound`  
UTC에 대한 오프셋으로 정의되는 클록 오류 측정값입니다. 이 오류는 기준 시간과 시스템 시간의 차이(밀리초)입니다.  
`ClockSynchronizationStatus`  
시스템 시간과 기준 시간 간의 가장 최근 동기화 시도가 성공했는지를 나타냅니다.  
유효 값은 `SYNCHRONIZED` 및 ` NOT_SYNCHRONIZED`입니다.

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