---
title: "获取升级包下的升级任务批次列表"
method: POST
path: "/api/v1/things/ota/firmware/job/index"
tags: ["things/ota/firmware/job", "thingsOtaFirmwareJob"]
---

# 获取升级包下的升级任务批次列表

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

## Request

- The document declares no server URL.
- Auth: none declared

## Request body

- OtaFirmwareJobIndexReq
  - `firmwareID` integer, required: 固件ID
  - `page` PageInfo, required
    - `orders` OrderBy[]: 排序
      - `field` string: 排序的字段名
      - `sort` integer: 排序方式：1 从小到大, 2 从大到小
    - `page` integer: 页码
    - `size` integer: 每页大小

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` OtaFirmwareJobInfoIndexResp
    - `list` OtaFirmwareJobInfo[], required: OTA作业信息列表
      - `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-动态
    - `page` integer: 页码
    - `pageSize` integer: 每页大小
    - `total` integer
  - `msg` string

## Changes

- **2026-03-27** `b9582d0ab6af`: 1 breaking, 1 info
  - added required request body
  - added the media type `application/json` for the response with the status `200`
- **2025-03-14** `e87dbcac5d9e`: 2 breaking
  - removed the request body
  - removed the media type `application/json` for the response with the status `200`

[Operation history](https://skmtc.dev/unitedrhino/apis/things-api/changes/api/v1/things/ota/firmware/job/index/post.md)

---

[API](https://skmtc.dev/unitedrhino/apis/things-api.md) - [All operations](https://skmtc.dev/unitedrhino/apis/things-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unitedrhino/apis/things-api/revisions/f3bdeb916389?raw)