本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 列出 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"
```