云服务器内容精选

  • 响应示例 返回状态码为200:接口调用成功,响应体参考WanLinkQualityResponse。 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" : "", "pageIndex" : 10, "pageSize" : 10, "total" : 10, "data" : [ { "siteId" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca", "siteName" : "FWSite", "deviceId" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca", "deviceName" : "FWDevice", "wanLink" : [ { "interfaceName" : "WanInterface", "wanLinkQuality" : [ { "timestamp" : 1537408636, "upwardRate" : 1537408636, "downwardRate" : 1537408636, "packetLoss" : 50, "delay" : 1537408636, "jitter" : 1537408636 } ] } ] } ] } 返回状态码为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:接口调用成功,响应体参考WanLinkQualityResponse。 表3 WanLinkQualityResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~256个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" pageIndex int32 [1-10000] - 页数。 10 pageSize int32 [1-50] - 每一页显示的条数。 10 total int32 [0-2208959999] - 总记录数。 10 data ARRAY_REFERENCE 0-50个列表项,详细请参见表4。 数据。 - 表4 FwWanLinkDevice对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 siteId string 0~64个字符。 - 接入设备所在站点id。 "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca" siteName string 0~256个字符。 - 接入设备所在站点名称。 "FWSite" deviceId string 0~64个字符。 - 接入设备id。 "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca" deviceName string 0~256个字符。 - 接入设备名称。 "FWDevice" wanLink ARRAY_REFERENCE 0-50个列表项,详细请参见表5。 链路质量数据。 - 表5 FwWanLink对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 interfaceName string 0~256个字符。 - WAN口名称。 "WanInterface" wanLinkQuality ARRAY_REFERENCE 0-300个列表项,详细请参见表6。 链路质量数据。 - 表6 FwWanLinkQuality对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 timestamp int64 [0-2208959999] - 数据上报的格林威治时间(时间精度对应到秒)。 1537408636 upwardRate int64 [0-2208959999] - 接口上行速率,单位bps。 1537408636 downwardRate int64 [0-2208959999] - 接口下行速率,单位bps。 1537408636 packetLoss int64 [0-100] - 接口丢包率,百分比。 50 delay int64 [0-2208959999] - 接口时延时间,单位ms。 1537408636 jitter int64 [0-2208959999] - 接口抖动时间,单位ms。 1537408636 返回状态码为400:校验异常。 详细信息请参见实际响应消息体。
  • 请求示例 HTTP的示例 POST /controller/campus/api/v1/performance/interface/fw/wanlink/quality 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 { "mode" : "tenant", "id" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca", "pageIndex" : 10, "pageSize" : 10, "startTime" : 1537408636, "endTime" : 1537408636 }
  • 请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 queryParam 是 REFERENCE 详细请参见表2。 查询参数。 - 表2 WanLinkQualityRequest对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 mode 否 string - tenant 查询维度,tenant---租户、site---站点、device---设备。 "tenant" id 否 string 0~64个字符。 - mode为device时该ID为设备ID,UUID格式;mode为site时,该ID为站点ID,UUID格式;mode为tenant时,该ID为空。 "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca" pageIndex 否 int32 [1-10000] 1 页数。 10 pageSize 否 int32 [1-50] 10 每一页显示的条数。 10 startTime 否 int64 [0-2208959999] - 起始格林威治时间(时间精度对应到秒)。 startTime 与 endTime 约束规则如下: 租户维度支持查询15分钟内数据、站点维度支持查询1小时内数据、设备维度支持查询1天内数据 1537408636 endTime 否 int64 [0-2208959999] - 起始格林威治时间(时间精度对应到秒)。 startTime 与 endTime 约束规则如下: 租户维度支持查询15分钟内数据、站点维度支持查询1小时内数据、设备维度支持查询1天内数据 1537408636