# AWS IoT data Ejemplos de usando AWS CLI
<a name="cli_iot-data-plane_code_examples"></a>

En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con AWS IoT data.

Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

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

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

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

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-thing-shadow`.

**AWS CLI**  
**Para eliminar un documento de sombra de dispositivo**  
En el siguiente ejemplo de `delete-thing-shadow`, se elimina el documento de sombra completo del dispositivo denominado `MyRPi`.  

```
aws iot-data delete-thing-shadow \
    --thing-name MyRPi \
    "output.txt"
```
El comando no muestra ningún resultado en la pantalla, pero `output.txt` contiene información que confirma la versión y la marca de tiempo del documento de sombra que ha eliminado.  

```
{"version":2,"timestamp":1560270384}
```
Para obtener más información, consulte [Using Shadows](https://docs.aws.amazon.com/iot/latest/developerguide/using-device-shadows.html) en la *Guía para desarrolladores de AWS IoT*.  
+  Para obtener más información sobre la API, consulte [DeleteThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/delete-thing-shadow.html) en la *Referencia de comandos de la AWS CLI*. 

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

En el siguiente ejemplo de código, se muestra cómo utilizar `get-thing-shadow`.

**AWS CLI**  
**Para obtener un documento de sombra de objeto**  
En el siguiente ejemplo de `get-thing-shadow`, se obtiene el documento de sombra del objeto de IoT especificado.  

```
aws iot-data get-thing-shadow \
    --thing-name MyRPi \
    output.txt
```
El comando no muestra ningún resultado en la pantalla, pero a continuación aparece el contenido de `output.txt`:  

```
{
  "state":{
    "reported":{
    "moisture":"low"
    }
  },
  "metadata":{
    "reported":{
      "moisture":{
        "timestamp":1560269319
      }
    }
  },
  "version":1,"timestamp":1560269405
}
```
Para obtener más información, consulte [Device Shadow Service Data Flow](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-data-flow.html) en la *Guía para desarrolladores de AWS IoT*.  
+  Para obtener más información sobre la API, consulte [GetThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/get-thing-shadow.html) en la *Referencia de comandos de la AWS CLI*. 

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

En el siguiente ejemplo de código, se muestra cómo utilizar `update-thing-shadow`.

**AWS CLI**  
**Para actualizar una sombra de objeto**  
El siguiente ejemplo de `update-thing-shadow` modifica el estado actual de la sombra de dispositivo para el objeto especificado y lo guarda en el archivo `output.txt`.  

```
aws iot-data update-thing-shadow \
    --thing-name MyRPi \
    --payload "{"state":{"reported":{"moisture":"okay"}}}" \
    "output.txt"
```
El comando no muestra ningún resultado en la pantalla, pero a continuación aparece el contenido de `output.txt`:  

```
{
    "state": {
        "reported": {
            "moisture": "okay"
        }
    },
    "metadata": {
        "reported": {
            "moisture": {
                "timestamp": 1560270036
            }
        }
    },
    "version": 2,
    "timestamp": 1560270036
}
```
Para obtener más información, consulte [Device Shadow Service Data Flow](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-data-flow.html) en la *Guía para desarrolladores de AWS IoT*.  
+  Para obtener más información sobre la API, consulte [UpdateThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/update-thing-shadow.html) en la *Referencia de comandos de la AWS CLI*.