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

# 任務進度追蹤
<a name="review-job-progress"></a>

## 檢閱任務進度和詳細資訊 （主控台）
<a name="review-job-progress-console"></a>

請參閱 [匯入中繼資料 （主控台）](running-bulk-operations-import.md#import-metadata-console)或 [匯出中繼資料 （主控台）](running-bulk-operations-export.md#export-metadata-console) 以啟動大量任務。

**AWS IoT SiteWise 主控台中的任務進度概觀：**

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

1. 從導覽窗格中選擇**大量操作新增**。

1.  AWS IoT SiteWise 主控台中的**任務進度**表會顯示大量操作任務的清單。

1. **任務類型**欄說明是匯出還是匯入任務。**匯入日期**欄會顯示任務開始的日期。

1. **狀態**欄會顯示任務的狀態。您可以選取任務以查看任務的詳細資訊。

1. 選取的任務會在成功時顯示**成功**，或在任務失敗時顯示失敗清單。每個資源類型也會顯示錯誤描述。

**AWS IoT SiteWise 主控台中的任務詳細資訊概觀：**

 AWS IoT SiteWise 主控台中的**任務進度**表會顯示大量操作任務的清單。

1. 選擇任務以查看更多詳細資訊。

1. 對於**匯入**任務， `Data source ARN`代表匯入檔案的 Amazon S3 位置。

1. 對於**匯出**任務， `Data destination ARN`代表匯出後檔案的 Amazon S3 位置。

1. `Status` 和 `Status reason`提供目前任務的其他詳細資訊。如需詳細資訊，請參閱[任務進度追蹤和錯誤處理](jobs-progress-error-handling.md)。

1. `Queued position` 代表任務在程序佇列中的位置。一次處理一個任務。排入佇列的位置為 1，表示接下來將處理任務。

1.  任務詳細資訊頁面也會顯示任務進度計數。

   1. 任務進度計數類型為：

     1. `Total resources` – 表示轉移程序中資產的總計數。

     1. `Succeeded` – 表示程序期間成功轉移的資產計數。

     1. `Failed` – 表示程序期間失敗的計數資產。

     1. `Skipped` – 表示在程序期間略過的資產計數。

1. 任務狀態為 `PENDING`或 時`VALIDATING`， 會顯示所有任務進度計為 `–`。這表示正在評估任務進度計數。

1. 的任務狀態`RUNNING`會顯示`Total resources`計數，即提交處理的任務。詳細計數 (`Succeeded`、 `Failed`和 `Skipped`) 會套用至已處理的資源。詳細計數的總和小於`Total resources`計數，直到任務的狀態為 `COMPLETED`或 為止`ERROR`。

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

1.  如果任務的狀態為 `ERROR`，請檢查**任務失敗**資料表，以取得特定錯誤和失敗的詳細資訊。如需詳細資訊，請參閱[檢查錯誤詳細資訊 （主控台）](inspect-errors.md#inspect-errors-console)。

## 檢閱任務進度和詳細資訊 (AWS CLI)
<a name="review-job-progress-cli"></a>

啟動大量操作後，您可以使用下列 API 動作來檢查或更新其狀態：
+ 若要擷取特定任務的資訊，請使用 [ GetMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html) API 動作。

**使用 `GetMetadataTransferJob` API 擷取資訊：**

  1. 建立並執行轉移任務。呼叫 `GetMetadataTransferJob` API。  
**Example AWS CLI 命令：**  

     ```
     aws iottwinmaker get-metadata-transfer-job \ 
             --metadata-transfer-job-id {{your_metadata_transfer_job_id}} \
             --region {{your_region}}
     ```

  1.  `GetMetadataTransferJob` API 會傳回具有下列參數的`MetadataTransferJobProgress`物件：
     + **succeededCount** – 表示流程中成功傳輸的資產計數。
     + **failedCount** – 表示程序期間失敗的資產計數。
     + **skippedCount** – 表示程序期間略過的資產計數。
     + **totalCount** – 表示轉移程序中資產的總計數。

     這些參數表示任務進度狀態。如果狀態為 `RUNNING`，則有助於追蹤仍在處理的資源數量。

     如果您遇到結構描述驗證錯誤，或如果 **failedCount** 大於或等於 1，任務進度狀態會變成 `ERROR`。任務的完整錯誤報告會放置在 Amazon S3 儲存貯體中。如需詳細資訊，請參閱[檢查 的錯誤 AWS IoT SiteWise](inspect-errors.md)。
+ 若要列出目前的任務，請使用 [ListMetadataTransferJobs](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobs.html) API 動作。

  使用 JSON 檔案，根據其目前狀態篩選傳回的任務。請參閱下列程序：

  1. 若要指定要使用的篩選條件，請建立 AWS CLI 輸入 JSON 檔案。 想要使用：

     ```
     {
         "sourceType": "s3",
         "destinationType": "iottwinmaker",
         "filters": [{
             "state": "COMPLETED"
         }]
     }
     ```

     如需有效`state`值的清單，請參閱《 *AWS IoT TwinMaker API 參考指南*》中的 [ListMetadataTransferJobsFilter](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobsFilter.html)。

  1.  在下列 AWS CLI 範例命令中使用 JSON 檔案做為引數：

     ```
     aws iottwinmaker list-metadata-transfer-job --region {{your_region}} \
             --cli-input-json file://ListMetadataTransferJobsExample.json
     ```
+ 若要取消任務，請使用 [CancelMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CancelMetadataTransferJob.html) API 動作。此 API 會取消特定中繼資料傳輸任務，而不會影響任何已匯出或匯入的資源：

  ```
  aws iottwinmaker cancel-metadata-transfer-job \ 
          --region {{your_region}} \ 
          --metadata-transfer-job-id {{job-to-cancel-id}}
  ```