View a markdown version of this page

ジョブの進捗状況追跡 - AWS IoT SiteWise
ジョブの進捗状況と詳細を確認する (コンソール)ジョブの進捗状況と詳細を確認する (AWS CLI)

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ジョブの進捗状況追跡

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

メタデータをインポートする (コンソール) または メタデータをエクスポート (コンソール) を参照して、一括ジョブを開始します。

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

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

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

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

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

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

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

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

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

  1. 詳細を表示するジョブを選択します。

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

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

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

  5. Queued position は、プロセスキュー内のジョブの位置を表します。ジョブは一度に 1 つずつ処理されます。キューに入れられた位置が 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 アクションを使用してステータスを確認または更新できます。

  • 特定のジョブに関する情報を取得するには、GetMetadataTransferJob API アクションを使用します。

    以下のように 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」を参照してください。

  • 現在のジョブを一覧表示するには、ListMetadataTransferJobs API アクションを使用します。

    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

  • ジョブをキャンセルするには、CancelMetadataTransferJob API アクションを使用します。この API は、既にエクスポートまたはインポートされたリソースに影響を与えることなく、特定のメタデータ転送ジョブをキャンセルします。

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