作业进度跟踪

查看任务进度和详细信息（控制台）

导出元数据（控制台）要启动批量作业，请参阅导入元数据（控制台）或。

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

1. 导航到 AWS IoT SiteWise 控制台。

2. 从导航窗格中选择批量操作新建。

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

4. Job type 列描述它是导出任务还是导入任务。导入日期列显示作业的开始日期。

5. 状态列显示作业的状态。您可以选择作业以查看有关该作业的详细信息。

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

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

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

1. 选择一份工作以查看更多详情。

2. 对于导入任务，Data source ARN表示导入文件的 Amazon S3 位置。

3. 对于导出任务，Data destination ARN表示文件在导出后的 Amazon S3 位置。

4. Status和Status reason，提供有关当前工作的更多详细信息。有关更多信息，请参阅作业进度跟踪和错误处理。

5. Queued position表示作业在流程队列中的位置。一次只能处理一个作业。排队位置为 1 表示接下来将处理该作业。

6. 作业详细信息页面还会显示作业进度计数。

   1. 作业进度计数类型有：

      1. Total resources— 表示转移过程中的资产总数。

      2. Succeeded— 表示在此过程中成功转移的资产数量。

      3. Failed— 表示在此过程中失败的资产数量。

      4. Skipped— 表示在此过程中跳过的资产数量。

7. 作业状态为PENDING或VALIDATING，则显示所有作业进度计为–。这表示正在评估作业进度计数。

8. 作业状态RUNNING显示计Total resources数，即已提交待处理的作业。详细计数（SucceededFailed、和Skipped）适用于已处理的资源。在任务的状态为COMPLETED或之前，详细Total resources计数的总和小于计数ERROR。

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

10. 如果作业的状态为ERROR，请查看 J ob failures 表，了解有关特定错误和失败的详细信息。有关更多信息，请参阅检查错误详情（控制台）。

查看工作进度和详细信息 (AWS CLI)

开始批量操作后，您可以使用以下API操作检查或更新其状态：

• 要检索有关特定任务的信息，请使用 GetMetadataTransferJobAPI操作。

  使用以下方法检索信息 GetMetadataTransferJobAPI：

  1. 创建并运行传输作业。致电 GetMetadataTransferJobAPI.

     例 AWS CLI 命令：

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

  2. GetMetadataTransferJobAPI返回一个带有以下参数的MetadataTransferJobProgress对象：

     • succeededCount— 表示在此过程中成功转移的资产数量。

     • failedCount— 表示在此过程中失败的资产数量。

     • skippedCount— 表示在此过程中跳过的资产数量。

     • totalCount— 表示转移过程中的资产总数。

     这些参数表示任务进度状态。如果状态为RUNNING，它们会帮助跟踪仍有待处理的资源数量。

     如果您遇到架构验证错误，或者如果failedCount大于或等于 1，则作业进度状态将变为ERROR。任务的完整错误报告已放入您的 Amazon S3 存储桶中。有关更多信息，请参阅检查错误。

• 要列出当前作业，请使用ListMetadataTransferJobsAPI操作。

  使用JSON文件根据当前状态筛选返回的作业。参见以下步骤：

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

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

     有关有效state值的列表，请参阅ListMetadataTransferJobsFilter《AWS IoT TwinMaker API参考指南》。

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

     
     aws iottwinmaker list-metadata-transfer-job --region your_region \
             --cli-input-json file://ListMetadataTransferJobsExample.json
     

• 要取消任务，请使用CancelMetadataTransferJobAPI操作。这将API取消特定的元数据传输任务，而不会影响任何已导出或导入的资源：

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