本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 列出 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。每個大量匯入任務的唯一識別符
+ 任務名稱。您在建立任務時指派給任務的名稱
+ 目前狀態。任務的目前狀態 （例如 COMPLETED、RUNNING、FAILED)

ListBulkImportJobs 特別適用於取得所有大量匯入任務的完整概觀。這可協助您追蹤多個資料匯入、識別任何需要注意的任務，以及維護有條不紊的工作流程。操作支援分頁，可讓您有效率地擷取大量任務摘要。您可以使用此操作傳回的任務 IDs搭配 [DescribeBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeBulkImportJob.html) 操作，以擷取特定任務的詳細資訊。這個兩步驟程序可讓您先取得所有任務的高階檢視，然後深入了解感興趣的任務詳細資訊。使用 時`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"
```