翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ジョブデバイス 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)
+ [ジョブデバイス MQTT API](jobs-http-device-api.md)