3. 下载包
功能描述:
下载压缩包。
参数描述(JSON格式):
method
string
无
必选
download_package
“download_package”
messageId
string
空
可选
MQ消息的唯一标识ID
“004a5b58-32e8-487e-a90a-2ce443877e7e”
download_package_info
dict
无
必选
{}
package_name
string
无
必选
下载包名称。1、如果有其他需要执行得操作,在压缩包里可以放入执行脚本run.sh, 该脚本为启动脚本,且名称必须为run.sh。2、脚本中执行成功最后必须echo "excute success", 告知成功,否则视为失败。 3、如果有重启得操作,请用echo "need reboot"告知重启, 不能直接"reboot"重启。
package_download_link
string
无
必选
下载地址,下载包为tar.gz包格式。
package_size
float
无
必选
下载包得大小, 单位为M,当该值为0时,不进行下载操作
0.34
package_md5
string
无
必选
下载包的md5值
package_message
string
无
可选
下载包的一些描述
extend _params
dict
无
必选
扩展字段,可以为空
notify _path
string
空
可选
管理平台URL(相对地址),用于通过http方式回传命令执行结果。相对地址的组合请参见 URL组合章节。 注意: 如果登陆时管理平台下发 uploadQueue 字段,则会通过MQ上传通道返回结果。 如果没有 uploadQueue 字段,并且 notify_path 为非空,则会向 notify_path 返回结果 如果两个字段都没有,则不会返回结果(即单向通信)。
MQ命令示例:
{
"method": "download_package", // 此关键字和内容不能变
"download_package_info":{ // 下载包对应信息
"package_name":"ota.tar",
"package_download_link":"http://xxxxx/xxx",
"package_size":0.34, //单位为M
"package_md5":"8b1085bed498b82ef1485ef19074c281",
"package_message":"更新了部分在线升级功能",
},
"extend_params": // 扩展字段,当前为空。用于将来的接口升级。扩展字段的内容以字典的形式填充,但扩展字段本身为必选。
{
}
}
返回结果示例:
{
"success":true,
"code":0,
"message":"下载成功",
"dev_sno":"sda23erasd" ,//设备唯一标识key
"messageKey":"download_package", //每一类消息格式的key
"result":{
"download_package_info":{
"package_name":"ota.tar",
"package_download_link":"http://xxxxx/xxx",
"package_size":0.34,
"package_md5":"8b1085bed498b82ef1485ef19074c281",
"package_message":"更新了部分在线升级功能",
"package_download_path":"/data/download/ota.tar" //下载包下载路径
}
}
}
Last updated
Was this helpful?