

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

# 檢查 的錯誤 AWS IoT SiteWise
<a name="inspect-errors"></a>

## 檢查錯誤詳細資訊 （主控台）
<a name="inspect-errors-console"></a>

**AWS IoT SiteWise 主控台中的錯誤詳細資訊：**

1. 導覽至 [AWS IoT SiteWise 主控台](https://console.aws.amazon.com/iotsitewise/)。

1. 如需大量操作任務的清單 AWS IoT SiteWise 主控台 ，請參閱 中的任務**進度**表。

1. 選取任務以檢視任務詳細資訊。

1. 如果任務的狀態為 `COMPLETED`或 `ERROR`，則`Total resources`計數等於詳細計數 (`Succeeded`、 `Failed`和 ) 的總和`Skipped`。

1.  如果任務的狀態為 `ERROR`，請檢查**任務失敗**資料表，以取得特定錯誤和失敗的詳細資訊。

1. **任務失敗**資料表會顯示任務報告中的內容。`Resource type` 欄位指出錯誤或失敗的位置，如下所示：
   + 例如， `Resource type` 欄位中`Bulk operations template`的驗證錯誤表示匯入範本和中繼資料結構描述檔案格式不相符。如需詳細資訊，請參閱[AWS IoT SiteWise 中繼資料傳輸任務結構描述](bulk-operations-schema.md)。
   + `Resource type` 欄位`Asset`失敗表示資產未建立，因為與另一個資產發生衝突。如需 AWS IoT SiteWise 資源[錯誤和衝突的相關資訊，請參閱常見](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/CommonErrors.html)錯誤。

## 檢查錯誤詳細資訊 (AWS CLI)
<a name="inspect-errors-cli"></a>

若要處理和診斷傳輸任務期間產生的錯誤，請參閱下列有關使用 `GetMetadataTransferJob` API 動作的程序：

1. 建立和執行傳輸任務之後，請呼叫 [GetMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html)：

   ```
   aws iottwinmaker get-metadata-transfer-job \
           --metadata-transfer-job-id {{your_metadata_transfer_job_id}} \
           --region us-east-1
   ```

1. 一旦看到任務的狀態變成 `COMPLETED`，您就可以開始驗證任務的結果。

1. 當您呼叫 時`GetMetadataTransferJob`，它會傳回名為 的物件[https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html)。

   MetadataTransferJobProgress 物件包含下列參數：
   + **failedCount：**表示轉移程序期間失敗的資產計數。
   + **skippedCount：**表示轉移過程中略過的資產計數。
   + **succeededCount：**表示轉移程序期間成功的資產計數。
   + **totalCount：**表示轉移程序中涉及的資產總數。

1. 此外，API 呼叫會傳回 元素 `reportUrl`，其中包含預先簽章的 URL。如果您的轉移任務有任何需要進一步調查的問題，請造訪此 URL。