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

# ジョブの進捗状況追跡
<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) を参照して、一括ジョブを開始します。

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

1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。

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

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

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

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

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

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

 AWS 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. ジョブの進捗状況カウントタイプは次のとおりです。

     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)」を参照してください。

## ジョブの進捗状況と詳細を確認する (AWS CLI)
<a name="review-job-progress-cli"></a>

一括オペレーションを開始した後、以下の API アクションを使用してステータスを確認または更新できます。
+ 特定のジョブに関する情報を取得するには、[GetMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html) API アクションを使用します。

**以下のように `GetMetadataTransferJob` API を使用して情報を取得します。**

  1. 転送ジョブを作成して実行します。`GetMetadataTransferJob` API を呼び出します。  
**Example AWS 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 バケットに配置されます。詳細については、「[のエラーを検査する AWS IoT SiteWise](inspect-errors.md)」を参照してください。
+ 現在のジョブを一覧表示するには、[ListMetadataTransferJobs](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobs.html) API アクションを使用します。

  JSON ファイルを使用して、返されたジョブを現在の状態に基づいてフィルタリングします。以下の手順を参照してください。

  1. 使用するフィルターを指定するには、 AWS CLI 入力 JSON ファイルを作成します。 は以下を使用します。

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

     有効な `state` 値のリストについては、「*AWS IoT TwinMaker API リファレンスガイド*」の「[ListMetadataTransferJobsFilter](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobsFilter.html)」を参照してください。

  1.  次のコマンド AWS CLI 例では、JSON ファイルを引数として使用します。

     ```
     aws iottwinmaker list-metadata-transfer-job --region {{your_region}} \
             --cli-input-json file://ListMetadataTransferJobsExample.json
     ```
+ ジョブをキャンセルするには、[CancelMetadataTransferJob](https://docs.aws.amazon.com//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}}
  ```