云服务器内容精选

  • 响应示例 返回状态码为200:接口调用成功,响应体参考TrafficStatisticDataResp。 HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : [ { "hostName" : "station1", "upTraffic" : 34225.0, "downTraffic" : 34225.0, "unit" : "Byte" } ] } 返回状态码为400:参数错误,查询失败。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive
  • 响应参数 返回状态码为200:接口调用成功,响应体参考TrafficStatisticDataResp。 表3 TrafficStatisticDataResp对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~10个字符。 - 错误码信息。 "0" errmsg string 0~256个字符。 - 结果信息。 "" data ARRAY_REFERENCE 0-100个列表项,详细请参见表4。 查询到的TopN终端流量列表信息。 - 表4 TrafficStatisticInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 hostName string 0~256个字符。 - 终端名称。 "station1" upTraffic float [0-3.4028235E38] - 上行流量。 34225.0 downTraffic float [0-3.4028235E38] - 下行流量。 34225.0 unit string 0~256个字符。 - 流量单位。 "Byte" 返回状态码为400:参数错误,查询失败。 详细信息请参见实际响应消息体。
  • URI /controller/campus/v1/performanceservice/station/traffic/statistic/site/{siteId} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 string - - 站点ID,UUID格式。 "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca" 表2 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceType 是 string AP FW AC ALL AP 查询过滤的设备类型,AP---AP设备、FW---FW设备、AC---AC(Fit AP)设备、ALL---所有设备。 "AP" timeDimension 是 string day week month year day 统计周期,day---天、week---周、month---月、year---年。 "day" top 是 int32 0 5 10 15 20 5 top数据个数,支持0、5、10、15、20。0代表查询所有终端流量。 5 beginTime 是 int64 [0-2208959999] - 起始格林威治时间(时间精度对应到秒)。 1537408636 endTime 是 int64 [0-2208959999] - 结束格林威治时间(时间精度对应到秒)。 1537495036
  • 请求示例 HTTP的示例 GET /controller/campus/v1/performanceservice/station/traffic/statistic/site/ea25fdbf-8dee-4823-bac2-5bfe8e3359ca?deviceType=AP&timeDimension=day&top=5&beginTime=1537408636&endTime=1537495036 HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AC CES S-TOKEN: x-yyyyyy
  • 请求示例 HTTP的示例 GET /controller/campus/v1/performanceservice/station/client/device/b473118d-17ff-4f4f-9fa9-a4c0e1e87e42?pageIndex=1&pageSize=20&terminalMac=xx-xx-xx-xx-xx-xx&terminalIP=192.168.1.2&ssid=wifi&sortKey=+accessTime&account=test HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy
  • 响应示例 返回状态码为200:接口调用成功,响应体参考StationDataResp。 HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "total" : 10, "data" : [ { "accessTime" : 0, "accessMac" : "xx:xx:xx:xx:xx:xx", "accessType" : 0, "account" : "user1", "deviceName" : "device1", "authType" : "WPA2-PSK", "channel" : 1, "cumulativeTraffic" : 1024, "downwardSpeed" : 0, "dualFrequency" : 1, "frequencyBand" : 2, "hostName" : "Honor 8", "mode" : 4, "onlineStatus" : 1, "onlineTime" : 100, "packageLossRate" : 1, "portIndex" : 0, "retransRate" : 0, "rssi" : 0, "sendPackageSpeed" : 0, "signalNoiseRatio" : 0, "ssid" : "wifi123", "stickyTags" : 1, "terminalIP" : "192.168.2.34", "terminalMac" : "xx:xx:xx:xx:xx:xx", "upwardSpeed" : 0, "vlan" : 100 } ] } 返回状态码为400:参数错误,查询失败。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive
  • URI /controller/campus/v1/performanceservice/station/client/device/{deviceId} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 是 string - - 设备ID,UUID格式。 "b473118d-17ff-4f4f-9fa9-a4c0e1e87e42" 表2 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 pageIndex 是 int32 [1-65535] 1 分页查询的页码。 1 pageSize 是 int32 [20-100] 20 分页查询每页数量。 20 status 否 string online offline online 用户在线状态,online---在线、offline---离线,不填代表查询全部状态。 - terminalMac 否 string 14~256个字符。 - 终端MAC,需要符合mac地址的格式,例如xx-xx-xx-xx-xx-xx,需要区分大小写字母。 "xx-xx-xx-xx-xx-xx" terminalIP 否 string 0~256个字符。 - 终端IP,需要符合IP地址的格式,例如192.168.1.2。 "192.168.1.2" ssid 否 string 0~256个字符。 - WiFi名。 "wifi" sortKey 否 string 0~256个字符。 - 排序列,所有支持accessTime/accessType/account/ap/authType/channel/cumulativeTraffic/downwardSpeed/dualFrequency/frequencyBand/hostName/mode/onlineStatus/onlineTime/packageLossRate/retransRate/rssi/sendPackageSpeed/signalNoiseRatio/ssid/stickyTags/terminalIp/terminalMac/timeStamp/upwardSpeed/vlan均支持排序。如:+accessTime:按accesstime升序,-accessTime:按accessTime降序。 "+accessTime" account 否 string 0~256个字符。 - 用户名。 "test"
  • 响应示例 返回状态码为200:接口调用成功,响应体参考ClientStatisticalInfoDto。 HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "exprWorse" : 10, "exprBad" : 10, "exprGood" : 10, "exprBetter" : 10, "speedBad" : 10, "speedGood" : 10, "speedBetter" : 10, "oneHour" : 100, "oneToTwoHour" : 100, "twoToFourHour" : 100, "fourToSixHour" : 100, "sixToEightHour" : 100, "eightHour" : 100 } } 返回状态码为400:参数错误,查询失败。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive
  • 响应参数 返回状态码为200:接口调用成功,响应体参考ClientStatisticalInfoDto。 表2 ClientStatisticalInfoDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~10个字符。 - 错误码信息。 "0" errmsg string 0~256个字符。 - 结果信息。 "" data REFERENCE 详细请参见表3。 - - 表3 QueryTerminalStatisticsOutput对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 exprWorse int32 [0-2147483647] - 体验-差的终端个数。该字段暂未实现,始终为0。 10 exprBad int32 [0-2147483647] - 体验-一般的终端个数。体验一般的标准为,丢包率大于等于5%。 10 exprGood int32 [0-2147483647] - 体验-良好的终端个数。体验良好的标准为,丢包率大于等于3%且小于5%。 10 exprBetter int32 [0-2147483647] - 体验-优的终端个数。体验优的标准为,丢包率小于3%。 10 speedBad int32 [0-2147483647] - 速度-慢的终端个数。速度慢的标准为,速度小于11Mbps。 10 speedGood int32 [0-2147483647] - 速度-中的终端个数。速度中的标准为,速度大于等于11Mbps且小于等于54Mbps。 10 speedBetter int32 [0-2147483647] - 速度-快的终端个数。速度快的标准为,速度大于54Mbps。 10 oneHour int32 [0-2147483647] - 在线一小时的终端数。 100 oneToTwoHour int32 [0-2147483647] - 在线一至二小时的终端数。 100 twoToFourHour int32 [0-2147483647] - 在线二至四小时的终端数。 100 fourToSixHour int32 [0-2147483647] - 在线四至六小时的终端数。 100 sixToEightHour int32 [0-2147483647] - 在线六至八小时的终端数。 100 eightHour int32 [0-2147483647] - 在线八小时以上的终端数。 100 返回状态码为400:参数错误,查询失败。 详细信息请参见实际响应消息体。
  • 请求示例 HTTP的示例 GET /controller/campus/v1/performanceservice/station/online/statistic/b473118d-17ff-4f4f-9fa9-a4c0e1e87e42 HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy