发起路由器接口连接
描述
发起开放路由器接口互联请求,将一个发起端RouterInterface与其对端RouterInterface进行连接。
关于功能的说明:
只允许对Role为InitiatingSide的RouterInterface进行该操作;对于一个Role为AcceptingSide的RouterInterface来说,只能将连接对端信息设置好后,等待对方发起连接操作。
只有当对端RouterInterface也将连接对端设置为该RouterInterface,发起连接操作才能成功完成。
这是一个异步操作,API调用返回成功,意味着连接搭建工作已经开始,RouterInterface的Status进入Connecting状态(AcceptingSide的RouterInterface进入AcceptingConnect状态);当RouterInterface进入 Active状态时,连接才真正搭建起来。
路由器接口之间的连接,表示两个路由器通过一根虚拟的“链路”连接起来。若要在链路上正确的实现消息的传递,还需要在两边的路由器上正确地配置路由表,以及在实际通信>的对象上正确的配置访问控制规则;
该操作要求的条件与限制:
一个RouterInterface只能与一个RouterInterface建立连接;
一个RouterInterface不允许和自己进行连接;
一个RouterInterface不允许和同路由器上的其他RI进行连接
任意两个路由器之间,最多只能存在一对连接中的RouterInterface。
只有状态为Idle的RouterInterface上可以进行此操作;
若用户名下有RI处于欠费状态(即,由有成功扣款的RI账单),则不允许用户进行该操作
请求参数
名称 |
类型 |
是否必须 |
描述 |
Action
string
是
系统规定参数,取值:ConnectRouterInterface
RegionId
string
是
所在地域。
RouterInterfaceId
string
是
要发起连接的路由器接口的Id。
返回参数
全是公共返回参数,详见公共返回参数
错误码
错误代码 |
描述 |
Http 状态码 |
语义 |
InvalidRegionId.NotFound
The specified RegionId does not exist in our record.
404
指定的 RegionId 不存在
InvalidRouterInterfaceId.NotFound
The specified RouterInterfaceId does not exist in our record.
404
指定的 RouterInterfaceId 不存在
IncorrectRole.NotInitiatingSide
The spedified RouterInterface is not InitiatingSide
400
指定的 RouterInterface 不是发起端
IncorrectStatus
RouterInterface can be operated by this action only when it’s status is Idle.
400
当 RouterInterface 状态为 “Idle” 时才能执行操作
IncorrectOppositeInterfaceInfo.NotSet
OppositeInterfaceId/OppositeRouterId/OppositeRouterType/OppositeRouterOwnerId must be all set.
400
连接对端的信息未设置。
IncorrectOppositeInterfaceInfo
The opposite RouterInterface information specified by OppositeInterfaceId/OppositeRouterId/OppositeRouterType/OppositeRouterOwnerId is wrong. Maybe the RouterInterface or Router does not exist, or the parameters mismatched, or that RouterInterface is not a AcceptingSide.
400
对端路由器接口的信息错误。或许是对端RouterInterfaceId/ RouterId并不存在,也或许是几个参数之间的值不匹配,也或许是对端RouterInterface并不是一个接受端RouterInterface。
RejectedByOppositeInterface
The opposite RouterInterface does not set this RouterInterface as a OppositeRouterInterface. Meybe it was wrongly set. Please check the configuration of the opposite RouterInterface.
403
对端路由器接口并未将该路由器接口设置为连接对端。或许这是对端路由器接口上未能正确配置对端信息。请检查对端路由器接口上的配置。
Forbidden.BillsOutstanding
You cannot use this action because you have bills outstanding.
400
有未结清的账单,因而拒绝该操作;
所属专题: