-
请求示例 HTTP的示例 PUT /controller/campus/v1/sdwan/net/site/bgp-reset 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
{
"siteIds" : [
"00000000-0000-0000-0000-000000000000"
]
}
-
响应参数 返回状态码为200:正常响应返回体,响应体参考BgpResetResponse。 表3 BgpResetResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" success ARRAY_REFERENCE 1-10个列表项,详细请参见表4。 重建BGP连接成功的站点信息列表。 - fail ARRAY_REFERENCE 1-10个列表项,详细请参见表4。 重建BGP连接失败的站点信息列表。 - 表4 BgpResetResponseInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 siteId uuid 0~36个字符。 - 站点ID。 "00000000-0000-0000-0000-000000000000" siteName string 0~64个字符。 - 站点名称。 "site1" deviceId uuid 0~36个字符。 - 设备ID。 "00000000-0000-0000-0000-000000000000" deviceName string 0~64个字符。 - 设备名称。 "device1" errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" 返回状态码为400:校验异常。 详细信息请参见实际响应消息体。 返回状态码为500:内部错误。 详细信息请参见实际响应消息体。
-
响应示例 返回状态码为200:正常响应返回体,响应体参考BgpResetResponse。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "",
"success" : [
{
"siteId" : "00000000-0000-0000-0000-000000000000",
"siteName" : "site1",
"deviceId" : "00000000-0000-0000-0000-000000000000",
"deviceName" : "device1",
"errcode" : "0",
"errmsg" : ""
}
],
"fail" : [
{
"siteId" : "00000000-0000-0000-0000-000000000000",
"siteName" : "site1",
"deviceId" : "00000000-0000-0000-0000-000000000000",
"deviceName" : "device1",
"errcode" : "0",
"errmsg" : ""
}
]
} 返回状态码为400:校验异常。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500:内部错误。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
响应参数 返回状态码为200:正常响应返回体,响应体参考BgpVpnResetResponse。 表3 BgpVpnResetResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" success ARRAY_REFERENCE 1-10个列表项,详细请参见表4。 连接成功的信息列表。 - fail ARRAY_REFERENCE 1-10个列表项,详细请参见表4。 连接失败的信息列表。 - 表4 BgpVpnResetResponseInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 vpnId uuid 0~36个字符。 - VPN ID。 "00000000-0000-0000-0000-000000000000" vpnName string 0~64个字符。 - VPN名称。 "vpn1" siteId uuid 0~36个字符。 - 站点ID。 "00000000-0000-0000-0000-000000000000" siteName string 0~64个字符。 - 站点名称。 "site1" errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" 返回状态码为400:校验异常。 详细信息请参见实际响应消息体。 返回状态码为500:内部错误。 详细信息请参见实际响应消息体。
-
响应示例 返回状态码为200:正常响应返回体,响应体参考BgpVpnResetResponse。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "",
"success" : [
{
"vpnId" : "00000000-0000-0000-0000-000000000000",
"vpnName" : "vpn1",
"siteId" : "00000000-0000-0000-0000-000000000000",
"siteName" : "site1",
"errcode" : "0",
"errmsg" : ""
}
],
"fail" : [
{
"vpnId" : "00000000-0000-0000-0000-000000000000",
"vpnName" : "vpn1",
"siteId" : "00000000-0000-0000-0000-000000000000",
"siteName" : "site1",
"errcode" : "0",
"errmsg" : ""
}
]
} 返回状态码为400:校验异常。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500:内部错误。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
接口约束 1、该接口支持租户视图或msp代维视图下,角色为“Open Api Operator”的用户访问,必须在用户会话建立后使用。 2、该接口仅支持在Topo中配置为gateway角色的站点,在重建BGP连接之前,需要确认差分模式已配置成功,差分模式配置状态可调用配置结果查询接口查看。 3、重置BGP操作会导致该VPN下业务中断,请谨慎操作。 4、目前对于mpls骨干的远端交叉路由(已经建立了lsp)需要使用reset mpls ldp或者reset bgp才会生效,如果生效后指定的EXP不满足,建议发往mpls方向的流量部署QOS修改为期望的exp。 该API可能会直接或间接影响现网业务运行,导致业务中断、关键数据丢失等,请谨慎操作!
-
请求示例 HTTP的示例 PUT /controller/campus/v1/sdwan/net/site/bgp-vpn-reset HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy
{
"vpnId" : "00000000-0000-0000-0000-000000000000",
"siteIds" : [
"00000000-0000-0000-0000-000000000000"
]
}