/api/update/status
获取当前升级服务的状态。
需要系统配置查看权限
接口原型
| 协议 |
HTTP/HTTPS GET |
| URL |
ip[:port]/api/update/status |
| 数据格式 |
响应消息：Content-Type: application/json |
请求Cookies
| 名称 |
描述 |
| mwcloud-sid |
用于标识当前登录的字符串 |
| mwcloud-uid |
当前登录用户名 |
请求URL参数
| 参数 |
描述 |
| start |
可选，可设置获取的历史版本的起始序号 |
| count |
可选，可设置历史版本的数量 |
请求示例
GET /api/update/status HTTP/1.1
Accept: application/json, text/plain, */*
Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin;
响应参数
| 参数 |
描述 |
| Content-Type |
取值为：'application/json; charset=UTF-8' |
Response Body
更新服务状态
| 参数 |
描述 |
| state |
状态，参考更新服务状态码 |
| progress |
当state为MH_UPDATE_STATE_PULLING时有效，表示下载固件的进度，值从0-100 |
| enable-update |
是否支持升级（包括在线和手动） |
| version |
当前固件版本 |
| online-status |
在线升级信息，参考在线升级信息 |
更新服务状态码
| 值 |
描述 |
| 0 |
空闲 |
| 0x1 |
正在检查本地信息 |
| 0x2 |
正在检查在线版本 |
| 0x4 |
正在拉取固件 |
| 0x8 |
正在校验固件 |
| 0x10 |
正在上传固件 |
| 0x20 |
正在取消当前操作 |
| 0x40 |
升级完成，正在重启 |
| 0x100 |
升级服务不可用 |
| 0x200 |
升级失败，失败的错误码存储在字段update-result中 |
在线升级信息
| 参数 |
描述 |
| date |
上一次检查的时间 |
| check-result |
上一次检查的结果 |
| update-result |
当前更新状态的错误码 |
| is-newest |
当前是否是最新版本 |
| newest-version |
最新版本信息 |
| enable |
是否启用在线升级检测 |
| enable-expr |
检查在线版本时是否包含预发布版本 |
| versions |
在线版本列表信息，参考在线版本列表信息 |
在线版本列表信息
| 参数 |
描述 |
| start |
开始序号 |
| total |
历史版本总数 |
| list |
在线版本列表信息，可能为空数组，结构参考版本信息 |
版本信息
| 参数 |
描述 |
| version |
版本号 |
| is-expr |
是否是预发布版本 |
| date |
发布时间 |
响应示例
{
"result": 0,
"status": {
"state": 0,
"version": "2.1.28",
"progress": 0,
"enable-update": true,
"os-name": "Debian GNU/Linux 11 (bullseye)",
"online-status": {
"date": 1694400871,
"check-result": 0,
"update-result": 0,
"is-newest": true,
"newest-version": {
"version": "2.1.28",
"digest": "a487eef9d3e5a81ef9ff8deb143e61a086bc01196d1dce8ff1a1424aff9e44b3",
"is-expr": true,
"date": 1693884985
},
"enable": true,
"enable-expr": true,
"versions": {
"list": [
{
"version": "2.1.27",
"digest": "7cd2737135b7e826d44fa9ceae65c72bd84520b0899bafe7f912cd6bda5385e5",
"is-expr": true,
"date": 1693788867
},
{
"version": "2.1.26",
"digest": "550c2abaa1453ddb912ebc6d7b5233a046006b6c1c546115507e2084c8258bca",
"is-expr": true,
"date": 1693381926
},
{
"version": "2.1.25",
"digest": "53ecb3892f3090591012dfb1387dcf0562ebe5f41589a8a75151da556e56dc40",
"is-expr": true,
"date": 1693373940
}
],
"start": 1,
"total": 50
}
},
"info": ""
}
}