查询设备型号列表#

验证状态：已源码核验、未联调；适用基线：源码归纳 @ 2026-09-14

用途与场景#

读取设备型号下拉数据（非分页，受 sqlQueryLimit 上限约束）。当前 Web 的共享「设备型号选择器」在挂载时调用本操作并缓存进 sessionStorage 供多页面复用。注意：device-model（整机型号）与票 10 已发布的 box/device/server-model（采集箱/设备/服务器子型号）是不同资源族。

使用位置#

页面/功能	角色或空间分支
设备型号选择器（共享组件）	登录用户；后端授权 administrator 或 device-device-model:read

端点#

POST /main-service/main-api/device/device-model/list — 读取设备型号下拉数据（非分页，受 sqlQueryLimit 上限约束）

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 device · device-model 设备型号；业务语义（wire 惯例、限频、租户声明等）见设备业务 · device-model 设备型号。

动线与完成判据#

status=200 且 data 数组可消费即读取结束；[] 为成功空态。直查数据库，无缓存窗口。当前 Web 选择器发送空对象 {}，即取默认 100 条上限内的全集。

错误与边界#

认证失败/权限失败。读取无副作用，可重试。响应 DTO 的逐键类型以清单层 schema 为准（本页未逐键展开，选择器只消费 id/name/外键）。

调用关系与资源清理#

无长连接资源。选择器随 spaceId 变化刷新（refreshDeps: [spaceId]）。

已知缺口#

响应 DTO 逐键类型未在页内展开（选择器消费面有限）；超过 100 条时截断——空 body 依赖默认上限，是否满足部署数据量未核验。