As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Tipos de dados e operações da API MQTT e HTTPS do dispositivo de trabalhos
<a name="jobs-mqtt-https-api"></a>

Os seguintes comandos estão disponíveis por meio dos protocolos MQTT e HTTPS. Use essas operações de API no plano de dados para dispositivos que executam os trabalhos.

## Tipos de dados MQTT e HTTPS de dispositivos de trabalho
<a name="jobs-data-plane-data-types"></a>

Os tipos de dados a seguir são usados para se comunicar com o serviço AWS IoT Jobs pelos protocolos MQTT e HTTPS.

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

O objeto `JobExecution` representa a execução de um trabalho em um dispositivo. O exemplo a seguir mostra a sintaxe:

**nota**  
Quando você usa as operações da API do plano de dados MQTT e HTTP, o tipo de dados `JobExecution` contém um campo `JobDocument`. Seus dispositivos podem usar essas informações para recuperar o documento de trabalho de uma execução de trabalho.

```
{
    "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
}
```

Para acessar mais informações, consulte [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>

O `JobExecutionState` contém informações sobre o estado da execução de um trabalho. O exemplo a seguir mostra a sintaxe:

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

Para acessar mais informações, consulte [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>

Contém um subconjunto de informações sobre a execução de um trabalho. O exemplo a seguir mostra a sintaxe:

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

Para acessar mais informações, consulte [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**
+ [Tipos de dados MQTT e HTTPS de dispositivos de trabalho](#jobs-data-plane-data-types)
+ [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md)
+ [API HTTP do dispositivo do Jobs](jobs-http-device-api.md)