デバイスのワークフロー - AWS IoT Core

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

デバイスのワークフロー

デバイスは、次のいずれかの方法を使用してデバイスが実行するジョブを処理できます。

  • 次のジョブを取得する

    1. デバイスが最初にオンラインになると、デバイスの notify-next トピックに登録する必要があります。

    2. jobId を $next として DescribeJobExecution MQTT API を呼び出して、次のジョブ、そのジョブのドキュメント、および statusDetails に保存されている状態を含むその他の詳細を取得します。ジョブドキュメントにコードファイル署名がある場合、ジョブリクエストの処理を続行する前に、署名を確認する必要があります。

    3. ジョブステータスを更新するには､UpdateJobExecution MQTT API を呼び出します｡ または、これと前のステップを 1 回の呼び出しで組み合わせるには、デバイスは StartNextPendingJobExecution を呼び出すことができます。

    4. (オプション) ステップタイマーを追加するには、stepTimeoutInMinutes または UpdateJobExecution のいずれかを呼び出すときに StartNextPendingJobExecution の値を設定します。

    5. UpdateJobExecution MQTT API を使用してジョブドキュメントで指定されたアクションを実行して、ジョブの進行状況を報告します。

    6. この jobId で DescribeJobExecutionMQTT API を呼び出して、ジョブ実行のモニタリングを続行します。ジョブ実行が削除された場合、DescribeJobExecution は ResourceNotFoundException を返します。

      デバイスがジョブを実行中にジョブ実行がキャンセルされたまたは削除された場合、このデバイスは有効な状態に復旧することができる必要があります。

    7. ジョブが終了したら、UpdateJobExecution MQTT API を呼び出してジョブのステータスを更新し、成功または失敗を報告します。

    8. このジョブの実行ステータスが終了状態に変更されたため、実行可能な次のジョブ (存在する場合) が変更されます。デバイスは、次の保留中のジョブ実行が変更されたことを通知されます。この時点で、デバイスはステップ 2 の説明に従って続行する必要があります。

    デバイスがオンラインのままであれば、後続の保留中のジョブ実行の通知が引き続き受信されます。これには、ジョブ完了時や、保留中の新しいジョブ実行が追加された時点の、ジョブ実行データが含まれます。これが発生すると、デバイスはステップ 2 の説明に従って続行されます。

  • 利用可能なジョブを選択する

    1. デバイスが最初にオンラインになると、モノの notify トピックに登録する必要があります。

    2. GetPendingJobExecutions MQTT API を呼び出して、保留中のジョブ実行のリストを取得します。

    3. リストに 1 つまたは複数のジョブの実行が含まれている場合は、1 つのジョブを選択します。

    4. DescribeJobExecution MQTT API を呼び出して、statusDetails に保存されている状態を含め、ジョブドキュメントおよびその他の詳細を取得します。

    5. ジョブステータスを更新するには､UpdateJobExecution MQTT API を呼び出します｡ このコマンドで includeJobDocument フィールドが true に設定されている場合、デバイスは前のステップをスキップして、この時点でジョブドキュメントを取得できます。

    6. オプションで、ステップタイマーを追加するには、stepTimeoutInMinutes を呼び出すときに UpdateJobExecution の値を設定します。

    7. UpdateJobExecution MQTT API を使用してジョブドキュメントで指定されたアクションを実行して、ジョブの進行状況を報告します。

    8. この jobId で DescribeJobExecutionMQTT API を呼び出して、ジョブ実行のモニタリングを続行します。デバイスがジョブを実行中にそのジョブの実行がキャンセルまたは削除された場合は、このデバイスを有効な状態に復帰できる必要があります。

    9. ジョブが終了したら、UpdateJobExecution MQTT API を呼び出してジョブのステータスを更新し、成功または失敗を報告します。

    デバイスがオンラインのままになると、新しい保留中のジョブ実行が利用可能になるとき、保留中のジョブの実行がすべて通知されます。これが発生すると、デバイスはステップ 2 の説明に従って続行できます。

デバイスがジョブを実行できない場合は、UpdateJobExecution MQTT API を呼び出してジョブのステータスを REJECTED に更新する必要があります｡