Befehle, Konzepte und Status

Befehle sind Anweisungen, die von der Cloud an Ihre IoT-Geräte gesendet werden. Diese Anweisungen (Befehls-Payload) werden als MQTT Nachrichten an die Geräte gesendet. Nachdem die Geräte die Befehlsnutzdaten erhalten haben, können sie die Anweisungen verarbeiten, um die entsprechende Aktion auszuführen. Beispiele für solche Aktionen sind das Ändern der Gerätekonfigurationseinstellungen, das Übertragen von Sensormesswerten oder das Hochladen von Protokollen. Die Geräte können dann den Befehl ausführen und das Ergebnis an die Cloud zurückgeben. Auf diese Weise können Sie angeschlossene Geräte aus der Ferne überwachen und steuern.

Wenn Sie die Befehlsfunktion verwenden, können Sie den Namespace für den Befehl angeben. Wenn Sie einen Befehl in erstellen möchten AWS IoT Device Management, müssen Sie den AWS-IoT Standard-Namespace verwenden. Wenn Sie diesen Namespace verwenden, müssen Sie bei der Erstellung des Befehls eine Nutzlast angeben. Die Payload wird verwendet, wenn Sie den Befehl auf Ihrem Zielgerät ausführen. Wenn Sie stattdessen einen Befehl für erstellen möchten, müssen Sie AWS IoT FleetWise stattdessen den AWS-IoT-FleetWise Namespace verwenden. Weitere Informationen finden Sie unter Remote-Befehle im AWS IoT FleetWise Entwicklerhandbuch für Befehle.

Wenn Sie den Befehl erstellen, müssen Sie eine Payload angeben, die die Aktionen definiert, die das Gerät ausführen muss. Die Payload kann ein beliebiges Format Ihrer Wahl verwenden. Um sicherzustellen, dass das Gerät die von Ihnen gesendeten Informationen korrekt lesen und verstehen kann, empfehlen wir Ihnen, den Payload-Formattyp im Befehl anzugeben. Wenn Ihre Geräte das MQTT5 Payload-Format verwenden, können sie dem MQTT Standard zur Identifizierung des Payload-Formats folgen. Ein Formatindikator für JSON oder CBOR wird im Thema zur Befehlsanfrage verfügbar sein.

Wenn Sie den Befehl ausführen möchten, müssen Sie ein Zielgerät angeben, das den Befehl empfängt und Aktionen ausführt. Wenn Ihr Gerät als Ding bei registriert wurde AWS IoT, können Sie den Namen des Dings verwenden. Wenn Ihr Gerät nicht registriert wurde, können Sie stattdessen die MQTT Client-ID verwenden. Die Client-ID ist eine eindeutige Kennung für Ihr Gerät oder Ihren Client, die im MQTT Protokoll definiert ist. Es kann verwendet werden, um Ihr Gerät mit zu verbinden AWS IoT.

Eine Befehlsausführung ist eine Instanz eines Befehls, der auf dem Zielgerät ausgeführt wird. Wenn Sie die Ausführung starten, wird der Befehl (Payload) an das Zielgerät übermittelt. Für das Ziel wird jetzt eine eindeutige Befehlsausführungs-ID generiert. Das Gerät kann den Befehl dann ausführen und seinen Fortschritt an melden AWS IoT. Die geräteseitige Logik bestimmt, wie der Befehl ausgeführt wird und wie der Status in den reservierten Themen veröffentlicht wird.

Bevor Sie den Befehl ausführen, muss Ihr Gerät das Thema zur Befehlsanfrage abonniert haben. Wenn Sie die Anforderung zur Ausführung des Befehls an die Cloud senden, wird die Payload unter dem Thema „Befehlsanfrage“ an das Gerät gesendet. Nachdem das Gerät den Befehl ausgeführt hat, kann es das Ergebnis und den Status der Ausführung im Antwortthema des Befehls veröffentlichen. Weitere Informationen finden Sie unter Themen zu Befehlen.

Nachdem Sie eine Befehlsressource erfolgreich erstellt haben, befindet sie sich im Status „Verfügbar“. Der Befehl kann jetzt verwendet werden, um eine Befehlsausführung an das Gerät zu senden.

Wenn Sie einen Befehl nicht mehr verwenden möchten, können Sie ihn als veraltet markieren. In diesem Status können Sie keine neuen Ausführungen des Befehls an Ihre Geräte senden. Alle ausstehenden Ausführungen, die bereits gestartet wurden, werden auf dem Gerät bis zum Abschluss weiterlaufen. Um neue Ausführungen zu senden, müssen Sie den Befehl wiederherstellen, damit er verfügbar wird.

Wenn Sie einen Befehl zum Löschen markieren und der Befehl für eine Dauer, die länger als das maximale Timeout ist, als veraltet gilt, wird der Befehl automatisch gelöscht. Diese Aktion ist dauerhaft und kann nicht rückgängig gemacht werden. Standardmäßig beträgt die maximale Timeout-Dauer 12 Stunden. Wenn der Befehl nicht veraltet ist oder für eine Dauer, die kürzer als das maximale Timeout ist, als veraltet gilt, befindet sich der Befehl im Status Ausstehende Löschung. Der Befehl wird nach Ablauf der maximalen Timeoutdauer automatisch aus Ihrem Konto entfernt.