GET /admin/iots

查询 Non-Human Identity (NHI) IoT Device 列表,支持按状态和工作负载子类型过滤

Admin/IoTs `bearerAuth` application/json

请求参数

名称位置类型必填默认值示例约束描述
status query string 否 状态过滤
workload_subtype query string 否 工作负载子类型
page query integer 否 1 页码
page_size query integer 否 20 每页数量

响应

状态描述Schema
200IoT Device 列表dto.ListResponse-device_domain_DeviceInfo

引用的 Schema

device_domain.DeviceInfo

字段类型必填示例约束描述
created_at string 否
firmware_ver string 否
hardware_id string 否
identity_id string 否
manufacturer string 否
name string 否
owner_id string 否
owner_principal_id string 否 OwnerPrincipalID additive(json omitempty);保留 OwnerID 以向后兼容(C-4)。
pairing_code string 否
status string 否
updated_at string 否
workload_subtype string 否

dto.ListResponse-device_domain_DeviceInfo

字段类型必填示例约束描述
code integer 否
items array of

参见 device_domain.DeviceInfo

否 统一使用 items
message string 否
pagination object 否 分页信息(嵌套对象)
timestamp string 否
total integer 否 总条数(平铺,便于直接读取)

service-core/base/dto.PageInfo

字段类型必填示例约束描述
has_next boolean 否 HasNext indicates whether there is a next page
has_prev boolean 否 HasPrev indicates whether there is a previous page
page integer 否 Page is the current page number (1-based)
page_size integer 否 PageSize is the number of items per page
total integer 否 Total is the total number of items across all pages
total_pages integer 否 TotalPages is the total number of pages