Esempi per AWS IoT data con AWS CLI - Esempi di codice per SDK AWS
Azioni

Sono disponibili altri esempi per SDK AWS nel repository GitHub della documentazione degli esempi per SDK AWS.

Esempi per AWS IoT data con AWS CLI

Gli esempi di codice seguenti mostrano come eseguire operazioni e implementare scenari comuni utilizzando AWS Command Line Interface con AWS IoT data.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

L’esempio di codice seguente mostra come utilizzare delete-thing-shadow.

AWS CLI

Come eliminare il documento shadow di un dispositivo

L’esempio delete-thing-shadow seguente elimina l’intero documento shadow per il dispositivo denominato MyRPi.

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

Il comando non produce alcun output sullo schermo, ma output.txt contiene informazioni che confermano la versione e il timestamp del documento shadow eliminato.

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

Per ulteriori informazioni, consulta Uso delle copie shadow nella Guida per sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta DeleteThingShadow in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-thing-shadow.

AWS CLI

Come ottenere un documento shadow per l’oggetto

L’esempio get-thing-shadow seguente ottiene il documento shadow per l’elemento IoT specificato.

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

Il comando non restituisce output sullo schermo, ma di seguito è riportato il contenuto di output.txt:

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

Per ulteriori informazioni, consulta Flusso di dati del servizio Device Shadow nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta GetThingShadow in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-thing-shadow.

AWS CLI

Come aggiornare il device shadow di un oggetto

L’esempio update-thing-shadow seguente modifica lo stato corrente del device shadow per l’oggetto specificato e lo salva nel file output.txt.

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

Il comando non restituisce output sullo schermo, ma di seguito è riportato il contenuto di output.txt:

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

Per ulteriori informazioni, consulta Flusso di dati del servizio Device Shadow nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta UpdateThingShadow nella documentazione di riferimento dei comandi della AWS CLI.