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.

# Opérations des API MQTT et HTTPS de l’appareil et types de données
<a name="jobs-mqtt-https-api"></a>

Les commandes suivantes sont disponibles sur les protocoles HTTPS et MQTT. Utilisez ces opérations d’API sur le plan de données pour les appareils exécutant les tâches.

## Types de données MQTT et HTTPS pour les appareils de tâches
<a name="jobs-data-plane-data-types"></a>

Les types de données suivants sont utilisés pour communiquer avec le service AWS IoT Jobs via les protocoles MQTT et HTTPS.

### JobExecution
<a name="jobs-mqtt-job-execution-data"></a>

L'objet `JobExecution` représente l'exécution d'une tâche sur un appareil. L'exemple suivant montre la syntaxe :

**Note**  
Lorsque vous utilisez les opérations de l’API du plan de données MQTT et HTTP, le type de données `JobExecution` contient un champ `JobDocument`. Vos appareils peuvent utiliser ces informations pour récupérer le document de tâche à partir d’une exécution de tâche.

```
{
    "jobId" : "string",
    "thingName" : "string",
    "jobDocument" : "string",
    "status": "QUEUED|IN_PROGRESS|FAILED|SUCCEEDED|CANCELED|TIMED_OUT|REJECTED|REMOVED",
    "statusDetails": {
        "string": "string"
    },
    "queuedAt" : "timestamp",
    "startedAt" : "timestamp",
    "lastUpdatedAt" : "timestamp",
    "versionNumber" : "number",
    "executionNumber": long
}
```

Pour plus d’informations, consultez [https://docs.aws.amazon.com/iot/latest/apireference/API_iot-jobs-data_JobExecution.html](https://docs.aws.amazon.com/iot/latest/apireference/API_iot-jobs-data_JobExecution.html) ou [https://docs.aws.amazon.com/cli/latest/reference/iot-data/job-execution.html](https://docs.aws.amazon.com/cli/latest/reference/iot-data/job-execution.html).

### JobExecutionState
<a name="jobs-mqtt-job-execution-state"></a>

`JobExecutionState` contient des informations sur le statut d’exécution d’une tâche. L'exemple suivant montre la syntaxe :

```
{
    "status": "QUEUED|IN_PROGRESS|FAILED|SUCCEEDED|CANCELED|TIMED_OUT|REJECTED|REMOVED",
    "statusDetails": {
        "string": "string"
        ...
    }
    "versionNumber": "number"
}
```

Pour plus d’informations, consultez [https://docs.aws.amazon.com/iot/latest/apireference/API_iot-jobs-data_JobExecutionState.html](https://docs.aws.amazon.com/iot/latest/apireference/API_iot-jobs-data_JobExecutionState.html) ou [https://docs.aws.amazon.com/cli/latest/reference/iot-data/job-execution-state.html](https://docs.aws.amazon.com/cli/latest/reference/iot-data/job-execution-state.html).

### JobExecutionSummary
<a name="jobs-mqtt-job-execution-summary"></a>

Contient un sous-ensemble d'informations sur une exécution de tâche. L'exemple suivant montre la syntaxe :

```
{
    "jobId": "string",
    "queuedAt": timestamp,
    "startedAt": timestamp,
    "lastUpdatedAt": timestamp,
    "versionNumber": "number",
    "executionNumber": long 
}
```

Pour plus d’informations, consultez [https://docs.aws.amazon.com/iot/latest/apireference/API_iot-jobs-data_JobExecutionSummary.html](https://docs.aws.amazon.com/iot/latest/apireference/API_iot-jobs-data_JobExecutionSummary.html) ou [https://docs.aws.amazon.com/cli/latest/reference/iot-data/job-execution-summary.html](https://docs.aws.amazon.com/cli/latest/reference/iot-data/job-execution-summary.html).

**Topics**
+ [Types de données MQTT et HTTPS pour les appareils de tâches](#jobs-data-plane-data-types)
+ [Opérations de l’API MQTT de l’appareil des tâches](jobs-mqtt-api.md)
+ [API HTTP de l’appareil de tâches](jobs-http-device-api.md)