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

다음 메타데이터가 작업 메타데이터 엔드포인트(`${ECS_CONTAINER_METADATA_URI_V4}/task`) JSON 응답에서 반환됩니다.

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

`ServiceName`  
태스크가 속한 서비스의 이름입니다. 서비스와 연결된 Fargate 태스크에 대해 ServiceName이 표시됩니다.

`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)을 사용할 때만 포함됩니다.

`EphemeralStorageMetrics`  
이 작업의 임시 스토리지에 대한 예약된 크기와 현재 사용량입니다.  
Fargate는 디스크 스페이스를 예약합니다. Fargate에서만 사용됩니다. 이에 대한 요금은 청구되지 않습니다. 이러한 지표에는 표시되지 않습니다. 그러나 `df` 등의 다른 도구에서는 이 추가 스토리지를 볼 수 있습니다.  
`Utilized`  
이 작업의 현재 임시 스토리지 사용량(MiB)입니다.  
`Reserved`  
이 작업의 예약된 임시 스토리지(MiB)입니다. 임시 스토리지의 크기는 실행 중인 작업에서 변경할 수 없습니다. 작업 정의에서 `ephermalStorage` 객체를 지정하여 임시 스토리지의 양을 변경할 수 있습니다. `ephermalStorage`는 MiB가 아닌 GiB 단위로 지정됩니다. `ephermalStorage` 및 `EphemeralStorageMetrics`는 Fargate Linux 플랫폼 버전 1.4.0 이상에서만 사용할 수 있습니다.

`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 주소)입니다. 네트워크 정보가 정의되지 않은 경우 이 파라미터가 생략됩니다.  
`Snapshotter`  
containerd가 이 컨테이너 이미지를 다운로드하는 사용한 snapshotter입니다. 유효한 값은 기본값인 `overlayfs` 및 SOCI 인덱스로 지연 로드할 때 사용되는 `soci`입니다. 이 파라미터는 Linux 플랫폼 버전 `1.4.0`에서 실행되는 작업에만 사용할 수 있습니다.  
`RestartCount`  
컨테이너가 재시작된 횟수입니다.  
`RestartCount` 메타데이터는 컨테이너에 대해 재시작 정책이 활성화된 경우에만 포함됩니다. 자세한 내용은 [컨테이너 재시작 정책이 있는 Amazon ECS 작업의 개별 컨테이너 재시작](container-restart-policy.md) 섹션을 참조하세요.

`ClockDrift`  
기준 시간과 시스템 시간의 차이에 대한 정보입니다. 이 기능은 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`로 이동할 때 발생합니다.