CDN加速

文档中心 API文档 边缘云主机 节点实时冗余带宽查询(新)

节点实时冗余带宽查询(新)

更新时间:2021-06-16 10:51:35

适用产品:边缘云主机

接口描述

查询您所有在用的节点的实时冗余带宽,有冗余带宽的节点就返回True,无冗余带宽的节点就返回False,如果该节点的带宽数据采集结果不足以支撑该接口的时效性要求,即带宽统计数据较旧暂不满足时效性要求,则返回Undefined。节点是否有冗余带宽的判断方法:节点上限带宽大于节点的实时使用带宽。数据粒度:5分钟。 备注: 1)只返回客户有使用的节点的带宽冗余情况,有使用的前提是该客户在这个节点至少有1台云主机; 2)如果某个节点返回的result是Undefined,表示该节点无10分钟内的实时带宽统计数据,为了保证冗余带宽的时效性,返回Undefined,建议稍后再次调用该接口以查询该节点的最新情况; 3)如果节点是双线或多线节点,则分别返回每个运营商的带宽冗余情况; 4)节点的实时冗余带宽是动态变化的,若通过该接口的返回结果做业务调度,建议周期获取数据。

请求参数

JSON
参数名称类型必填描述
nodeNamesarray节点数组

返回参数

JSON
参数名称类型描述
nodesarray节点
nodeNamestring节点名称
nodeBwarray节点带宽
carrierstring运营商代码
resultstring节点是否有冗余带宽 True:有冗余带宽 False:无冗余带宽 Undefined:节点带宽统计数据不可用,是否有冗余带宽未知,建议稍后重新查询

示例

JSON
示例说明
请求示例
复制
POST /redundant-bandwidth
{
"nodeNames": ["node1","node2" ]
}
返回示例
复制
{
"nodes": {
    "nodeName": "node1",
    "nodeBw": [
           {
               "result": "True",
               "carrier": "dx"
           },
           {
               "result ": "False",
               "carrier": "wt"
           }
        ]
     }
}