AWS IoT data-Beispiele unter Verwendung der AWS CLI - AWS Command Line Interface
Aktionen

AWS IoT data-Beispiele unter Verwendung der AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit AWS IoT data nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie delete-thing-shadow verwendet wird.

AWS CLI

So löschen Sie das Schattendokument eines Geräts

Im folgenden delete-thing-shadow-Beispiel wird das gesamte Schattendokument für das angegebene Gerät mit dem Namen MyRPi gelöscht.

aws iot-data delete-thing-shadow \
    --thing-name MyRPi \
    "output.txt"

Der Befehl erzeugt keine Ausgabe auf dem Bildschirm, output.txt enthält jedoch Informationen, die die Version und den Zeitstempel des gelöschten Schattendokuments bestätigen.

{"version":2,"timestamp":1560270384}

Weitere Informationen finden Sie unter Verwenden von Schatten im Entwicklerhandbuch zu AWS IoT.

Das folgende Codebeispiel zeigt, wie get-thing-shadow verwendet wird.

AWS CLI

So rufen Sie ein Objektschattendokument ab

Im folgenden get-thing-shadow-Beispiel wird das Objektschattendokument für das angegebene IoT-Objekt abgerufen.

aws iot-data get-thing-shadow \
    --thing-name MyRPi \
    output.txt

Der Befehl erzeugt keine Ausgabe auf dem Display, aber im Folgenden wird der Inhalt von output.txt angezeigt:

{
  "state":{
    "reported":{
    "moisture":"low"
    }
  },
  "metadata":{
    "reported":{
      "moisture":{
        "timestamp":1560269319
      }
    }
  },
  "version":1,"timestamp":1560269405
}

Weitere Informationen finden Sie unter Datenfluss des Geräteschatten-Service im Entwicklerhandbuch zu AWS IoT.

  • API-Details finden Sie unter GetThingShadow in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-thing-shadow verwendet wird.

AWS CLI

So aktualisieren Sie einen Objektschatten

Im folgenden update-thing-shadow-Beispiel wird der aktuelle Zustand des Geräteschattens für das angegebene Objekt geändert und in der Datei output.txt gespeichert.

aws iot-data update-thing-shadow \
    --thing-name MyRPi \
    --payload "{"state":{"reported":{"moisture":"okay"}}}" \
    "output.txt"

Der Befehl erzeugt keine Ausgabe auf dem Display, aber im Folgenden wird der Inhalt von output.txt angezeigt:

{
    "state": {
        "reported": {
            "moisture": "okay"
        }
    },
    "metadata": {
        "reported": {
            "moisture": {
                "timestamp": 1560270036
            }
        }
    },
    "version": 2,
    "timestamp": 1560270036
}

Weitere Informationen finden Sie unter Datenfluss des Geräteschatten-Service im Entwicklerhandbuch zu AWS IoT.