设备摘要
此API用于列出您网络中发现的所有唯一设备。
- 功能
- 检索检测到的网络设备列表。
- HTTP方法
- GET
- API URI
- api/1.4/reports/dcm/devicesummary
- 过滤器
- os_platform={Numeric}
用于根据操作系统平台过滤
1 - Windows
2 - Mac
isblocked={Numeric}
用于根据允许/阻止状态过滤设备
0 - 允许
1 - 阻止
devicetype={Numeric}
用于根据设备类型过滤
各设备类型对应的代码如下:
2 - 生物识别
3 - 蓝牙
4 - CDROM
5 - 磁盘驱动器
9 - 软盘驱动器
19 - 图像
20 - 红外线
21 - 键盘
24 - 调制解调器
26 - 鼠标
37 - 打印机
42 - 智能卡读卡器
46 - 磁带驱动器
49 - WPD
100 - WPD_AppleDevices
102 - 串口(COM)
103 - 并口(LPT)
104 - 无线网络适配器
- 分页
- page={Numeric}
用于导航到特定页面。此字段表示当前页。
pagelimit={Numeric}
指定每页显示的记录数。
- 响应参数
- isblocked
表示上次访问状态。
0 - 允许
1 - 阻止
usage_duration
表示上次连接的持续时间,单位为毫秒。
所有时间均为纪元长整型格式。
响应数据
{ "message_type": "dcm", "message_response": { "total": 2201, "limit": 25, "page": 1, "dcm": [ { "custom_device_name": "--", "deviceaudit_id": 13861, "device_removed_time": 1744202349340, "managedcomputer.friendly_name": "5229799fva6j 0N70PQG", "vendor_hex_id": "046d", "os_platform": 1, "vendor_name": "Logitech, Inc.", "device_type": "smp.dcm.keyboard", "serial_number": "d0992e475_1726", "connected_count": 1, "userresource.name": "5229799fva6j-User", "product_name": "Unifying Receiver", "deviceauditevents.target_device_name": "Unifying Receiver", "is_blocked": 1, "product_hex_id": "c534", "last_occurrence": 1744116003923, "device_inserted_time": 1744116003923, "resource_name": "5229799fva6j", "usage_duration": 86345417, "computer_resource_id": 113341, "db_updated_time": 1744202454150, "deviceauditevents.target_manufacturer_name": "Microsoft" }, { "custom_device_name": "--", "deviceaudit_id": 11241, "device_removed_time": 1744202320885, "managedcomputer.friendly_name": "2298099xp3Uq TXJUW23", "vendor_hex_id": "0781", "os_platform": 1, "vendor_name": "SanDisk Corp.", "device_type": "smp.dcm.removablestoragedevice", "serial_number": "0401f1f4dca48f58a0c51ab643aa01b5f644bdb6e7be9d014bc0a70fdb27a3ea73a600000000000000000000204fbd83ff9f6418915581075ea8598650_1291", "connected_count": 1, "userresource.name": "2298099xp3Uq-User", "product_name": "Ultra Flair", "deviceauditevents.target_device_name": "Ultra Flair", "is_blocked": 0, "product_hex_id": "5591", "last_occurrence": 1744116003896, "device_inserted_time": 1744116003896, "resource_name": "2298099xp3Uq", "usage_duration": 86316989, "computer_resource_id": 113636, "db_updated_time": 1744202439034, "deviceauditevents.target_manufacturer_name": "Ultra" } ] }, "message_version": "1.4", "status": "success", "response_code": 200 }
