---
title: "查询升级设备列表"
method: POST
path: "/api/v1/things/ota/firmware/device/index"
tags: ["things/ota/firmware/device", "thingsOtaFirmwareDevice"]
---

# 查询升级设备列表

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

## Request body

- OtaFirmwareDeviceIndexReq
  - `deviceName` string — 设备名称
  - `firmwareID` integer — 任务状态
  - `isOnline` integer — 设备是否在线
  - `jobID` integer — 作业ID
  - `page` PageInfo
    - `orders` OrderBy[] — 排序
      - `field` string — 排序的字段名
      - `sort` integer — 排序方式：1 从小到大, 2 从大到小
    - `page` integer — 页码
    - `size` integer — 每页大小
  - `srcVersion` string
  - `status` integer — 设备升级作业状态。1：待确认。 2：待推送。 3：已推送。 4：升级中。 5:升级成功 6: 升级失败. 7:已取消

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` OtaFirmwareDeviceIndexResp
    - `list` OtaFirmwareDeviceInfo[], required — OTA任务信息列表
      - `createdTime` integer, required
      - `destVersion` string, required
      - `detail` string, required
      - `deviceName` string, required
      - `firmwareID` integer, required
      - `id` integer, required
      - `isOnline` integer — 设备是否在线
      - `jobID` integer, required
      - `productID` string, required
      - `productName` string, required
      - `srcVersion` string, required
      - `status` integer, required
      - `step` integer, required
      - `updatedTime` integer, required
    - `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)