简要描述
请求URL
{{adminHost:8181}}/client/getResUsage
请求方式
| 字段名 |
示例值 |
必选 |
类型 |
说明 |
| adminKey |
603284317954637824 |
是 |
string |
该参数为后台管理接入凭证，在LarkXR3.3后台接入管理中查看 |
| timestamp |
8641706679604867 |
是 |
string |
发送请求时的时间戳，单位为毫秒 |
| signature |
9A02B47AE67664D80A2ED13FC2B1691512613790 |
是 |
string |
该参数为密钥签名。将adminKey（LarkXR3.2后台接入管理中查看）和adminSecret（LarkXR3.3后台中接入管理查看）和当前时间戳（long型数值）按字母序排序，然后进行SHA-1摘要签名。请参考【获取凭证签名】的样例 |
请求Query参数
| 参数名 |
示例值 |
必选 |
类型 |
说明 |
| groupId |
|
否 |
string |
组别Id |
| page |
|
否 |
string |
页码，默认为1 |
| pageSize |
|
否 |
string |
每页多少条数据，默认为8 |
成功返回示例
{
"code": 1000,
"message": "Success",
"result": {
"records": [
{
"clientId": 10007,
"clientIp": "175.162.5.49",
"clientName": "",
"clientMac": "2C4D79ECD6FE",
"status": 1,
"groupId": "816351359270912000",
"onlineCnt": "90",
"lastOnlineDate": "1631697818792",
"usedSeconds": "11486",
"createDate": "1603442182",
"updateDate": "1631769345236",
"taskId": "0",
"clientResUsageDto": {
"usageId": "888050528993411072",
"clientMac": "2C4D79ECD6FE",
"clientIp": "175.162.5.49",
"clientBrand": "Pico Neo 2",
"memTotal": 3687,
"memUsed": 1309,
"diskTotal": 45962,
"diskUsed": 6535,
"sdTotal": 45962,
"sdUsed": 6535,
"batteryHead": 36,
"batteryHandLeft": 80,
"batteryHandRight": 0,
"createDate": "1631769345293",
"clientId": 10007,
"status": 1
}
}
],
"total": "27",
"size": "8",
"current": "1",
"orders": [],
"searchCount": true,
"pages": "4"
}
}
成功返回示例的参数说明
| 参数名 |
类型 |
说明 |
| code |
string |
无 |
| message |
string |
无 |
| result |
object |
无 |
| records |
array |
无 |
| records.clientId |
string |
客户端Id |
| records.clientIp |
string |
客户端Ip |
| records.clientName |
string |
客户端名称 |
| records.clientMac |
string |
客户端Mac |
| records.status |
string |
客户端上下线状态 1：上线，2：下线 |
| records.groupId |
string |
客户端没有绑定组别时，返回是null |
| records.onlineCnt |
string |
上线次数 |
| records.lastOnlineDate |
string |
最后一次的上线时间 |
| records.usedSeconds |
string |
使用时长（单位：s） |
| records.createDate |
object |
创建时间 |
| records.updateDate |
object |
更新时间 |
| records.taskId |
string |
对应的任务Id |
| records.clientResUsageDto |
object |
客户端性能数据对象 |
| records.clientResUsageDto.usageId |
string |
客户端品牌 |
| records.clientResUsageDto.clientMac |
string |
客户端Mac |
| records.clientResUsageDto.clientIp |
string |
客户端Ip |
| records.clientResUsageDto.clientBrand |
string |
客户端品牌 |
| records.clientResUsageDto.memTotal |
string |
总内存 (M) |
| records.clientResUsageDto.memUsed |
string |
内存使用量(M) |
| records.clientResUsageDto.diskTotal |
string |
磁盘容量(M) |
| records.clientResUsageDto.diskUsed |
string |
磁盘使用量(M) |
| records.clientResUsageDto.sdTotal |
string |
存储卡总量(M) |
| records.clientResUsageDto.sdUsed |
string |
存储卡使用量(M) |
| records.clientResUsageDto.batteryHead |
string |
头戴设备电量剩余(百分比前面的数字) |
| records.clientResUsageDto.batteryHandLeft |
string |
左手柄电量剩余(百分比前面的数字) |
| records.clientResUsageDto.batteryHandRight |
string |
右手柄电量剩余(百分比前面的数字) |
| records.clientResUsageDto.createDate |
string |
生成时间 |
| records.clientResUsageDto.clientId |
string |
客户端Id |
| records.clientResUsageDto.status |
string |
客户端上下线状态 1：上线，2：下线 |
| total |
string |
无 |
| size |
string |
无 |
| current |
string |
无 |
| orders |
array |
无 |
| searchCount |
string |
无 |
| pages |
string |
无 |
备注
