작업 디바이스 MQTT API 작업

지정된 사물에 대해 종료 상태가 아닌 사물의 모든 작업 목록을 가져옵니다.

이 API를 호출하려면 $aws/things/thingName/jobs/get 주제에 메시지를 게시합니다.

요청 페이로드:

{ "clientToken": "string" }

메시지 브로커는 특정 구독 없이도 $aws/things/thingName/jobs/get/accepted와 $aws/things/thingName/jobs/get/rejected를 게시합니다. 그러나 클라이언트가 메시지를 수신하려면 메시지를 수신 대기해야 합니다. 자세한 내용은 작업 API 메시지에 대한 참고 사항을 참조하세요.

응답 페이로드:

{
"inProgressJobs" : [ JobExecutionSummary ... ], 
"queuedJobs" : [ JobExecutionSummary ... ],
"timestamp" : 1489096425069,
"clientToken" : "client-001"
}

여기서 inProgressJobs 및 queuedJobs에서는 상태가 IN_PROGRESS 또는 QUEUED인 JobExecutionSummary 객체 목록을 반환합니다.

사물의 다음 번 대기 중 작업 실행을 가져오고 시작합니다(IN_PROGRESS 또는 QUEUED 상태).

이 API를 호출하려면 $aws/things/thingName/jobs/start-next 주제에 메시지를 게시합니다.

요청 페이로드:

{ 
"statusDetails": {
    "string": "job-execution-state"
    ...
},
"stepTimeoutInMinutes": long,
"clientToken": "string"
}

메시지 브로커는 특정 구독 없이도 $aws/things/thingName/jobs/start-next/accepted와 $aws/things/thingName/jobs/start-next/rejected를 게시합니다. 그러나 클라이언트가 메시지를 수신하려면 메시지를 수신 대기해야 합니다. 자세한 내용은 작업 API 메시지에 대한 참고 사항을 참조하세요.

응답 페이로드:

{
"execution" : JobExecutionData,
"timestamp" : timestamp,
"clientToken" : "string"
}

여기서 execution은 JobExecution 객체입니다. 예:

{
"execution" : {
    "jobId" : "022",
    "thingName" : "MyThing",
    "jobDocument" : "< contents of job document >",
    "status" : "IN_PROGRESS",
    "queuedAt" : 1489096123309,
    "lastUpdatedAt" : 1489096123309,
    "versionNumber" : 1,
    "executionNumber" : 1234567890
},
"clientToken" : "client-1",
"timestamp" : 1489088524284,
}

작업 실행에 대한 세부 정보를 가져옵니다.

jobId를 $next로 설정하여 다음 대기 중인(IN_PROGRESS 또는 QUEUED 상태) 사물의 작업 실행을 반환할 수 있습니다.

이 API를 호출하려면 $aws/things/thingName/jobs/jobId/get 주제에 메시지를 게시합니다.

요청 페이로드:

{ 
"jobId" : "022",
"thingName" : "MyThing",
"executionNumber": long,
"includeJobDocument": boolean,
"clientToken": "string" 
}

메시지 브로커는 특정 구독 없이도 $aws/things/thingName/jobs/jobId/get/accepted와 $aws/things/thingName/jobs/jobId/get/rejected를 게시합니다. 그러나 클라이언트가 메시지를 수신하려면 메시지를 수신 대기해야 합니다. 자세한 내용은 작업 API 메시지에 대한 참고 사항을 참조하세요.

응답 페이로드:

{
"execution" : JobExecutionData,
"timestamp": "timestamp",
"clientToken": "string"
}

여기서 execution은 JobExecution 객체입니다.

작업 실행의 상태를 업데이트합니다. stepTimeoutInMinutes 속성에 대한 값을 설정하여 단계 타이머를 선택적으로 추가할 수 있습니다. UpdateJobExecution를 다시 실행하여 이 속성 값을 업데이트하지 않은 경우 단계 타이머가 만료할 때 작업 실행이 시간 초과됩니다.

이 API를 호출하려면 $aws/things/thingName/jobs/jobId/update 주제에 메시지를 게시합니다.

요청 페이로드:

{
"status": "job-execution-state",
"statusDetails": { 
    "string": "string"
    ...
},
"expectedVersion": "number",
"executionNumber": long,
"includeJobExecutionState": boolean,
"includeJobDocument": boolean,
"stepTimeoutInMinutes": long,
"clientToken": "string"
}

메시지 브로커는 특정 구독 없이도 $aws/things/thingName/jobs/jobId/update/accepted와 $aws/things/thingName/jobs/jobId/update/rejected를 게시합니다. 그러나 클라이언트가 메시지를 수신하려면 메시지를 수신 대기해야 합니다. 자세한 내용은 작업 API 메시지에 대한 참고 사항을 참조하세요.

응답 페이로드:

{
"executionState": JobExecutionState,
"jobDocument": "string",
"timestamp": timestamp,
"clientToken": "string"
}

대기 중인 사물의 작업 실행 목록에 작업 실행이 추가되거나 제거될 때마다 전송됩니다.

다음 주제를 사용합니다.

$aws/things/thingName/jobs/notify

메시지 페이로드:

{
"jobs" : {
    "JobExecutionState": [ JobExecutionSummary ... ]
         },
    "timestamp": timestamp
}
                     

jobId $next를 사용하는 DescribeJobExecution에서 정의한 바와 같이 대기 중인 사물의 작업 실행 목록에서 다음 작업 실행에 변경 사항이 있을 때마다 전송됩니다. 다음 작업의 실행 세부 정보가 변경될 때는 전송되지 않으며, 오직 jobId $next를 사용한 DescribeJobExecution에서 반환되는 다음 작업이 변경되었을 때만 전송됩니다. 예들 들어 작업 실행 J1과 J2가 QUEUED 상태라고 가정하겠습니다. J1은 대기 중인 작업 실행 목록에서 다음 작업 실행입니다. 이때 J1의 상태는 아무런 변화가 없는데 J2의 상태가 IN_PROGRESS로 바뀐다면 이 알림 메시지가 J2의 세부 정보와 함께 전송됩니다.

다음 주제를 사용합니다.

$aws/things/thingName/jobs/notify-next

메시지 페이로드:

{
"execution" : JobExecution,
"timestamp": timestamp,
}