Esempi di AWS IoT data con la AWS CLI - AWS Command Line Interface
Operazioni

Esempi di AWS IoT data con la AWS CLI

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

Le operazioni 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, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

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

AWS CLI

Come eliminare il documento shadow di un dispositivo

Nell’esempio seguente delete-thing-shadow 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

Nell’esempio seguente get-thing-shadow 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 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 la copia shadow di un oggetto

Nell’esempio seguente update-thing-shadow 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 sviluppatori di AWS IoT.

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