View a markdown version of this page

GetJob - Amazon Location Service
사용 사례요청 이해응답 이해

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

GetJob

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

자세한 내용은 Amazon Location Service API 참조의 GetJob을 참조하세요.

이 API에 대한 요청, 응답 및 CLI 명령의 예는 작업 진행 상황을 모니터링하는 방법을 참조하세요.

사용 사례

  • 작업 상태 및 진행 상황 모니터링: 보류 중, 실행 중 및 완료 상태까지의 작업 수명 주기 진행 상황을 추적하여 처리가 완료되고 결과를 다운로드할 수 있는 시기를 결정합니다. 워크플로 관리 및 보고를 위한 작업 상태를 모니터링합니다.

  • 오류 진단: 처리 문제를 해결하기 위한 특정 오류 메시지 및 실패 이유를 포함하여 작업이 실패할 때 자세한 오류 정보를 검색합니다.

  • 구성 확인: 처리가 시작되기 전에 입력/출력 위치, 실행 역할 및 요청된 기능을 포함한 작업 구성 세부 정보를 확인합니다.

요청 이해

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

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

작업 식별

정보를 검색할 작업을 지정하는 필수 파라미터입니다.

  • JobId: 검색할 작업의 고유 식별자입니다. 패턴와 일치하는 1~100자여야 합니다[-._\w]+. 작업이 생성될 때 StartJob 작업에서 반환되는 것과 동일한 식별자입니다.

응답 이해

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: 문제 해결을 위한 추가 컨텍스트를 제공하는 사람이 읽을 수 있는 메시지 목록입니다.