1.4.9.1. 查询升级版本列表
获取设备可升级版本，可升级的版本仅仅包含比设备当前版本高的版本
Request:
POST /v1.0/ufo/device/newest
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"sn": "33998400021314"
}
}
}
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| sn | String | Y | 设备序列号 |
Response：
{
"code":"00000000",
"mid":"xxx",
"message":"success",
"payload":{
"results":{
"sn":"33998400021314",
"versions":[
{
"description": "版本升级描述信息",
"version":"ZLM60-NF-Ver1.1.2",
"url":"https://zk.myqcloud.com/ZLM60-NF-Ver1.1.2.cfg"
},
{
"description": "版本升级描述信息",
"version":"ZLM60-NF-Ver1.1.1",
"url":"https://zk.myqcloud.com/ZLM60-NF-Ver1.1.1.cfg"
}
]
}
}
}
| 参数名 | 描述 |
|---|---|
| sn | 设备序列号 |
| versions | 新版本集合 |
| version | 版本号 |
| url | 文件路径 |
| description | 版本升级描述信息 |
Error：
{
"code": "E1FF0001",
"mid": "xxx",
"message": "查询固件版本信息异常"
}
| 参数名 | 描述 |
|---|---|
| code | 异常事件码 |
1.4.9.2. 升级固件
升级设备固件到指定版本
注：DBS升级规则只支持升级固件比设备当前固件版本号新的、同系列的固件，不支持降级升级和跨系列升级
Request:
POST /v1.0/ufo/device/upgrade
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"sn": "33998400021314",
"version": "ZLM60-NF-Ver1.1.2"
}
}
}
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| sn | String | Y | 设备序列号 |
| version | String | Y | 目标版本号 |
Response：
{
"code":"00000000",
"mid":"xxx",
"message":"success",
"payload":{
"results":{
"taskId":"4d14381329bc4563ae16474f8a42c24d"
}
}
}
| 参数名 | 描述 |
|---|---|
| taskId | 表示本次升级的动作id，调用方需要保存； 可用于调用“升级历史”接口获取升级结果 |
Error：
{
"code": "E1FF0007",
"mid": "xxx",
"message": "找不到匹配的固件升级包"
}
1.4.9.3. 查询设备升级历史
查询设备升级历史
Request:
POST /v1.0/ufo/device/queryUpgradeHistory
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"curPage": 1,
"pageSize": 10,
"params": {
"sn": "6049200800012",
"beginTime": "1601222400",
"endTime": "1601740799",
"taskId": "6049200800012-b81ac651"
}
}
}
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| sn | String | Y | 设备序列号 |
| curPage | Integer | N | 分页查询条件，分页页码，默认第1页 |
| pageSize | Integer | N | 分页查询条件，分页大小，默认每页10条，不超过20条 |
| beginTime | Long | N | 升级开始Unix时间戳，精确到秒 |
| endTime | Long | N | 升级截止Unix时间戳，精确到秒 |
| taskId | String | N | 任务Id |
Response：
{
"code": "00000000",
"mid": "xxxxxxx",
"message": "success",
"payload" : {
"results" :
[{
"taskId" : "6049200800012-b81ac651",
"deviceSn" : "6049200800012",
"lastVersion" : "ZAM170-FFNF-Ver1.1.16",
"currentVersion" : "ZAM170-FFNF-Ver1.1.17",
"status" : 2,
"description" : "升级超时,系统自动判定失败",
"creater" : "6049200800012",
"createTimestamp" : 1599105313854,
"completionTimestamp" : 1599108960005,
"source" : 0
}]
}
}
| 参数名 | 描述 |
|---|---|
| taskId | 任务id |
| deviceSn | 设备序列号 |
| lastVersion | 上一个固件版本 |
| currentVersion | 当前固件版本 |
| status | 升级状态：0-升级中；1-升级成功；2-升级失败；3-下载中；4-烧制中；5-升级超时 |
| description | 升级结果描述 |
| creater | 操作者 |
| createTimestamp | 升级开始时间 |
| completionTimestamp | 升级结束时间 |
| source | 升级操作发起来源 0:软件 1:设备 |