节点实时冗余带宽查询（新）
更新时间：2023-06-29 15:11:34
适用产品
边缘云主机
接口描述
查询您所有在用的节点的实时冗余带宽，有冗余带宽的节点就返回True，无冗余带宽的节点就返回False，如果该节点的带宽数据采集结果不足以支撑该接口的时效性要求，即带宽统计数据较旧暂不满足时效性要求，则返回Undefined。节点是否有冗余带宽的判断方法：节点上限带宽大于节点的实时使用带宽。数据粒度：5分钟。 备注： 1）只返回客户有使用的节点的带宽冗余情况，有使用的前提是该客户在这个节点至少有1台云主机； 2）如果某个节点返回的result是Undefined，表示该节点无10分钟内的实时带宽统计数据，为了保证冗余带宽的时效性，返回Undefined，建议稍后再次调用该接口以查询该节点的最新情况； 3）如果节点是双线或多线节点，则分别返回每个运营商的带宽冗余情况； 4）节点的实时冗余带宽是动态变化的，若通过该接口的返回结果做业务调度，建议周期获取数据。
- 调用URL： https://open.chinanetcenter.com/vmp/redundant-bandwidth
- 调用方法：POST
推荐使用 Open API在线调试
Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试
请求参数
Body 参数
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
nodeNames | 否 | 节点数组 |
返回参数
Body 参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
nodes | 节点 | |
nodeName | 节点名称 | |
nodeBw | 节点带宽 | |
carrier | 运营商代码 | |
result | 节点是否有冗余带宽 True：有冗余带宽 False：无冗余带宽 Undefined：节点带宽统计数据不可用，是否有冗余带宽未知，建议稍后重新查询 |
示例
JSON
- 请求示例 复制成功
POST /redundant-bandwidth { "nodeNames": ["node1","node2" ] }- 返回示例 复制成功
{ "nodes": { "nodeName": "node1", "nodeBw": [ { "result": "True", "carrier": "dx" }, { "result ": "False", "carrier": "wt" } ] } }
本篇文档内容对您是否有帮助？
有帮助
我要反馈