获取固件版本和升级状态
1.接口描述
接口说明:获取当前固件版本信息和升级状态。
请求方式:POST [ip]/api/upgrade/state
管理员权限 | 登录认证 |
---|---|
是 | 是 |
2.输入参数
无
3.输出参数
参数名称 | 类型 | 描述 |
---|---|---|
status | Int | 状态码 |
code | String | 状态描述 |
state | Int | 升级任务执行状态 0:空闲 1:初始化升级 2:升级中 3:升级完成 4: 固件在线下载中 |
cur-ver | String | 当前固件版本号 |
update-version | String | 最新固件版本号 |
num-steps | Int | 升级任务总计需要几个步骤,仅在 state 为 2 状态下存在 |
step | Int | 升级任务执行到第几步,仅在 state 为 2 状态下存在 |
step-name | String | 当前执行步骤的名称,仅在 state 为 2 状态下存在 |
step-progress | Int | 当前执行的步骤的进度,值为 0 ~ 100,单位%, 仅在 state 为 2 状态下存在 |
download-percent | Float | 固件在线下载百分比 |
4.示例
获取当前固件版本信息和升级状态。
输入示例
None
输出示例
{
"status": 0,
"code": "Success",
"state": "updating",
"cur-ver": "1.1.72",
"update-version": "1.1.72",
"num-steps": 4,
"step": 2,
"step-name": "Erasing image",
"step-progress": 28
}
5.错误码
无接口业务逻辑相关的错误码,其他错误码详见 公共错误码。