ジョブの進行状況の追跡

ジョブの進行状況と詳細を確認する (コンソール）

一括ジョブを開始するには、メタデータのインポート (コンソール）「」またはメタデータのエクスポート (コンソール）「」を参照してください。

AWS IoT SiteWise コンソールでのジョブの進行状況の概要：

1. AWS IoT SiteWise コンソールに移動します。

2. ナビゲーションペインから一括オペレーション新規を選択します。

3. AWS IoT SiteWise コンソールのジョブの進行状況テーブルに、一括オペレーションジョブのリストが表示されます。

4. ジョブタイプ列は、エクスポートジョブかインポートジョブかを示します。インポートされた日付列には、ジョブが開始された日付が表示されます。

5. ステータス列には、ジョブのステータスが表示されます。ジョブを選択すると、そのジョブの詳細を表示できます。

6. 選択したジョブには、成功すると成功、ジョブが失敗した場合は失敗のリストが表示されます。エラーの説明は、リソースタイプごとにも表示されます。

AWS IoT SiteWise コンソールでのジョブの詳細の概要：

AWS IoT SiteWise コンソールのジョブの進行状況テーブルに、一括オペレーションジョブのリストが表示されます。

1. ジョブを選択すると、詳細が表示されます。

2. インポートジョブの場合、 はインポートファイルの Amazon S3 の場所Data source ARNを表します。

3. エクスポートジョブの場合、 はエクスポート後のファイルの Amazon S3 の場所Data destination ARNを表します。

4. Status および はStatus reason、現在のジョブに関する追加の詳細を提供します。詳細については、「ジョブの進行状況の追跡とエラー処理」を参照してください。

5. は、プロセスキュー内のジョブの位置Queued positionを表します。ジョブは一度に 1 つずつ処理されます。キューに入れられた位置が 1 の場合、ジョブが次に処理されることを示します。

6. ジョブの詳細ページには、ジョブの進行状況の数も表示されます。

   1. ジョブの進行状況カウントタイプは次のとおりです。

      1. Total resources – 転送プロセス内のアセットの合計数を示します。

      2. Succeeded – プロセス中に正常に転送されたアセットの数を示します。

      3. Failed – プロセス中に失敗したアセットの数を示します。

      4. Skipped – プロセス中にスキップされたアセットの数を示します。

7. ジョブのステータスが PENDINGまたは の場合VALIDATING、すべてのジョブの進行状況が としてカウントされます–。これは、ジョブの進行状況カウントが評価されていることを示します。

8. のジョブステータスには、処理のために送信されたジョブTotal resourcesの数RUNNINGが表示されます。詳細なカウント (Succeeded、Failed、および Skipped) は、処理されたリソースに適用されます。詳細なカウントの合計は、ジョブのステータスが COMPLETEDまたは になるまでTotal resourcesカウントよりも小さくなりますERROR。

9. ジョブのステータスが COMPLETEDまたは の場合ERROR、Total resourcesカウントは詳細カウント (Succeeded、、) の合計に等しくなりますFailedSkipped。

10. ジョブのステータスが の場合ERROR、ジョブ失敗テーブルで特定のエラーと失敗の詳細を確認します。詳細については、「エラーの詳細を確認する (コンソール）」を参照してください。

ジョブの進行状況と詳細を確認する (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. は、次のパラメータを持つMetadataTransferJobProgressオブジェクトGetMetadataTransferJobAPIを返します。

     • succeededCount – プロセスで正常に転送されたアセットの数を示します。

     • failedCount – プロセス中に失敗したアセットの数を示します。

     • skippedCount – プロセス中にスキップされたアセットの数を示します。

     • totalCount – 転送プロセス内のアセットの合計数を示します。

     これらのパラメータは、ジョブの進行状況を示します。ステータスが の場合RUNNING、まだ処理されていないリソースの数を追跡するのに役立ちます。

     スキーマ検証エラーが発生した場合、または failedCountが 1 以上の場合、ジョブの進行状況は になりますERROR。ジョブの完全なエラーレポートは、Amazon S3 バケットに配置されます。詳細については、「エラーの検査」を参照してください。

• 現在のジョブを一覧表示するには、 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