D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

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 data exemples utilisant AWS CLI
<a name="cli_2_iot-data-plane_code_examples"></a>

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with AWS IoT data.

Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

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

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

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

L'exemple de code suivant montre comment utiliser`delete-thing-shadow`.

**AWS CLI**  
**Pour supprimer un cliché instantané d’appareil**  
L’exemple `delete-thing-shadow` suivant supprime l’intégralité du document de cliché instantané pour l’appareil nommé `MyRPi`.  

```
aws iot-data delete-thing-shadow \
    --thing-name MyRPi \
    "output.txt"
```
La commande ne produit aucune sortie à l’écran, mais le fichier `output.txt` contient des informations qui confirment la version et l’horodatage du document de cliché instantané que vous avez supprimé.  

```
{"version":2,"timestamp":1560270384}
```
Pour plus d’informations, consultez [Utilisation des shadows](https://docs.aws.amazon.com/iot/latest/developerguide/using-device-shadows.html) dans le *Guide du développeur AWS  IoT*.  
+  Pour plus de détails sur l'API, reportez-vous [DeleteThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/delete-thing-shadow.html)à la section *Référence des AWS CLI commandes*. 

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

L'exemple de code suivant montre comment utiliser`get-thing-shadow`.

**AWS CLI**  
**Pour obtenir un document de cliché instantané d’objet**  
L’exemple `get-thing-shadow` suivant obtient le document de cliché instantané correspondant à l’objet IoT spécifié.  

```
aws iot-data get-thing-shadow \
    --thing-name MyRPi \
    output.txt
```
La commande ne produit aucune sortie sur l’écran, mais ce qui suit montre le contenu du fichier `output.txt` :  

```
{
  "state":{
    "reported":{
    "moisture":"low"
    }
  },
  "metadata":{
    "reported":{
      "moisture":{
        "timestamp":1560269319
      }
    }
  },
  "version":1,"timestamp":1560269405
}
```
Pour plus d’informations, consultez [Flux de données du service de cliché instantané d’appareil](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-data-flow.html) dans le *Guide du développeur AWS  IoT*.  
+  Pour plus de détails sur l'API, reportez-vous [GetThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/get-thing-shadow.html)à la section *Référence des AWS CLI commandes*. 

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

L'exemple de code suivant montre comment utiliser`update-thing-shadow`.

**AWS CLI**  
**Pour mettre à jour un cliché instantané d’objet**  
L’exemple `update-thing-shadow` suivant modifie l’état actuel du cliché instantané d’appareil pour l’objet spécifié et l’enregistre dans le fichier `output.txt`.  

```
aws iot-data update-thing-shadow \
    --thing-name MyRPi \
    --payload "{"state":{"reported":{"moisture":"okay"}}}" \
    "output.txt"
```
La commande ne produit aucune sortie sur l’écran, mais ce qui suit montre le contenu du fichier `output.txt` :  

```
{
    "state": {
        "reported": {
            "moisture": "okay"
        }
    },
    "metadata": {
        "reported": {
            "moisture": {
                "timestamp": 1560270036
            }
        }
    },
    "version": 2,
    "timestamp": 1560270036
}
```
Pour plus d’informations, consultez [Flux de données du service de cliché instantané d’appareil](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-data-flow.html) dans le *Guide du développeur AWS  IoT*.  
+  Pour plus de détails sur l'API, reportez-vous [UpdateThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/update-thing-shadow.html)à la section *Référence des AWS CLI commandes*.