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

ListOTAUpdates

ListOTAUpdates

列出 OTA 更新。

https

请求语法:

GET /otaUpdates?maxResults=maxResults&nextToken=nextToken&otaUpdateStatus=otaUpdateStatus

URI 请求参数:

名称

类型

请求?

描述

maxResults

MaxResults

一次性返回的最大结果数。

nextToken

NextToken

用于检索下一组结果的令牌。

otaUpdateStatus

OTAUpdateStatus

OTA 更新任务状态。

响应语法:

Content-type: application/json { "otaUpdates": [ { "otaUpdateId": "string", "otaUpdateArn": "string", "creationDate": "timestamp" } ], "nextToken": "string" }

响应正文参数:

名称

类型

请求?

描述

otaUpdates

OTAUpdatesSummary

OTA 更新任务列表。

nextToken

NextToken

用于获取下一组结果的令牌。

错误:

InvalidRequestException

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

HTTP 响应代码:400

ThrottlingException

速率超过限制。

HTTP 响应代码:429

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

InternalFailureException

出现意外错误。

HTTP 响应代码:500

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

cli

摘要:

aws iot list-ota-updates \ [--max-results <value>] \ [--next-token <value>] \ [--ota-update-status <value>] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "maxResults": "integer", "nextToken": "string", "otaUpdateStatus": "string" }

cli-input-json 字段:

名称

类型

描述

maxResults

integer

范围 - 最大值:250,最小值:1

一次性返回的最大结果数。

nextToken

字符串

用于检索下一组结果的令牌。

otaUpdateStatus

字符串

OTA 更新任务状态。

枚举:CREATE_PENDING | CREATE_IN_PROGRESS | CREATE_COMPLETE | CREATE_FAILED

输出:

{ "otaUpdates": [ { "otaUpdateId": "string", "otaUpdateArn": "string", "creationDate": "timestamp" } ], "nextToken": "string" }

cli 输出字段:

名称

类型

描述

otaUpdates

列表

成员:OTAUpdateSummary

OTA 更新任务列表。

otaUpdateId

字符串

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

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

OTA 更新 ID。

otaUpdateArn

字符串

OTA 更新 ARN。

creationDate

timestamp

创建 OTA 更新的日期。

nextToken

字符串

用于获取下一组结果的令牌。

错误:

InvalidRequestException

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

ThrottlingException

速率超过限制。

UnauthorizedException

您没有权限执行此操作。

InternalFailureException

出现意外错误。

ServiceUnavailableException

服务暂时不可用。