本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 任务设备 MQTT 和 HTTPS API 操作以及数据类型
<a name="jobs-mqtt-https-api"></a>

可通过 MQTT 和 HTTPS 协议使用以下命令。在数据面板上对执行任务的设备使用这些 API 操作。

## 任务设备 MQTT 和 HTTPS 数据类型
<a name="jobs-data-plane-data-types"></a>

以下数据类型用于通过 MQTT 和 HTTPS 协议与 AWS IoT 作业服务通信。

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

`JobExecution` 对象表示设备上的任务执行。以下示例显示该语法：

**注意**  
当您使用 MQTT 和 HTTP 数据面板 API 操作时，`JobExecution` 数据类型包含 `JobDocument` 字段。您的设备可以使用此信息从任务执行中检索任务文档。

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

有关更多信息，请参阅 [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)或 [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` 包含有关任务执行的状态的信息。以下示例显示该语法：

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

有关更多信息，请参阅 [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)或 [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>

包含有关任务执行的信息的子集。以下示例显示该语法：

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

有关更多信息，请参阅 [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)或 [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**
+ [任务设备 MQTT 和 HTTPS 数据类型](#jobs-data-plane-data-types)
+ [任务设备 MQTT API 操作](jobs-mqtt-api.md)
+ [任务设备 HTTP API](jobs-http-device-api.md)