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

# 描述 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"
}
```