Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# AWS IoT Bibliothèque Device Shadow
<a name="freertos-lib-cloud-shadows"></a>

**Note**  <a name="out-of-date-message"></a>
Le contenu de cette page n'est peut-être pas à jour. Reportez-vous à la [page de la FreeRTOS.org bibliothèque](https://www.freertos.org/Documentation/03-Libraries/01-Library-overview/01-All-libraries) pour la dernière mise à jour.

## Introduction
<a name="freertos-shadow-introduction"></a>

Vous pouvez utiliser la bibliothèque AWS IoT Device Shadow pour stocker et récupérer l'état actuel (l'*ombre*) de chaque appareil enregistré. L'ombre de l'appareil est une représentation virtuelle persistante de votre appareil avec laquelle vous pouvez interagir dans vos applications Web même si l'appareil est hors ligne. L'état de l'appareil est capturé sous forme d'ombre dans un document [JSON](https://www.json.org/). Vous pouvez envoyer des commandes au service AWS IoT Device Shadow via MQTT ou HTTP pour demander le dernier état connu du périphérique ou pour le modifier. L'ombre de chaque appareil est identifiée de manière unique par le nom de l'*objet* correspondant, une représentation d'un appareil spécifique ou d'une entité logique sur le AWS Cloud. Pour plus d'informations, consultez [la section Gestion des appareils avec AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-thing-management.html). Vous trouverez plus de détails sur les ombres dans [AWS IoT la documentation](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html). 

La bibliothèque AWS IoT Device Shadow ne dépend pas de bibliothèques supplémentaires autres que la bibliothèque C standard. Il n'a pas non plus de dépendance à la plate-forme, telle que le threading ou la synchronisation. Il peut être utilisé avec n'importe quelle bibliothèque MQTT et n'importe quelle bibliothèque JSON. 

Cette bibliothèque peut être utilisée librement et est distribuée sous la [licence open source du MIT](https://freertos.org/a00114.html).


****  
<a name="shadow-memory-estimate"></a>
<table>
<thead>
  <tr><th colspan="3">Taille du code de AWS IoT Device Shadow (exemple généré avec GCC pour ARM Cortex-M)</th></tr>
  <tr><th>Fichier</th><th>Avec optimisation -O1</th><th>Avec l'optimisation -Os</th></tr>
</thead>
<tbody>
  <tr><td>shadow.c</td><td>1,2 K</td><td>0,9 K</td></tr>
  <tr><td>Estimations totales</td><td>1,2 K</td><td>0,9 K</td></tr>
</tbody>
</table>