기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# GetJob
<a name="get-job-api"></a>

`GetJob` 작업은 현재 상태, 구성, 타임스탬프 및 오류 정보를 포함하여 특정 작업에 대한 정보를 검색합니다. 이 작업을 사용하여 작업 진행 상황을 모니터링하고 구성 세부 정보를 확인합니다. 완료된 작업의 경우 결과에 액세스하기 전에이 정보를 사용하여 처리 성공을 확인할 수 있습니다.

자세한 내용은 Amazon Location Service API 참조의 [GetJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_GetJob.html)을 참조하세요. ** 

이 API에 대한 요청, 응답 및 CLI 명령의 예는 [작업 진행 상황을 모니터링하는 방법을 참조하세요](https://docs.aws.amazon.com/location/latest/developerguide/monitoring-job-progress.html).

## 사용 사례
<a name="get-job-use-cases"></a>
+ **작업 상태 및 진행 상황 모니터링:** 보류 중, 실행 중 및 완료 상태까지의 작업 수명 주기 진행 상황을 추적하여 처리가 완료되고 결과를 다운로드할 수 있는 시기를 결정합니다. 워크플로 관리 및 보고를 위한 작업 상태를 모니터링합니다.
+ **오류 진단:** 처리 문제를 해결하기 위한 특정 오류 메시지 및 실패 이유를 포함하여 작업이 실패할 때 자세한 오류 정보를 검색합니다.
+ **구성 확인:** 처리가 시작되기 전에 입력/출력 위치, 실행 역할 및 요청된 기능을 포함한 작업 구성 세부 정보를 확인합니다.

## 요청 이해
<a name="get-job-request-parameters"></a>

이 `GetJob` 요청은 특정 작업에 대한 포괄적인 정보를 검색하는 데 단일 파라미터만 필요합니다. 이 간단한 요청 구조를 사용하면 작업 상태를 쉽게 모니터링하고 자세한 구성 및 처리 정보를 검색할 수 있습니다.

요청에는 다음 파라미터가 포함됩니다.

**작업 식별**  
정보를 검색할 작업을 지정하는 필수 파라미터입니다.  
+ `JobId`: 검색할 작업의 고유 식별자입니다. 패턴와 일치하는 1\~100자여야 합니다`[-._\w]+`. 작업이 생성될 때 `StartJob` 작업에서 반환되는 것과 동일한 식별자입니다.

## 응답 이해
<a name="get-job-response-details"></a>

`GetJob` 응답은 현재 상태, 전체 구성, 처리 타임스탬프 및 오류 정보를 포함하여 지정된 작업에 대한 정보를 제공합니다. 이 응답을 사용하여 작업 상태를 모니터링하고 발생할 수 있는 오류를 해결할 수 있습니다.

응답에는 다음 필드가 포함됩니다.

**작업 식별**  
고유 식별자 및 기본 작업 정보.  
+ `JobId`: 모니터링 및 관리 작업에 사용되는 고유한 작업 식별자입니다.
+ `JobArn`: 내에서 작업을 고유하게 식별하는 ARN입니다 AWS.
+ `Name`: 작업 생성 중에 지정된 경우 사람이 읽을 수 있는 작업 이름입니다.

**작업 상태 및 수명 주기**  
현재 작업 상태 및 처리 타임라인 정보입니다.  
+ `Status`: 처리 상태(보류 중, 실행 중, 완료됨, 실패, 취소 중 또는 취소됨)를 나타내는 현재 작업 상태입니다.
+ `CreatedAt`: ISO 8601 형식의 작업 생성 타임스탬프입니다.
+ `UpdatedAt`: ISO 8601 형식의 마지막 상태 업데이트 타임스탬프입니다.
+ `EndedAt`: ISO 8601 형식의 작업 완료 타임스탬프입니다. 터미널 상태의 작업에만 존재합니다.

**작업 구성**  
생성 중에 지정된 대로 작업 구성을 완료합니다.  
+ `Action`: 수행 중인 작업 유형입니다(현재`ValidateAddress`는 만 지원됨).
+ `ExecutionRoleArn`: 작업 실행 중에 Amazon S3 버킷에 액세스하는 데 사용되는 IAM 역할 ARN입니다.
+ `InputOptions`: Amazon S3 위치 및 데이터 형식을 포함한 입력 구성입니다.
+ `OutputOptions`: Amazon S3 대상 및 결과 형식을 포함한 출력 구성입니다.
+ `ActionOptions`: `Position` 또는와 같이 작업에 대해 요청된 선택적 추가 기능입니다`CountrySpecificAttributes`.

**오류 정보**  
작업이 실패하면 문제를 진단하고 해결하는 데 도움이 되는 오류 세부 정보가 응답에 포함됩니다.  
+ `Error`: 실패에 대한 세부 정보가 포함된 `JobError` 객체입니다. 이 객체에는 다음 필드가 포함됩니다.
  + `Code`: 실패 유형을 식별하는 오류 코드입니다.
  + `Messages`: 문제 해결을 위한 추가 컨텍스트를 제공하는 사람이 읽을 수 있는 메시지 목록입니다.