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

# AWS IoT SiteWise 대량 가져오기 작업 나열(AWS CLI)
<a name="ListBulkImportJobs"></a>

[ListBulkImportJobs](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListBulkImportJobss.html) API 작업을 사용하여 AWS IoT SiteWise의 일괄 가져오기 작업에 대한 요약 목록을 가져옵니다. 이 작업은 데이터 가져오기 프로세스를 모니터링하고 관리하는 효율적인 방법을 제공합니다. 각 작업에 대해 다음 키 정보를 반환합니다.
+ 작업 ID. 각 일괄 가져오기 작업에 대한 고유 식별자
+ 작업 이름. 생성 시 작업에 할당된 이름
+ 현재 상태. 작업의 현재 상태(예: 완료됨, 실행 중, 실패)

ListBulkImportJobs는 모든 일괄 가져오기 작업에 대한 포괄적인 개요를 가져오는 데 특히 유용합니다. 이를 통해 여러 데이터 가져오기를 추적하고, 주의가 필요한 작업을 식별하고, 구성된 워크플로를 유지할 수 있습니다. 이 작업은 페이지 매김을 지원하므로 많은 수의 작업 요약을 효율적으로 검색할 수 있습니다. [DescribeBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeBulkImportJob.html) 작업과 함께 이 작업에서 반환된 작업 ID를 사용하여 특정 작업에 대한 자세한 정보를 검색할 수 있습니다. 이 2단계 프로세스를 통해 먼저 모든 작업을 개괄적으로 확인한 다음 관심 작업의 세부 정보를 심층 분석할 수 있습니다. `ListBulkImportJobs`를 사용할 때 필터를 적용하여 결과를 좁힐 수 있습니다. 예를 들어 상태를 기준으로 작업을 필터링하여 완료된 작업만 검색하거나 실행 중인 작업만 검색할 수 있습니다. 이 기능을 사용하면 현재 작업과 가장 관련성이 높은 정보에 집중할 수 있습니다. 사용 가능한 결과가 더 있는 경우에도 작업은 `nextToken`을 반환합니다. 후속 직접 호출에서 이 토큰을 사용하여 다음 작업 요약 세트를 검색할 수 있으므로 일괄 가져오기 작업이 많더라도 모든 작업을 반복할 수 있습니다. 다음 예제에서는와 `ListBulkImportJobs` 함께를 사용하여 완료된 작업 목록을 검색 AWS CLI 하는 방법을 보여줍니다.

```
aws iotsitewise list-bulk-import-jobs --filter COMPLETED
```

**Example 완료된 작업 필터에 대한 응답**  

```
{
   "jobSummaries":[
      {
         "id":"bdbbfa52-d775-4952-b816-13ba1c7cb9da",
         "name":"myBulkImportJob",
         "status":"COMPLETED"
      },
      {
         "id":"15ffc641-dbd8-40c6-9983-5cb3b0bc3e6b",
         "name":"myBulkImportJob2",
         "status":"COMPLETED"
      }
   ]
}
```

이 명령은 `ListBulkImportJobs`를 사용하여 실패로 완료된 작업 목록을 검색하는 방법을 보여 줍니다. 최댓값은 결과 50개로 설정되며 페이지 매김된 결과에 다음 토큰을 사용합니다.

```
aws iotsitewise list-bulk-import-jobs --filter COMPLETED_WITH_FAILURES --max-results 50 --next-token "string"
```