

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Tipi di dati e operazioni API MQTT e HTTPS per i dispositivi per il servizio Jobs
<a name="jobs-mqtt-https-api"></a>

I comandi seguenti sono disponibili tramite i protocolli MQTT e HTTPS. Utilizza queste operazioni API sul piano dati per i dispositivi che eseguono i processi.

## Tipi di dati MQTT e HTTPS del dispositivo di processi
<a name="jobs-data-plane-data-types"></a>

I seguenti tipi di dati vengono utilizzati per comunicare con il servizio AWS IoT Jobs tramite i protocolli MQTT e HTTPS.

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

L'oggetto `JobExecution` rappresenta l'esecuzione di un processo in un dispositivo. L'esempio seguente mostra la sintassi:

**Nota**  
Quando si utilizzano le operazioni API MQTT e HTTP del piano dati, il tipo di dati `JobExecution` contiene un campo `JobDocument`. I dispositivi possono utilizzare queste informazioni per recuperare il documento di lavoro dall'esecuzione di un processo.

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

Per ulteriori informazioni, consulta [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) o [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` contiene informazioni sullo stato di esecuzione di un processo. L'esempio seguente mostra la sintassi:

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

Per ulteriori informazioni, consulta [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) o [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>

Contiene un sottoinsieme delle informazioni sull'esecuzione di un processo. L'esempio seguente mostra la sintassi:

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

Per ulteriori informazioni, consulta [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) o [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**
+ [Tipi di dati MQTT e HTTPS del dispositivo di processi](#jobs-data-plane-data-types)
+ [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md)
+ [API HTTP del dispositivo di processi](jobs-http-device-api.md)