设备审计


此 API 用于列出您网络中发生的所有设备活动。

 

  • 功能
  • 用于检索您网络中的所有设备活动。
  • HTTP 方法 
  • GET
  • API URI
  • api/1.4/reports/dcm/deviceaudit
  • 过滤器
  • 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 - 无线网卡


    dipId={String}
    根据设备实例路径过滤记录。


    period={Numeric}
    根据时间段过滤。
    0 - 本周
    1 - 本月
    2 - 本年
    3 - 上周
    4 - 上月
    5 - 上两月
    6 - 上三月
    7 - 上六月
    8 - 上九月
    9 - 去年

    domain={String}
    根据域名过滤记录。

    computer={Numeric}
    过滤连接到特定计算机的设备。所有计算机的资源 ID 可从以下位置获取：
    关键字: "resource_id"
    /api/1.0/som/computers

    gid={Numeric}

    过滤连接到特定计算机组的设备。所有自定义计算机组的 ID 可从以下位置获取：
    api/1.0/admin/customgroups
  • 分页
  • page={Numeric}
    用于导航到特定页面。此字段表示当前页码。

    pagelimit={Numeric}
    指定每页显示的记录数。
  • 响应参数
  • isblocked
    表示最后访问状态。
    0 - 允许
    1 - 阻止
    usage_duration
    表示上次连接的持续时间，单位为毫秒。

    所有时间均采用 epoch long 格式。

响应数据

 { 	"message_type": "dcm", 	"message_response": { 		"total": 7603, 		"limit": 25, 		"page": 1, 		"dcm": [ 			{ 				"custom_device_name": "--", 				"deviceaudit_id": 9283, 				"device_removed_time": 1744202399456, 				"managedcomputer.friendly_name": "1493600z7Jl3  K5QUPKY", 				"vendor_hex_id": "1a2c", 				"os_platform": 1, 				"vendor_name": "China Resource Semico Co., Ltd", 				"device_type": "smp.dcm.keyboard", 				"serial_number": "340bcb0a", 				"domain_netbios_name": "WORKGROUP", 				"userresource.name": "1493600z7Jl3-User", 				"product_name": "HID Keyboard Device", 				"deviceauditevents.target_device_name": "HID Keyboard Device", 				"is_blocked": 1, 				"product_hex_id": "2124", 				"device_inserted_time": 1744116003726, 				"resource_name": "1493600z7Jl3", 				"customer_id": 1, 				"class_guid": "{4d36e96b-e325-11ce-bfc1-08002be10318}", 				"usage_duration": 86395730, 				"computer_resource_id": 113550, 				"db_updated_time": 1744202428351, 				"deviceauditevents.target_manufacturer_name": "Microsoft" 			}, 			{ 				"custom_device_name": "--", 				"deviceaudit_id": 6011, 				"device_removed_time": 1744202383484, 				"managedcomputer.friendly_name": "74927000gsRq  D8LTMFI", 				"vendor_hex_id": "13fe", 				"os_platform": 1, 				"vendor_name": "Kingston Technology Company Inc.", 				"device_type": "smp.dcm.removablestoragedevice", 				"serial_number": "0", 				"domain_netbios_name": "WORKGROUP", 				"userresource.name": "74927000gsRq-User", 				"product_name": "DataTraveler 2.0 1GB/4GB Flash Drive / Patriot Xporter 4GB Flash Drive", 				"deviceauditevents.target_device_name": "DataTraveler 2.0 1GB/4GB Flash Drive / Patriot Xporter 4GB Flash Drive", 				"is_blocked": 1, 				"product_hex_id": "1d00", 				"device_inserted_time": 1744116003460, 				"resource_name": "74927000gsRq", 				"customer_id": 1, 				"class_guid": "{4d36e967-e325-11ce-bfc1-08002be10318}", 				"usage_duration": 86380024, 				"computer_resource_id": 113543, 				"db_updated_time": 1744202411818, 				"deviceauditevents.target_manufacturer_name": "DataTraveler" 			} 		] 	}, 	"message_version": "1.4", 	"status": "success", 	"response_code": 200 }