AWS IoT
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

GetPendingJobExecutions

GetPendingJobExecutions

获取未处于最终状态的事物的所有任务列表。

https

请求语法:

GET /things/thingName/jobs

URI 请求参数:

名称

类型

请求?

描述

thingName

ThingName

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

响应语法:

Content-type: application/json { "inProgressJobs": [ { "jobId": "string", "queuedAt": "long", "startedAt": "long", "lastUpdatedAt": "long", "versionNumber": "long", "executionNumber": "long" } ], "queuedJobs": [ { "jobId": "string", "queuedAt": "long", "startedAt": "long", "lastUpdatedAt": "long", "versionNumber": "long", "executionNumber": "long" } ] }

响应正文参数:

名称

类型

请求?

描述

inProgressJobs

JobExecutionSummaryList

状态为 IN_PROGRESS 的 JobExecutionSummary 对象的列表。

queuedJobs

JobExecutionSummaryList

状态为 QUEUED 的 JobExecutionSummary 对象的列表。

错误:

InvalidRequestException

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

HTTP 响应代码:400

ResourceNotFoundException

指定的资源不存在。

HTTP 响应代码:404

ThrottlingException

速率超过限制。

HTTP 响应代码:429

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

CertificateValidationException

证书无效。

HTTP 响应代码:400

cli

摘要:

aws iot-jobs-data get-pending-job-executions \ --thing-name <value> \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "thingName": "string" }

cli-input-json 字段:

名称

类型

描述

thingName

字符串

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

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

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

输出:

{ "inProgressJobs": [ { "jobId": "string", "queuedAt": "long", "startedAt": "long", "lastUpdatedAt": "long", "versionNumber": "long", "executionNumber": "long" } ], "queuedJobs": [ { "jobId": "string", "queuedAt": "long", "startedAt": "long", "lastUpdatedAt": "long", "versionNumber": "long", "executionNumber": "long" } ] }

cli 输出字段:

名称

类型

描述

inProgressJobs

列表

成员:JobExecutionSummary

java 类:java.util.List

状态为 IN_PROGRESS 的 JobExecutionSummary 对象的列表。

jobId

字符串

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

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

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

queuedAt

long

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

startedAt

long

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

lastUpdatedAt

long

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

versionNumber

long

任务执行的版本。每次 AWS IoT Jobs 从设备收到更新时,任务执行版本会递增。

executionNumber

long

标识特定设备上的特定任务执行的数字。

queuedJobs

列表

成员:JobExecutionSummary

java 类:java.util.List

状态为 QUEUED 的 JobExecutionSummary 对象的列表。

jobId

字符串

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

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

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

queuedAt

long

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

startedAt

long

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

lastUpdatedAt

long

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

versionNumber

long

任务执行的版本。每次 AWS IoT Jobs 从设备收到更新时,任务执行版本会递增。

executionNumber

long

标识特定设备上的特定任务执行的数字。

错误:

InvalidRequestException

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

ResourceNotFoundException

指定的资源不存在。

ThrottlingException

速率超过限制。

ServiceUnavailableException

服务暂时不可用。

CertificateValidationException

证书无效。