获取升级包任务详情
开发中
POST
/api/v1/things/ota/firmware/job/read
iThings-apisvr/物联网相关接口/ota升级/升级任务管理
请求参数
Header 参数
iThings-token
string
可选
默认值:
{{iThings-token}}
iThings-project-id
string
可选
默认值:
1786838173980422144
iThings-app-code
string
可选
默认值:
{{iThings-app-code}}
iThings-user-role
string
可选
默认值:
1
Accept-Language
string
可选
默认值:
en
iThings-tenant-code
string
可选
Body 参数application/json
id
integer
必需
示例
{
"id": 0
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/things/ota/firmware/job/read' \
--header 'iThings-token: {{iThings-token}}' \
--header 'iThings-project-id: 1786838173980422144' \
--header 'iThings-app-code: {{iThings-app-code}}' \
--header 'iThings-user-role: 1' \
--header 'Accept-Language: en' \
--header 'iThings-tenant-code;' \
--header 'Content-Type: application/json' \
--data-raw '{
"id": 0
}'返回响应
🟢200成功
application/json
Body
code
integer
必需
msg
string
必需
data
object (升级包任务)
必需
id
integer
可选
firmwareID
integer
升级包ID，升级包的唯一标识符。
type
integer
升级包所属产品的JobType。 验证升级包:1 批量升级:2
status
integer
批次状态,计划中:1 执行中:2 已完成:3 已取消:4
upgradeType
integer
升级策略，1-静态，2-动态
srcVersions
array[string]
待升级版本号列表。最多可传入10个版本号本号
retryInterval
integer
设备升级失败后，自动重试的时间间隔，单位为分钟
retryCount
integer
自动重试次数。1/2/5次
timeoutInMinutes
integer
设备升级超时时间，单位为分钟
maximumPerMinute
integer
每分钟最多向多少个设备推送升级包下载URL
isOverwriteMode
integer
是否覆盖之前的升级任务。取值 ： 2（默认）：不覆盖。若设备已有升级任务，则只执行已有任务。 1：覆盖。设备只执行新的升级任务。此时 MultiModuleMode 不能传入 true。
isNeedPush
integer
物联网平台是否主动向设备推送升级任务
isNeedConfirm
integer
是否需要APP确认
dynamicMode
integer
动态升级模式
targetDeviceNames
array[string]
可选
scheduleFinishTime
integer
指定结束升级的时间,单位为秒
scheduleTime
integer
可选
targetSelection
integer
升级范围1：全量升级。 2：定向升级。 3：灰度升级。
target
string
分组升级和区域升级填写对应的id
tenantCodes
array[string]
指定租户
grayPercent
integer
灰度的范围,小数点后两位, 1.23%为 123
createdTime
integer
可选
示例
{
"code": 0,
"msg": "string",
"data": {
"id": 0,
"firmwareID": 0,
"type": 0,
"status": 0,
"upgradeType": 0,
"srcVersions": [
"string"
],
"retryInterval": 0,
"retryCount": 0,
"timeoutInMinutes": 0,
"maximumPerMinute": 0,
"isOverwriteMode": 0,
"isNeedPush": 0,
"isNeedConfirm": 0,
"dynamicMode": 0,
"targetDeviceNames": [
"string"
],
"scheduleFinishTime": 0,
"scheduleTime": 0,
"targetSelection": 0,
"target": "string",
"tenantCodes": [
"string"
],
"grayPercent": 0,
"createdTime": 0
}
}🟢200成功返回
扫码加入 iThings微信交流群
扫码加入交流群