기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 작업 디바이스 MQTT API 및 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)