기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ListJobs
이 ListJobs 작업은 선택적 필터링 기능을 사용하여 페이지가 매겨진 작업 목록을 검색합니다. 작업 상태를 기준으로 필터링하고 반환되는 결과 수를 제어할 수 있습니다. 작업은 다음 토큰을 통한 페이지 매김을 지원하므로 대규모 작업 목록을 효율적으로 검색할 수 있습니다.
자세한 내용은 Amazon Location Service API 참조의 ListJobs를 참조하세요.
이 API에 대한 요청, 응답 및 CLI 명령의 예는 작업 나열 방법을 참조하세요.
사용 사례
-
작업 인벤토리 관리: 모든 작업을 검색하여 처리 기록을 감사하고 검증 작업 전반의 리소스 사용률을 추적합니다.
-
상태 기반 모니터링: 상태별로 작업을 필터링하여 결과 검색을 위해 관심 또는 완료된 작업이 필요한 실행 중인 작업을 식별합니다.
-
운영 보고: 비즈니스 분석을 위한 작업 실행 패턴, 성공률 및 처리 볼륨에 대한 보고서를 생성합니다.
-
문제 해결 및 디버깅: 실패한 작업을 나열하여 처리 오류의 패턴을 식별하고 체계적인 문제를 진단합니다.
요청 이해
ListJobs 요청은 필터링 및 페이지 매김을 위한 선택적 파라미터를 수락합니다. 파라미터가 없으면 작업은 기본 페이지 매김이 있는 모든 작업을 반환합니다.
요청에는 다음과 같은 선택적 파라미터가 포함됩니다.
- 필터링 옵션
-
반환된 작업 목록의 범위를 좁히는 선택적 파라미터입니다.
-
Filter: 필터 기준이 포함된 객체입니다.-
JobStatus: 현재 상태를 기준으로 작업을 필터링합니다. 유효한 값:Pending,Running,Completed,Failed,Cancelling또는Cancelled.
-
-
- 페이지 매김 제어
-
결과 페이지 매김을 제어하는 선택적 파라미터입니다.
-
MaxResults: 단일 응답으로 반환할 최대 작업 수입니다. 이를 사용하여 대규모 결과 집합의 페이지 크기를 제어합니다. -
NextToken: 이전ListJobs응답의 페이지 매김 토큰입니다. 다음 결과 페이지를 검색하려면이 토큰을 포함합니다.
-
응답 이해
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의를 사용하여 결과의 모든 페이지를 반복합니다.
