

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.

# Lancement du SDK de tâches AWS IoT exemples utilisant AWS CLI
<a name="cli_iot-jobs-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 Lancement du SDK de tâches AWS IoT.

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>

### `describe-job-execution`
<a name="iot-jobs-data-plane_DescribeJobExecution_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`describe-job-execution`.

**AWS CLI**  
**Pour obtenir les informations relatives à une exécution de tâche**  
L’exemple `describe-job-execution` suivant extrait les informations de la dernière exécution de la tâche et de l’objet spécifiés.  

```
aws iot-jobs-data describe-job-execution \
    --job-id SampleJob \
    --thing-name MotionSensor1 \
    --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com
```
Sortie :  

```
{
    "execution": {
        "approximateSecondsBeforeTimedOut": 88,
        "executionNumber": 2939653338,
        "jobId": "SampleJob",
        "lastUpdatedAt": 1567701875.743,
        "queuedAt": 1567701902.444,
        "status": "QUEUED",
        "thingName": "MotionSensor1 ",
        "versionNumber": 3
   }
}
```
Pour plus d’informations, consultez [Appareils et tâches](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) dans le *Guide du développeur AWS  IoT*.  
+  Pour plus de détails sur l'API, reportez-vous [DescribeJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/describe-job-execution.html)à la section *Référence des AWS CLI commandes*. 

### `get-pending-job-executions`
<a name="iot-jobs-data-plane_GetPendingJobExecutions_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`get-pending-job-executions`.

**AWS CLI**  
**Pour obtenir une liste de toutes les tâches d’un objet qui ne se trouvent pas dans un statut terminal**  
L’exemple `get-pending-job-executions` suivant affiche la liste de toutes les tâches qui ne sont pas dans un état terminal pour l’objet spécifié.  

```
aws iot-jobs-data get-pending-job-executions \
    --thing-name MotionSensor1
    --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com
```
Sortie :  

```
{
    "inProgressJobs": [
    ],
    "queuedJobs": [
        {
            "executionNumber": 2939653338,
            "jobId": "SampleJob",
            "lastUpdatedAt": 1567701875.743,
            "queuedAt": 1567701902.444,
            "versionNumber": 3
      }
    ]
}
```
Pour plus d’informations, consultez [Appareils et tâches](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) dans le *Guide du développeur AWS  IoT*.  
+  Pour plus de détails sur l'API, reportez-vous [GetPendingJobExecutions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/get-pending-job-executions.html)à la section *Référence des AWS CLI commandes*. 

### `start-next-pending-job-execution`
<a name="iot-jobs-data-plane_StartNextPendingJobExecution_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`start-next-pending-job-execution`.

**AWS CLI**  
**Pour obtenir et démarrer l’exécution de la prochaine tâche en attente pour un objet**  
L’exemple `start-next-pending-job-execution` suivant extrait et démarre l’exécution de la tâche suivante dont le statut est IN\$1PROGRESS ou QUEUED pour l’objet spécifié.  

```
aws iot-jobs-data start-next-pending-job-execution \
    --thing-name MotionSensor1
    --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com
```
Sortie :  

```
{
    "execution": {
        "approximateSecondsBeforeTimedOut": 88,
        "executionNumber": 2939653338,
        "jobId": "SampleJob",
        "lastUpdatedAt": 1567714853.743,
        "queuedAt": 1567701902.444,
        "startedAt": 1567714871.690,
        "status": "IN_PROGRESS",
        "thingName": "MotionSensor1 ",
        "versionNumber": 3
   }
}
```
Pour plus d’informations, consultez [Appareils et tâches](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) dans le *Guide du développeur AWS  IoT*.  
+  Pour plus de détails sur l'API, reportez-vous [StartNextPendingJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/start-next-pending-job-execution.html)à la section *Référence des AWS CLI commandes*. 

### `update-job-execution`
<a name="iot-jobs-data-plane_UpdateJobExecution_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`update-job-execution`.

**AWS CLI**  
**Pour mettre à jour le statut d’une exécution de tâche**  
L’exemple `update-job-execution` met à jour le statut de la tâche et de l’objet spécifiés.  

```
aws iot-jobs-data update-job-execution \
    --job-id SampleJob \
    --thing-name MotionSensor1 \
    --status REMOVED \
    --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com
```
Sortie :  

```
{
    "executionState": {
        "status": "REMOVED",
        "versionNumber": 3
    },
}
```
Pour plus d’informations, consultez [Appareils et tâches](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) dans le *Guide du développeur AWS  IoT*.  
+  Pour plus de détails sur l'API, reportez-vous [UpdateJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/update-job-execution.html)à la section *Référence des AWS CLI commandes*. 