作业进度跟踪 - AWS IoT SiteWise
查看作业进度和详细信息（控制台）查看作业进度和详细信息（AWS CLI）

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

作业进度跟踪

查看作业进度和详细信息（控制台）

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

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

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

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

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

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

  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 计数，即已提交待处理的作业。详细计数（Succeeded、Failed 和 Skipped）适用于已处理的资源。在作业的状态变为 COMPLETED 或 ERROR 之前，详细计数的总和小于 Total resources 计数。

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

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

查看作业进度和详细信息（AWS CLI）

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

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

    使用 GetMetadataTransferJob API 检索信息：

    1. 创建并运行传输作业。调用 GetMetadataTransferJob API。

      例 AWS CLI 命令：
      
aws iottwinmaker get-metadata-transfer-job \ 
        --metadata-transfer-job-id your_metadata_transfer_job_id \
        --region your_region

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

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

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

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

      • totalCount — 表示传输过程中的资产总数。

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

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

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

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

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

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

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

    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