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

# ListJobs
<a name="list-jobs-api"></a>

이 `ListJobs` 작업은 선택적 필터링 기능을 사용하여 페이지가 매겨진 작업 목록을 검색합니다. 작업 상태를 기준으로 필터링하고 반환되는 결과 수를 제어할 수 있습니다. 작업은 다음 토큰을 통한 페이지 매김을 지원하므로 대규모 작업 목록을 효율적으로 검색할 수 있습니다.

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

이 API에 대한 요청, 응답 및 CLI 명령의 예는 [작업 나열 방법을 참조하세요](https://docs.aws.amazon.com/location/latest/developerguide/listing-jobs.html).

## 사용 사례
<a name="list-jobs-use-cases"></a>
+ **작업 인벤토리 관리:** 모든 작업을 검색하여 처리 기록을 감사하고 검증 작업 전반의 리소스 사용률을 추적합니다.
+ **상태 기반 모니터링:** 상태별로 작업을 필터링하여 결과 검색을 위해 관심 또는 완료된 작업이 필요한 실행 중인 작업을 식별합니다.
+ **운영 보고:** 비즈니스 분석을 위한 작업 실행 패턴, 성공률 및 처리 볼륨에 대한 보고서를 생성합니다.
+ **문제 해결 및 디버깅:** 실패한 작업을 나열하여 처리 오류의 패턴을 식별하고 체계적인 문제를 진단합니다.

## 요청 이해
<a name="list-jobs-request-parameters"></a>

`ListJobs` 요청은 필터링 및 페이지 매김을 위한 선택적 파라미터를 수락합니다. 파라미터가 없으면 작업은 기본 페이지 매김이 있는 모든 작업을 반환합니다.

요청에는 다음과 같은 선택적 파라미터가 포함됩니다.

**필터링 옵션**  
반환된 작업 목록의 범위를 좁히는 선택적 파라미터입니다.  
+ `Filter`: 필터 기준이 포함된 객체입니다.
  + `JobStatus`: 현재 상태를 기준으로 작업을 필터링합니다. 유효한 값: `Pending`, `Running`, `Completed`, `Failed`, `Cancelling`또는 `Cancelled`.

**페이지 매김 제어**  
결과 페이지 매김을 제어하는 선택적 파라미터입니다.  
+ `MaxResults`: 단일 응답으로 반환할 최대 작업 수입니다. 이를 사용하여 대규모 결과 집합의 페이지 크기를 제어합니다.
+ `NextToken`: 이전 `ListJobs` 응답의 페이지 매김 토큰입니다. 다음 결과 페이지를 검색하려면이 토큰을 포함합니다.

## 응답 이해
<a name="list-jobs-response-details"></a>

`ListJobs` 응답은 각 작업에 대한 구성 및 상태 정보와 함께 작업 요약의 페이지 매김 목록을 제공합니다. 더 많은 결과를 사용할 수 있을 때 다음 토큰을 사용하여 추가 페이지를 검색합니다.

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

**작업 목록**  
필터 기준과 일치하는 작업 요약 배열입니다.  
+ `Entries`: 다음을 포함한 작업 요약 배열:
  + `Action`: 작업에서 수행하는 작업입니다.
  + `CreatedAt`: ISO 8601 형식의 작업 생성 타임스탬프입니다.
  + `EndedAt`: ISO 8601 형식의 작업 완료 타임스탬프입니다. 터미널 상태(완료됨, 실패 또는 취소됨)의 작업에만 표시됩니다.
  + `ExecutionRoleArn`: 실행에 사용되는 IAM 역할입니다.
  + `InputOptions`: 입력 구성 객체입니다.
  + `JobArn`: 작업의 Amazon 리소스 이름(ARN)입니다.
  + `JobId`: 고유한 작업 식별자입니다.
  + `Name`: 생성 중에 제공된 경우 작업 이름입니다.
  + `OutputOptions`: 출력 구성 객체입니다.
  + `Status`: 현재 작업 상태입니다.
  + `UpdatedAt`: ISO 8601 형식의 마지막 업데이트 타임스탬프입니다.
  + `ActionOptions`: 필요한 경우 추가 기능이 요청되었습니다.

**페이지 매김 토큰**  
추가 결과를 검색하기 위한 토큰입니다.  
+ `NextToken`: 다음 결과 페이지를 검색하기 위한 다음 `ListJobs` 요청에 포함할 토큰입니다. 이 필드는 더 많은 결과를 사용할 수 있는 경우에만 표시됩니다. 이 필드가 없으면 마지막 페이지를 검색했음을 나타냅니다.

**참고**  
결과는 페이지 간에 일관된 순서를 유지합니다. 후속 요청에서 각 응답`NextToken`의를 사용하여 결과의 모든 페이지를 반복합니다.