

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

# 描述 AWS IoT SiteWise 批量导入任务 (AWS CLI)
<a name="DescribeBulkImportJob"></a>

使用 [DescribeBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeBulkImportJob.html)API 操作检索有关中特定批量导入任务的信息 AWS IoT SiteWise。如果作业失败，此操作会返回诸如作业状态、创建时间和错误信息之类的详细信息。您可以使用此操作来监控作业进度并排查问题。要使用 `DescribeBulkImportJob`，您需要 `CreateBulkImportJob` 操作的作业 ID。此 API 会返回以下信息：
+ 正在导入的文件列表，包括它们的 Amazon S3 存储桶位置和密钥
+ 错误报告位置（如适用）
+ 作业配置详情，例如文件格式和 CSV 列名称
+ 作业创建和上次更新时间戳
+ 当前作业状态（例如，作业是处于正在进行中、已完成还是失败状态）
+ 用于导入作业的 IAM 角色 ARN

对于已完成的作业，请查看结果，确认数据集成是否成功。如果作业失败，请检查错误详情以诊断和解决问题。

*job-ID*替换为要检索的批量导入任务的 ID。

```
aws iotsitewise describe-bulk-import-job --job-id job-ID
```

**Example 响应**  

```
{
   "files":[
      {
         "bucket":"amzn-s3-demo-bucket1",
         "key":"100Tags12Hours.csv"
      },
      {
         "bucket":"amzn-s3-demo-bucket2",
         "key":"BulkImportData1MB.csv"
      },
      {
         "bucket":"	amzn-s3-demo-bucket3",
         "key":"UnmodeledBulkImportData1MB.csv"
      }
   ],
   "errorReportLocation":{
      "prefix":"errors/",
      "bucket":"amzn-s3-demo-bucket-for-errors"
   },
   "jobConfiguration":{
      "fileFormat":{
         "csv":{
            "columnNames":[
               "ALIAS",
               "DATA_TYPE",
               "TIMESTAMP_SECONDS",
               "TIMESTAMP_NANO_OFFSET",
               "QUALITY",
               "VALUE"
            ]
         }
      }
   },
   "jobCreationDate":1645745176.498,
   "jobStatus":"COMPLETED",
   "jobName":"myBulkImportJob",
   "jobLastUpdateDate":1645745279.968,
   "jobRoleArn":"arn:aws:iam::123456789012:role/DemoRole",
   "jobId":"f8c031d0-01d1-4b94-90b1-afe8bb93b7e5"
}
```