Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Operaciones y tipos de datos de las API MQTT y HTTPS de dispositivos de Jobs
<a name="jobs-mqtt-https-api"></a>

Los siguientes comandos están disponibles a través de los protocolos MQTT y HTTPS. Utilice estas operaciones de API en el plano de datos para los dispositivos que ejecutan los trabajos.

## Tipos de datos de MQTT y HTTPS de dispositivos de Jobs
<a name="jobs-data-plane-data-types"></a>

Los siguientes tipos de datos se utilizan para comunicarse con el servicio AWS IoT Jobs a través de los protocolos MQTT y HTTPS.

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

El objeto `JobExecution` representa la ejecución de un trabajo en un dispositivo. En el siguiente ejemplo se muestra la sintaxis:

**nota**  
Cuando se utilizan las operaciones de la API del plano de datos HTTP y MQTT, el tipo de datos `JobExecution`contiene un campo `JobDocument`. Sus dispositivos pueden usar esta información para recuperar el documento de trabajo de la ejecución de un trabajo.

```
{
    "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 obtener más información, 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) 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>

El `JobExecutionState` contiene información sobre el estado de la ejecución de un trabajo. En el siguiente ejemplo se muestra la sintaxis:

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

Para obtener más información, 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) 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 una subred de información acerca de una ejecución de trabajo. En el siguiente ejemplo se muestra la sintaxis:

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

Para obtener más información, 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) 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**
+ [Tipos de datos de MQTT y HTTPS de dispositivos de Jobs](#jobs-data-plane-data-types)
+ [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md)
+ [API HTTP de dispositivos de Jobs](jobs-http-device-api.md)