Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# AWS IoT data esempi utilizzando AWS CLI
<a name="cli_iot-data-plane_code_examples"></a>

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

Le *azioni* sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni 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.

**Topics**
+ [Azioni](#actions)

## Azioni
<a name="actions"></a>

### `delete-thing-shadow`
<a name="iot-data-plane_DeleteThingShadow_cli_topic"></a>

Il seguente esempio di codice 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](https://docs.aws.amazon.com/iot/latest/developerguide/using-device-shadows.html) nella *Guida per sviluppatori di AWS IoT*.  
+  Per i dettagli sull'API, consulta [DeleteThingShadow AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/delete-thing-shadow.html)*Command Reference*. 

### `get-thing-shadow`
<a name="iot-data-plane_GetThingShadow_cli_topic"></a>

Il seguente esempio di codice 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](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-data-flow.html) nella *Guida per gli sviluppatori di AWS IoT*.  
+  Per i dettagli sull'API, consulta [GetThingShadow AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/get-thing-shadow.html)*Command Reference*. 

### `update-thing-shadow`
<a name="iot-data-plane_UpdateThingShadow_cli_topic"></a>

Il seguente esempio di codice 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](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-data-flow.html) nella *Guida per gli sviluppatori di AWS IoT*.  
+  Per i dettagli sull'API, consulta [UpdateThingShadow AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/update-thing-shadow.html)*Command Reference*.