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

# 作业进度跟踪
<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)。

**Amazon IoT SiteWise 控制台中的 Job 进度概览：**

1. 导航至 [Amazon IoT SiteWise 控制台](https://console.amazonaws.cn/iotsitewise/)。

1. 从导航窗格中选择**新批量操作**。

1.  Amazon IoT SiteWise 控制台中的**作业进度**表显示了批量操作任务的列表。

1. **作业类型**列描述了是导出作业还是导入作业。**导入日期**列显示了作业的开始日期。

1. **状态**列显示了作业的状态。您可以选择一个作业来查看有关该作业的详细信息。

1. 所选作业成功完成后会显示**成功**，如果作业失败，则会显示失败列表。同时还会显示每种资源类型的错误描述。

**Amazon IoT SiteWise 控制台中的 Job 详情概述：**

 Amazon 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`）适用于已处理的资源。在作业的状态变为 `COMPLETED` 或 `ERROR` 之前，详细计数的总和小于 `Total resources` 计数。

1.  如果作业的状态为 `COMPLETED` 或 `ERROR`，则 `Total resources` 计数等于详细计数（`Succeeded`、`Failed` 和 `Skipped`）的总和。

1.  如果作业的状态为 `ERROR`，请查看**作业失败**表，了解有关特定错误和失败的详细信息。有关更多信息，请参阅[检查错误详情（控制台）](inspect-errors.md#inspect-errors-console)。

## 查看作业进度和详细信息（Amazon CLI）
<a name="review-job-progress-cli"></a>

开始批量操作后，您可以使用以下 API 操作检查或更新其状态：
+ 要检索有关特定任务的信息，请使用 [ GetMetadataTransferJob](https://docs.amazonaws.cn//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html)API 操作。

**使用 `GetMetadataTransferJob` API 检索信息：**

  1. 创建并运行传输作业。调用 `GetMetadataTransferJob` API。  
**Example Amazon 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 存储桶中。有关更多信息，请参阅[检查错误 Amazon IoT SiteWise](inspect-errors.md)。
+ 要列出当前作业，请使用 [ListMetadataTransferJobs](https://docs.amazonaws.cn//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobs.html)API 操作。

  使用 JSON 文件根据返回作业的当前状态对其进行筛选。请参见以下过程：

  1. 要指定要使用的过滤器，请创建一个 Amazon CLI 输入 JSON 文件。要使用：

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

     有关有效`state`值的列表，请参阅 *Amazon IoT TwinMaker API 参考指南[ListMetadataTransferJobsFilter](https://docs.amazonaws.cn//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobsFilter.html)*中的。

  1.  在以下 Amazon CLI 示例命令中使用 JSON 文件作为参数：

     ```
     aws iottwinmaker list-metadata-transfer-job --region {{your_region}} \
             --cli-input-json file://ListMetadataTransferJobsExample.json
     ```
+ 要取消任务，请使用 [CancelMetadataTransferJob](https://docs.amazonaws.cn//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}}
  ```