---
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 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

---

[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)