---
title: "查询指定升级批次的详情"
method: POST
path: "/api/v1/things/ota/firmware/job/read"
tags: ["things/ota/firmware/job", "thingsOtaFirmwareJob"]
---

# 查询指定升级批次的详情

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

## Request body

- WithID
  - `id` integer — id

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` 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-动态
  - `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)