设备接入 IOTDA-查询OTA升级包列表:响应参数

时间:2024-03-28 19:28:10

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

packages

Array of OtaPackageInfo objects

升级包列表

page

PageInfo object

查询批量分页结构体,定义了分页页码、每页记录数、记录总数、该页记录的最大Id。

表5 OtaPackageInfo

参数

参数类型

描述

package_id

String

参数说明:升级包ID,用于唯一标识一个升级包。由物联网平台分配获得。 取值范围:长度不超过36,只允许字母、数字、连接符(-)的组合。

app_id

String

参数说明:资源空间ID。 取值范围:长度不超过36,只允许字母、数字、下划线(_)、连接符(-)的组合。

package_type

String

参数说明:升级包类型。 取值范围:软件包必须设置为:softwarePackage,固件包必须设置为:firmwarePackage。

product_id

String

参数说明:设备关联的产品ID,用于唯一标识一个产品模型,创建产品后获得。方法请参见 创建产品取值范围:长度不超过36,只允许字母、数字、下划线(_)、连接符(-)的组合。

version

String

参数说明:升级包版本号。 取值范围:长度不超过256,只允许字母、数字、下划线(_)、连接符(-)、英文点(.)的组合。

support_source_versions

Array of strings

参数说明:支持用于升级此版本包的设备源版本号列表。最多支持20个源版本号。 取值范围:源版本号列表,源版本号只允许字母、数字、下划线(_)、连接符(-)、英文点(.)的组合。

description

String

参数说明:用于描述升级包的功能等信息。 取值范围:长度不超过1024。

custom_info

String

参数说明:推送给设备的自定义信息。添加该升级包完成,并创建升级任务后,物联网平台向设备下发升级通知时,会下发该自定义信息给设备。 取值范围:长度不超过4096。

create_time

String

软固件包上传到物联网平台的时间,格式:"yyyyMMdd'T'HHmmss'Z'"。

表6 PageInfo

参数

参数类型

描述

count

Long

满足查询条件的记录总数。

marker

String

本次分页查询结果中最后一条记录的ID,可在下一次分页查询时使用。

support.huaweicloud.com/api-iothub/ListOtaPackageInfo.html