Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# AWS IoT data exemplos usando AWS CLI
<a name="cli_2_iot-data-plane_code_examples"></a>

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface with AWS IoT data.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

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

O código de exemplo a seguir mostra como usar `delete-thing-shadow`.

**AWS CLI**  
**Para excluir um documento de sombra do dispositivo**  
O exemplo `delete-thing-shadow` a seguir exclui todo o documento de sombra do dispositivo chamado `MyRPi`.  

```
aws iot-data delete-thing-shadow \
    --thing-name MyRPi \
    "output.txt"
```
O comando não produz saída na tela, mas `output.txt` contém informações que confirmam a versão e a data e hora da do documento de sombra excluído.  

```
{"version":2,"timestamp":1560270384}
```
Para obter mais informações, consulte [Usar sombras](https://docs.aws.amazon.com/iot/latest/developerguide/using-device-shadows.html) no *Guia do desenvolvedor da AWS IoT*.  
+  Para obter detalhes da API, consulte [DeleteThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/delete-thing-shadow.html)em *Referência de AWS CLI Comandos*. 

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

O código de exemplo a seguir mostra como usar `get-thing-shadow`.

**AWS CLI**  
**Para obter um documento de sombra de item**  
O exemplo `get-thing-shadow` a seguir obtém o documento de sombra do item para o item IoT especificado.  

```
aws iot-data get-thing-shadow \
    --thing-name MyRPi \
    output.txt
```
O comando não produz nenhuma saída na tela, mas o seguinte mostra o conteúdo de `output.txt`:  

```
{
  "state":{
    "reported":{
    "moisture":"low"
    }
  },
  "metadata":{
    "reported":{
      "moisture":{
        "timestamp":1560269319
      }
    }
  },
  "version":1,"timestamp":1560269405
}
```
Para obter mais informações, consulte [Fluxo de dados da sombra do dispositivo](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-data-flow.html) no *Guia do desenvolvedor da AWS IoT*.  
+  Para obter detalhes da API, consulte [GetThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/get-thing-shadow.html)em *Referência de AWS CLI Comandos*. 

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

O código de exemplo a seguir mostra como usar `update-thing-shadow`.

**AWS CLI**  
**Para atualizar uma sombra de item**  
O exemplo `update-thing-shadow` a seguir modifica o estado atual da sombra do dispositivo para o item especificado e o salva no arquivo `output.txt`.  

```
aws iot-data update-thing-shadow \
    --thing-name MyRPi \
    --payload "{"state":{"reported":{"moisture":"okay"}}}" \
    "output.txt"
```
O comando não produz nenhuma saída na tela, mas o seguinte mostra o conteúdo de `output.txt`:  

```
{
    "state": {
        "reported": {
            "moisture": "okay"
        }
    },
    "metadata": {
        "reported": {
            "moisture": {
                "timestamp": 1560270036
            }
        }
    },
    "version": 2,
    "timestamp": 1560270036
}
```
Para obter mais informações, consulte [Fluxo de dados da sombra do dispositivo](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-data-flow.html) no *Guia do desenvolvedor da AWS IoT*.  
+  Para obter detalhes da API, consulte [UpdateThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/update-thing-shadow.html)em *Referência de AWS CLI Comandos*.