设备接入 IOTDA-创建OTA升级包:响应参数

时间:2024-06-28 09:24:45

响应参数

状态码: 201

表6 响应Body参数

参数

参数类型

描述

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'"。

file_location

FileLocation object

升级包的位置

表7 FileLocation

参数

参数类型

描述

obs_location

ObsLocation object

升级包关联OBS对象位置

表8 ObsLocation

参数

参数类型

描述

region_name

String

参数说明:OBS所在区域。您可以从地区和终端节点中查询服务的终端节点。 取值范围:长度不超过256,只允许字母、数字、连接符(-)的组合。

bucket_name

String

参数说明:OBS桶名称。 取值范围:长度最小为3,最大为63,只允许小写字母、数字、连接符(-)、英文点(.)的组合。

object_key

String

参数说明:OBS对象名称(包含文件夹路径),对象大小最大为1G,且只支持.bin、.dav、.tar、.gz、.zip、.gzip、.apk、.tar.gz、.tar.xz、.pack、.exe、.bat、.img格式的文件。 取值范围:长度不超过1024。

最小长度:1

最大长度:1024

sign

String

参数说明:SHA256算法计算出的升级包签名值。添加该升级包完成,并创建升级任务后,物联网平台向设备下发升级通知时,会下发该签名给设备。 取值范围:长度为64,只允许大小写字母a到f、数字的组合。

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