Ereignisse bei der Ausführung von Befehlen - AWS IoT Core

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Ereignisse bei der Ausführung von Befehlen

AWS IoT veröffentlicht Ereignismeldungen zu MQTT-Themen, wenn sich der Status der Befehlsausführungen ändert. Sie können diese Ereignisse verwenden, um den Fortschritt der Befehlsausführung zu überwachen und Anwendungen zu erstellen, die auf Statusänderungen reagieren.

Themen zu Ereignissen zur Befehlsausführung

Ereignisse zur Befehlsausführung werden unter dem folgenden MQTT-Thema veröffentlicht:

$aws/events/commandExecution/commandId/status

Wobei Folgendes gilt:

  • commandIdist der Bezeichner des Befehls.

  • statusist der Status der Befehlsausführung. Folgende Werte sind zulässig: CREATED, IN_PROGRESS, SUCCEEDED, FAILED, REJECTED, TIMED_OUT.

Abonnieren Sie das folgende Thema mit Platzhalterzeichen, um Benachrichtigungen zu allen Befehlen und allen Status zu erhalten:

$aws/events/commandExecution/+/#
Meldung über das Ereignis zur Befehlsausführung

Wenn sich der Status der Befehlsausführung ändert, wird eine Ereignismeldung zum entsprechenden MQTT-Thema AWS IoT veröffentlicht. Die Nachricht enthält die folgende Beispielnutzlast:

{
    "executionId": "2bd65c51-4cfd-49e4-9310-d5cbfdbc8554",
    "status": "FAILED",
    "statusReason": {
        "reasonCode": "DEVICE_TOO_BUSY",
        "reasonDescription": ""
    },
    "eventType": "COMMAND_EXECUTION",
    "commandArn": "arn:aws:iot:us-east-1:123456789012:command/0b9d9ddf-e873-43a9-8e2c-9fe004a90086",
    "targetArn": "arn:aws:iot:us-east-1:123456789012:thing/5006c3fc-de96-4def-8427-7eee36c6f2bd",
    "timestamp": 1717708862107
}

Die Nutzlast enthält die folgenden Attribute:

Ausführungs-ID

Ein eindeutiger Bezeichner für die Befehlsausführung (Zeichenfolge).

status

Der Status der Befehlsausführung. Folgende Werte sind zulässig: CREATED, IN_PROGRESS, SUCCEEDED, FAILED, REJECTED, TIMED_OUT.

StatusGrund

Ein Objekt, das zusätzliche Informationen über den Status enthält, falls verfügbar. Enthält reasonCode und reasonDescription Felder.

eventType

Auf „COMMAND_EXECUTION“ eingestellt.

Befehl: ARN

Der Amazon-Ressourcenname (ARN) des Befehls.

targetArn

Der ARN des Zielgeräts (Ding oder Client) für die Befehlsausführung.

timestamp

Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.