View a markdown version of this page

Ereignisse bei der Befehlsausführung - 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 Befehlsausführung

AWS IoT veröffentlicht Ereignismeldungen in MQTT-Themen, wenn sich der Status von 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 bei der 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 und verwenden Sie Platzhalterzeichen, um Benachrichtigungen für alle Befehle und Status zu erhalten:

$aws/events/commandExecution/+/#
Meldung über ein Ereignis bei der Befehlsausführung

Wenn sich der Ausführungsstatus eines Befehls ändert, AWS IoT veröffentlicht eine Ereignisnachricht im entsprechenden MQTT-Thema. 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.

Status/Grund

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

eventType

Auf „COMMAND_EXECUTION“ setzen.

Befehl ARN

Der Amazon-Ressourcenname (ARN) des Befehls.

Target ARN

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.