コマンドの概念とステータス

コマンドとは、クラウドから IoT デバイスに送信される指示のことです。これらの指示 (コマンドペイロード) は、MQTT メッセージとしてデバイスに送信されます。デバイスは、コマンドペイロードを受信すると、指示を処理して、対応するアクションを実行することができます。アクションの例としては、デバイス設定の変更、センサーの読み取り値の送信、ログのアップロードなどが挙げられます。その後、デバイスはコマンドを実行して、結果をクラウドに返すことができます。これによって、接続されたデバイスをリモートでモニタリングしたり制御したりすることが可能となっています。

コマンド機能を使用すると、コマンドの名前空間を指定できます。AWS IoT Device Management でコマンドを作成する場合は、デフォルトの AWS-IoT 名前空間を使用する必要があります。この名前空間を使用する場合は、コマンドの作成時にペイロードを指定する必要があります。ペイロードは、ターゲットデバイスで コマンドを実行するときに使用されます。代わりに AWS IoT FleetWise のコマンドを作成する場合は、AWS-IoT-FleetWise 名前空間を使用する必要があります。詳細については、「AWS IoT FleetWise デベロッパーガイド」の「コマンド」でリモートコマンドを参照してください。

コマンドを作成するときは、デバイスが実行する必要があるアクションを定義するペイロードを指定する必要があります。ペイロードには、任意の形式を使用できます。ユーザーが送信する情報をデバイスが正しく読み、理解できるように、コマンドでペイロード形式タイプを指定することをお勧めします。デバイスで MQTT5 が使用されている場合は、デバイスは MQTT 標準に従ってペイロード形式を識別できます。JSON または CBOR の形式インジケータは、コマンドリクエストトピックで使用できます。

コマンドを実行する場合、コマンドを受信して指定された指示を実行するターゲットデバイスを指定する必要があります。デバイスが AWS IoT でモノとして登録されている場合は、モノの名前を使用できます。デバイスが登録されていない場合は、代わりに MQTT クライアント ID を使用できます。クライアント ID は、MQTT プロトコルで定義されたデバイスまたはクライアントの一意の識別子です。デバイスを AWS IoT に接続するために使用できます。

コマンドの実行とは、ターゲットデバイスで実行されるコマンドのステップを指します。実行を開始すると、コマンド (ペイロード) がターゲットデバイスに配信されます。現在、ターゲットに対して一意のコマンド実行 ID が生成されるようになりました。その後デバイスは、コマンドを実行し、その進行状況を AWS IoT に報告できます。コマンドの実行方法および予約済みトピックへステータスが公開される方法は、デバイス側のロジックによって決定されます。

コマンドを実行する前に、デバイスがコマンドリクエストのトピックをサブスクライブしている必要があります。リクエストをクラウドに送信してコマンドを実行すると、ペイロードはコマンドリクエストのトピックでデバイスに送信されます。デバイスはコマンドを実行すると、実行の結果とステータスをコマンドレスポンスのトピックに発行できます。詳細については、「コマンドトのピック」を参照してください。

コマンドリソースが正常に作成されると、使用可能な状態になります。コマンドを使用して、デバイスにコマンド実行を送信することができます。

コマンドを使用する予定がなくなった場合は、非推奨としてマークできます。この状態では、新たにコマンドの実行をデバイスに送信することはできません。すでに開始されていた保留中の実行は、完了するまでデバイスで実行され続けます。新しく実行を送信するには、コマンドを復元して使用可能にする必要があります。

コマンドを削除対象としてマークすると、コマンドが非推奨になっている期間が最大タイムアウト期間を超えると、コマンドは自動的に削除されます。これは永久的な操作で、取消すことはできません。デフォルトでは、セッションの最大タイムアウト期間は 12 時間です。コマンドが非推奨になっていない場合、または非推奨状態にある期間が最大タイムアウト期間より短い場合、そのコマンドは [保留中の削除] の状態になります。コマンドは、最大タイムアウト期間経過後に、アカウントから自動的に削除されます。