v1

latestOpenAPI 3.0.32026-07-17178286472.4 KB
things/ota/firmware/job
thingsOtaFirmwareJob

创建升级任务

post/api/v1/things/ota/firmware/job/create

Request body

createdTimeinteger
dynamicModeinteger
firmwareIDinteger

升级包ID,升级包的唯一标识符。

grayPercentinteger

灰度的范围,小数点后两位, 1.23%为 123

idinteger
isNeedConfirminteger
isNeedPushinteger

物联网平台是否主动向设备推送升级任务。

isOverwriteModeinteger

是否覆盖之前的升级任务。取值:2(不覆盖)、1(覆盖)。

maximumPerMinuteinteger

每分钟最多向多少个设备推送升级包下载URL。 动态升级 静态升级

retryCountinteger

自动重试次数。1/2/5次 动态升级 静态升级

retryIntervalinteger

设备升级失败后,自动重试的时间间隔,单位为分钟。 动态升级 静态升级

scheduleFinishTimeinteger

指定结束升级的时间,单位为毫秒。

scheduleTimeinteger
srcVersionsstring[]

待升级版本号列表。最多可传入10个版本号。用逗号分隔多个版本号

statusinteger

批次状态,计划中:1 执行中:2 已完成:3 已取消:4

targetstring

分组升级和区域升级填写对应的id

targetDeviceNamesstring[]

定向升级的设备名称列表。最多可传入200个设备名称。以逗号分隔

targetSelectioninteger

升级范围。 1:全量升级。 2:定向升级。 3:灰度升级。 4:分组升级(不做) 5: 区域升级(不做)

tenantCodesstring[]

指定租户

timeoutInMinutesinteger

设备升级超时时间,单位为分钟。 动态升级 静态升级

typeinteger

升级包所属产品的JobType。 验证升级包:1 批量升级:2

upgradeTypeinteger

升级策略,1-静态,2-动态

Response

A successful response.

codeinteger
msgstring