デバイスのワークフロー

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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