Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# AWS IoT data ejemplos que utilizan AWS CLI
<a name="cli_2_iot-data-plane_code_examples"></a>

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS Command Line Interface with 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_2_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)la *Referencia de AWS CLI comandos*. 

### `get-thing-shadow`
<a name="iot-data-plane_GetThingShadow_cli_2_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)la *Referencia de AWS CLI comandos*. 

### `update-thing-shadow`
<a name="iot-data-plane_UpdateThingShadow_cli_2_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)la *Referencia de AWS CLI comandos*.