---
title: "更新升级批次"
method: POST
path: "/api/v1/things/ota/firmware/job/update"
tags: ["things/ota/firmware/job", "thingsOtaFirmwareJob"]
---

# 更新升级批次

`POST /api/v1/things/ota/firmware/job/update`

## Request body

- OtaFirmwareJobInfo
  - `createdTime` integer
  - `dynamicMode` integer
  - `firmwareID` integer — 升级包ID，升级包的唯一标识符。
  - `grayPercent` integer — 灰度的范围,小数点后两位, 1.23%为 123
  - `id` integer
  - `isNeedConfirm` integer
  - `isNeedPush` integer — 物联网平台是否主动向设备推送升级任务。
  - `isOverwriteMode` integer — 是否覆盖之前的升级任务。取值：2（不覆盖）、1（覆盖）。
  - `maximumPerMinute` integer — 每分钟最多向多少个设备推送升级包下载URL。 动态升级 静态升级
  - `retryCount` integer — 自动重试次数。1/2/5次 动态升级 静态升级
  - `retryInterval` integer — 设备升级失败后，自动重试的时间间隔，单位为分钟。 动态升级 静态升级
  - `scheduleFinishTime` integer — 指定结束升级的时间，单位为毫秒。
  - `scheduleTime` integer
  - `srcVersions` string[] — 待升级版本号列表。最多可传入10个版本号。用逗号分隔多个版本号
  - `status` integer — 批次状态,计划中:1 执行中:2 已完成:3 已取消:4
  - `target` string — 分组升级和区域升级填写对应的id
  - `targetDeviceNames` string[] — 定向升级的设备名称列表。最多可传入200个设备名称。以逗号分隔
  - `targetSelection` integer — 升级范围。 1：全量升级。 2：定向升级。 3：灰度升级。 4：分组升级(不做) 5: 区域升级(不做)
  - `tenantCodes` string[] — 指定租户
  - `timeoutInMinutes` integer — 设备升级超时时间，单位为分钟。 动态升级 静态升级
  - `type` integer — 升级包所属产品的JobType。 验证升级包:1 批量升级:2
  - `upgradeType` integer — 升级策略，1-静态，2-动态

## Response `200`

A successful response.

- object
  - `code` integer
  - `msg` string

---

[API](https://skmtc.net/unitedrhino/apis/things-api.md) · [All operations](https://skmtc.net/unitedrhino/apis/things-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unitedrhino/things-api/revisions/f3bdeb916389/schema)