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 Biblioteca Device Shadow
<a name="freertos-lib-cloud-shadows"></a>

**nota**  <a name="out-of-date-message"></a>
O conteúdo desta página pode não estar atualizado. Consulte a [página da FreeRTOS.org biblioteca](https://www.freertos.org/Documentation/03-Libraries/01-Library-overview/01-All-libraries) para obter a atualização mais recente.

## Introdução
<a name="freertos-shadow-introduction"></a>

Você pode usar a biblioteca AWS IoT Device Shadow para armazenar e recuperar o estado atual (a *sombra*) de cada dispositivo registrado. A sombra do dispositivo é uma representação virtual persistente do seu dispositivo com a qual você pode interagir em suas aplicações da web mesmo se o dispositivo estiver offline. O estado do dispositivo é capturado assim como o da sua sombra em um documento [JSON](https://www.json.org/). Você pode enviar comandos para o serviço AWS IoT Device Shadow via MQTT ou HTTP para consultar o estado mais recente do dispositivo conhecido ou para alterar o estado. A sombra de cada dispositivo é identificada exclusivamente pelo nome da *coisa* correspondente, pela representação de um dispositivo específico ou entidade lógica na nuvem da AWS . Para obter mais informações, consulte [ Gerenciamento de dispositivos no AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-thing-management.html). Mais detalhes sobre sombras podem ser encontrados na [Documentação do AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html). 

A biblioteca AWS IoT Device Shadow não depende de bibliotecas adicionais além da biblioteca C padrão. Ela também não depende de plataformas, como threading ou sincronização. Ela pode ser usada com toda biblioteca MQTT e toda biblioteca JSON. 

Essa biblioteca pode ser usada gratuitamente e é distribuída sob a [ licença de código aberto do MIT](https://freertos.org/a00114.html).


****  
<a name="shadow-memory-estimate"></a>
<table>
<thead>
  <tr><th colspan="3">Tamanho do código do AWS IoT Device Shadow (exemplo gerado com GCC para ARM Cortex-M)</th></tr>
  <tr><th>Arquivo</th><th>Com otimização -O1</th><th>Com otimização: Os</th></tr>
</thead>
<tbody>
  <tr><td>shadow.c</td><td>1,2 K</td><td>0,9 K</td></tr>
  <tr><td>Estimativas totais</td><td>1,2 K</td><td>0,9 K</td></tr>
</tbody>
</table>