

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\_PROGRESS 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*. 