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.

Befehle, Konzepte und Status

Verwenden Sie AWS IoT Befehle, um Anweisungen aus der Cloud an verbundene Geräte zu senden. Um dieses Feature zu verwenden:

Weitere Informationen zu diesem Workflow finden Sie unter High-level Arbeitsablauf für Befehle.

Befehle und wichtige Konzepte

Die folgenden Schlüsselkonzepte helfen Ihnen, die Befehlsfunktion zu verstehen. Begriffe werden in dieser Dokumentation einheitlich verwendet:

Bedingungen für Parameterwerte

Definieren Sie beim Erstellen von Befehlen mit Payload-Vorlagen Wertbedingungen, um Parameterwerte vor der Ausführung zu überprüfen. Wertbedingungen stellen sicher, dass die Parameter die Anforderungen erfüllen, und verhindern so ungültige Ausführungen.

Unterstützte Operatoren nach Typ CommandParameterValue

Beispiel: Befehl zur Temperatursteuerung

{
  "commandId": "SetTemperature",
  "namespace": "AWS-IoT",
  "payloadTemplate": "{\"temperature\": \"${aws:iot:commandexecution::parameter:temperature}\"}",
  "parameters": [
    {
      "name": "temperature",
      "type": "INTEGER",
      "valueConditions": [
        {
          "comparisonOperator": "IN_RANGE",
          "operand": {
            "numberRange": {
              "min": "60",
              "max": "80"
            }
          }
        }
      ]
    }
  ]
}

In diesem Beispiel muss der temperature Parameter zwischen 60 und 80 (einschließlich) liegen. Ausführungsanforderungen mit Werten außerhalb dieses Bereichs schlagen bei der Überprüfung fehl.

Priorität und Auswertung von Parameterwerten

Wenn Befehlsausführungen mit Payload-Vorlagen gestartet werden, werden Parameterwerte mit der folgenden Priorität aufgelöst:

Die Wertbedingungen werden anhand des endgültigen Parameterwerts ausgewertet, der oben anhand der Priorität und vor der Erstellung der Ausführung abgeleitet wurde. Schlägt die Validierung fehl, gibt die Ausführungsanforderung einen Fehler zurück.

Beispiel: SetTemperature Befehl mit defaultValue

{
  "parameters": [
    {
      "name": "temperature",
      "type": "INTEGER",
      "defaultValue": {"I": 72},
      "valueConditions": [
        {
          "comparisonOperator": "IN_RANGE",
          "operand": {"numberRange": {"min": "60", "max": "80"}}
        }
      ]
    }
  ]
}

Beim Start der Ausführung:

Befehlsstatus

Befehle in Ihrem AWS-Konto können sich in einem von drei Zuständen befinden: Verfügbar, Veraltet oder Ausstehend.

Status der Befehlsausführung

Wenn Sie eine Ausführung auf einem Zielgerät starten, wechselt das Gerät in den CREATED Status und kann aufgrund von Geräteberichten in einen anderen Status übergehen. Sie können Statusinformationen abrufen und Ausführungen verfolgen.

Die folgende Tabelle zeigt den Ausführungsstatus und ihre Übergänge auf der Grundlage des Ausführungsfortschritts.

Geräte können Status- und Ergebnisaktualisierungen jederzeit mithilfe von Befehlen veröffentlichen, die MQTT-Themen vorbehalten sind. Um zusätzlichen Kontext bereitzustellen, können Geräte reasonCode und reasonDescription Felder im statusReason Objekt verwenden.

Das folgende Diagramm zeigt Übergänge zum Ausführungsstatus.

In den folgenden Abschnitten werden Terminalausführungen und andere Terminalausführungen sowie deren Status beschrieben.

Non-terminal Befehlsausführungen

Eine Ausführung ist nicht terminal, wenn sie Aktualisierungen von Geräten annehmen kann. Non-terminal Ausführungen werden als aktiv betrachtet. Die folgenden Status sind nicht terminal:

Ausführung von Terminal-Befehlen

Eine Ausführung wird zum Terminal, wenn sie keine Updates mehr von Geräten akzeptiert. Die folgenden Status haben den Status „Terminal“. Ausführungen können von jedem Status, der kein Terminal ist, in den Terminalstatus übergehen:CREATED, oder. IN_PROGRESS TIMED_OUT