Actions45
- 部门与成员 Actions
- Wi-Fi Actions
- 终端管理 Actions
- 软件管理 Actions
终端管理 → 获取设备列表
AI-generatedSummary
按用户、设备属性、设备状态、分组 ID 和在线时间筛选飞连终端设备列表。可选择返回全部匹配结果或最多返回指定数量;每个输入项都会触发一次操作调用。
Inputs
- 用户 ID(id) — 按用户 ID(如 ou_xxx)筛选。
- 设备 Did(did) — 按设备 Did 筛选。
- 设备品牌(brand) — 按品牌筛选。
- 设备名称(device_name) — 按设备名称筛选。
- 设备 IP(client_ip) — 按设备 IP 筛选。
- 设备 SN 号(serial_number) — 按设备序列号筛选。
- 设备 MAC 地址(mac_addrs) — 按 MAC 地址筛选。
- 客户端版本号(app_ver) — 按客户端版本筛选。
- 客户端操作系统(client_os) — 按客户端操作系统筛选。
- 设备状态(status) — 可多选:0 失效设备、1 活跃设备、2 休眠设备;多个状态以逗号分隔。
- 终端分组 ID(group_id) — 按终端分组筛选;0 表示不传该参数。
- 首次在线时间范围(created_start_time、created_end_time) — 筛选首次在线时间;任一端留空表示不限制该端。
- 最近在线时间范围(updated_start_time、updated_end_time) — 筛选最近在线时间;任一端留空表示不限制该端。
- Return All(returnAll) — 关闭时最多返回 Limit 条;开启时请求全部结果。
- Limit(limit) — Return All 关闭时的最大结果数,默认 50,可设为 1–200。
- Timeout(options.timeout) — 等待响应头的超时时间(毫秒);0 表示不限制。
Output shape
一个设备记录列表,作为 n8n 主输出项返回。
实际字段由飞连 API 响应决定;源代码未显式限定记录结构。若启用 Continue On Fail,失败项会输出包含 error 字段的数据。