主题
接口描述
获取节点计量带宽信息 (查询跨度最大 31 天)
请求路径
POST
/v1/nodes/daymeasure/stats
请求参数
名称 | 类型 | 位置 | 必须 | 描述 |
---|---|---|---|---|
Authorization | string | header | 是 | 鉴权 token |
Content-Type | string | header | 是 | 数据类型 application/json |
nodeIDs | []string | body | 是 | 节点 IDs,单次最大查询 100 个节点 |
start | string | body | 是 | 开始时间,格式:yyyy-MM-dd |
end | string | body | 是 | 结束时间,格式:yyyy-MM-dd |
返回值
名称 | 类型 | 描述 |
---|---|---|
data | []NodeDayMeasureStatsItem | 带宽数据 |
NodeDayMeasureStatsItem
名称 | 类型 | 描述 |
---|---|---|
nodeId | string | 节点 ID |
dayMeasure | map | 每天的计量带宽列表,key 为 yyyy-MM-dd 格式的日期,value 为 bps 单位的带宽数据 |
errorCode | int | 错误码 |
请求示例
json
{
"nodeIDs": ["hdshkdjsdkj", "hdshkdjdasd"],
"start": "2024-10-01",
"end": "2024-10-10"
}
返回值示例
json
正常请求:
http code 200
{
"data": [
{
"nodeId": "hdshkdjsdkj",
"dayMeasure": {
"2024-10-01": 1,
"2024-10-02": 2,
"2024-10-03": 3,
"2024-10-04": 4,
"2024-10-05": 5,
"2024-10-06": 6,
"2024-10-07": 7,
"2024-10-08": 8,
"2024-10-09": 9,
"2024-10-10": 10,
},
"errorCode": 0
},
{
"nodeId": "hdshkdjdasd",
"dayMeasure": {
"2024-10-01": 1,
"2024-10-02": 2,
"2024-10-03": 3,
"2024-10-04": 4,
"2024-10-05": 5,
"2024-10-06": 6,
"2024-10-07": 7,
"2024-10-08": 8,
"2024-10-09": 9,
"2024-10-10": 10,
},
"errorCode": 0
}
]
}
异常请求:
http code 4xx/5xx
{
"code": 4000001,
"desc": ""
}
错误码列表
错误码 | 描述 |
---|---|
401 | 鉴权失败 |
4000002 | 节点未查找到 |
如接口返回错误码未列举,可在错误码总览中查找