AWS IoT
开发人员指南
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

StartNextPendingJobExecution

获取并启动事物的下一个待处理 (状态 IN_PROGRESS 或 QUEUED) 任务执行。

请求语法:

PUT /things/thingName/jobs/$next Content-type: application/json { "statusDetails": { "string": "string" } }

URI 请求参数:

名称

类型

请求?

描述

thingName

ThingName

与设备关联的事物的名称。

请求正文参数:

名称

类型

请求?

描述

statusDetails

DetailsMap

描述任务执行状态的名称/值对的集合。如果未指定,则 statusDetails 保持不变。

响应语法:

Content-type: application/json { "execution": { "jobId": "string", "thingName": "string", "status": "string", "statusDetails": { "string": "string" }, "queuedAt": "long", "startedAt": "long", "lastUpdatedAt": "long", "versionNumber": "long", "executionNumber": "long", "jobDocument": "string" } }

响应正文参数:

名称

类型

请求?

描述

execution

JobExecution

JobExecution 对象。

错误:

InvalidRequestException

请求的内容无效。例如,UpdateJobExecution 请求包含无效状态详细信息时,将返回此代码。消息包含有关错误的详细信息。

HTTP 响应代码:400

ResourceNotFoundException

指定的资源不存在。

HTTP 响应代码:404

ThrottlingException

速率超过限制。

HTTP 响应代码:429

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

CertificateValidationException

证书无效。

HTTP 响应代码:400

CLI

摘要:

aws iot-jobs-data start-next-pending-job-execution \ --thing-name <value> \ [--status-details <value>] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "thingName": "string", "statusDetails": { "string": "string" } }

cli-input-json 字段:

名称

类型

描述

thingName

字符串

最大长度:128,最小长度:1

模式:[a-zA-Z0-9:_-]+

与设备关联的事物的名称。

statusDetails

map

键:DetailsKey

值:DetailsValue

描述任务执行状态的名称/值对的集合。如果未指定,则 statusDetails 保持不变。

DetailsKey

字符串

最大长度:128,最小长度:1

模式:[a-zA-Z0-9:_-]+

DetailsValue

字符串

最大长度:1024,最小长度:1

模式:[^\\p{C}]*+

输出:

{ "execution": { "jobId": "string", "thingName": "string", "status": "string", "statusDetails": { "string": "string" }, "queuedAt": "long", "startedAt": "long", "lastUpdatedAt": "long", "versionNumber": "long", "executionNumber": "long", "jobDocument": "string" } }

cli 输出字段:

名称

类型

描述

execution

JobExecution

JobExecution 对象。

jobId

字符串

最大长度:64,最小长度:1

模式:[a-zA-Z0-9_-]+

您在创建此任务时向其分配的唯一标识符。

thingName

字符串

最大长度:128,最小长度:1

模式:[a-zA-Z0-9:_-]+

正在执行任务的事物的名称。

status

字符串

枚举:QUEUED | IN_PROGRESS | SUCCEEDED | FAILED | REJECTED | REMOVED | CANCELED

java 类:com.amazonaws.iot.laser.common.JobExecutionStatus

任务执行的状态。可以为以下值之一:“QUEUED"、“IN_PROGRESS”、“FAILED”、“SUCCESS”、“CANCELED”、“REJECTED”或“REMOVED”。

statusDetails

map

键:DetailsKey

值:DetailsValue

描述任务执行状态的名称/值对的集合。

DetailsKey

字符串

最大长度:128,最小长度:1

模式:[a-zA-Z0-9:_-]+

DetailsValue

字符串

最大长度:1024,最小长度:1

模式:[^\\p{C}]*+

queuedAt

long

任务执行入队的时间,用从纪元开始的毫秒数表示。

startedAt

long

java 类:java.lang.Long

任务执行开始的时间,用从纪元开始的毫秒数表示。

lastUpdatedAt

long

上次更新任务执行的时间,用从纪元开始的毫秒数表示。

versionNumber

long

任务执行的版本。每次设备更新任务执行版本时,版本将递增。

executionNumber

long

java 类:java.lang.Long

标识特定设备上的特定任务执行的数字。它可随后在返回或更新任务执行信息的命令中使用。

jobDocument

字符串

最大长度:32768

任务文档的内容。

本页内容: