本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 任務裝置 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 Jobs 服務通訊。

### 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)