主题
接口描述
批量获取节点带宽信息 (查询跨度最大 3 天)
请求路径
POST
/v1/ant/nodes/stats
请求参数
名称 | 类型 | 位置 | 必须 | 描述 |
---|---|---|---|---|
Authorization | string | header | 是 | 鉴权 token |
nodeIds | []string | json | 是 | 节点 Ids;单次最大查询 100 个节点 |
granularity | string | json | 是 | 粒度
|
start | string | json | 是 | 开始时间,格式:yyyyMMddHHmm |
end | string | json | 是 | 结束时间,格式:yyyyMMddHHmm |
返回值
名称 | 类型 | 描述 |
---|---|---|
nodeDatas | []NodeStatInfo |
NodeStatInfo
名称 | 类型 | 描述 |
---|---|---|
nodeId | string | 节点 Id,与参数中的 nodeIds 对应 |
data | []StatInfo | 带宽数据 |
StatInfo
名称 | 类型 | 描述 |
---|---|---|
time | int | 时间,时间戳:秒 |
up | int | 上行带宽,单位:bps |
down | int | 下行带宽,单位:bps |
请求示例
json
返回值示例
json
正常请求:
http code 200
{
"nodeDatas": [
{
"nodeId": "xx",
"data": [
{
"time": 1630360800,
"up": 1000,
"down": 2000
},
{
"time": 1630360900,
"up": 1000,
"down": 2000
}
]
}
]
}
异常请求:
http code 4xx/5xx
{
"code": 4000001,
"desc": ""
}
错误码列表
错误码 | 描述 |
---|---|
401 | 鉴权失败 |
4000002 | 节点未查找到 |
如接口返回错误码未列举,可在错误码总览中查找