设备摘要


此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 }