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 Arbeitsablauf für Befehle auf hoher Ebene.

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 validieren. 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 Bewertung des Parameterwerts

Beim Starten von Befehlsausführungen mit Payload-Vorlagen werden Parameterwerte mit der folgenden Priorität aufgelöst:

Die Wertbedingungen werden anhand des endgültigen Parameterwerts bewertet, der oben anhand der Priorität abgeleitet wurde, und zwar vor der Erstellung der Ausführung. Schlägt die Überprüfung 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 Starten der Ausführung:

Befehlsstatus

Befehle in Ihrem AWS-Konto können sich in einem von drei Status befinden: Verfügbar, Veraltet oder Ausstehende Löschung.

Status der Befehlsausführung

Wenn Sie eine Ausführung auf einem Zielgerät starten, geht es in den CREATED Status über und kann auf der Grundlage von Geräteberichten in einen anderen Status übergehen. Sie können Statusinformationen abrufen und Ausführungen nachverfolgen.

Die folgende Tabelle zeigt den Ausführungsstatus und die zugehörigen Ü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 reasonDescription Felder im statusReason Objekt verwendenreasonCode.

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

In den folgenden Abschnitten werden Ausführungen am Terminal und an anderen Endgeräten sowie deren Status beschrieben.

Befehlsausführungen außerhalb des Terminals

Eine Ausführung ist kein Terminal, wenn sie Updates von Geräten annehmen kann. Ausführungen, die kein Terminal sind, 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 von Geräten mehr akzeptiert. Bei den folgenden Status handelt es sich um einen Terminalstatus. Ausführungen können von jedem Status, der kein Terminal ist, in einen Terminalstatus übergehen:CREATED, oder. IN_PROGRESS TIMED_OUT