全部产品
Search
文档中心

专有网络 VPC:ConnectRouterInterface - 由发起端路由器接口向接收端发起连接

更新时间:Mar 04, 2024

调用ConnectRouterInterface接口由发起端路由器接口向接收端发起连接。

接口说明

调用本接口后路由器接口进入 Connecting 状态,连接完成后进入 Active 状态。

调用该接口创建 VPC 时,请注意:

  • 只能由状态为 Idle 的发起端路由器接口向接收端发起连接。
  • 任意两个路由器之间,最多只能存在一对相互连接的路由器接口。
  • 如果账号下存在处于欠费状态的路由器接口,无法进行发起连接。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
vpc:ConnectRouterInterfaceWrite
  • RouterInterface
    acs:vpc:{#regionId}:{#accountId}:routerinterface/{#RouterInterfaceId}

请求参数

名称类型必填描述示例值
RegionIdstring

路由器接口所在的地域。

您可以通过调用 DescribeRegions 接口获取地域 ID。

cn-hangzhou
RouterInterfaceIdstring

发起端路由器接口的 ID。

ri-2zeo3xzyf38r4urzd****

返回参数

名称类型描述示例值
object

请求 ID。

RequestIdstring

请求 ID。

DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6

示例

正常返回示例

JSON格式

{
  "RequestId": "DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6"
}

错误码

HTTP status code错误码错误信息描述
400IncorrectRole.NotInitiatingSideThe specified RouterInterface is not InitiatingSide.该路由器接口不是发起端,请选择发起端的路由器接口进行发起连接。
400IncorrectRIStatusRouterInterface can be operated by this action only when it's status is Idle.只有路由器接口处于“闲置”状态时,才可以使用此操作。
400IncorrectOppositeInterfaceInfo.NotSetOppositeInterfaceId/OppositeRouterId/OppositeRouterType/OppositeInterfaceOwnerId must be all set.参数OppositeInterfaceId/OppositeRouterId/OppositeRouterType/OppositeInterfaceOwnerId必须全部设置。
400IncorrectOppositeInterfaceInfoCannot connect on the same router不允许连接相同的路由器。
400IncorrectOppositeInterfaceInfoThe opposite RouterInterface information specified by OppositeInterfaceId/OppositeRouterId/OppositeRouterType/OppositeInterfaceOwnerId is wrong. Maybe the RouterInterface or Router does not exist, or the parameters mismatched, or that RouterInterface is not a AcceptingSide.-
400Forbidden.OnlyOneConnectionThe Specified routers have a connection already该路由器已有路由器接口连接。
400Forbidden.OnlyOneConnectionCannot connect concurrently between same routers不能在同一路由器上发起连接。
400Forbidden.BillsOutstandingYou cannot use this action because you have bills outstanding.无法执行该操作,您有未结算的账单。
400InvalidAccount.NotFoundThe specified account is not exists.-
400ErrCode.Invalidgot error-
400AttrMismatching.AcceptingSideRole%s-
400AttrMismatching.AcceptingSideInstanceId%s-
400AttrMismatching.AcceptingSideRegionNo%s-
400AttrMismatching.AcceptingSideRouterId%s-
400AttrMismatching.AcceptingSideRouterType%s-
400AttrMismatching.AcceptingSideAliUid%s-
400AttrMismatching.AcceptingSideOppositeInterfaceOwnerId%s-
400AttrMismatching.AcceptingSideOppositeRegionNo%s-
400AttrMismatching.AcceptingSideOppositeInterfaceId%s-
400AttrMismatching.AcceptingSideOppositeRouterId%s-
400AttrMismatching.AcceptingSideOppositeRouterType%s-
400IllegalParam.InstanceOwnerThe router instance owener error.-
404InvalidRegionId.NotFoundThe RegionId provided does not exist in our records.指定的RegionId不存在。请检查该参数是否正确。
404InvalidRouterInterfaceId.NotFoundThe specified RouterInterfaceId does not exist in our record.指定的路由器接口不存在,请您检查填写的路由器接口是否正确。
404CROSS_BID.FORBIDDENConnect RouterInterface across bid is illegal跨BID连接非法。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-12-21OpenAPI 描述信息更新、OpenAPI 去除了 deprecated 标记、OpenAPI 错误码发生变更看变更集
变更项变更内容
API 描述OpenAPI 描述信息更新
API 弃用说明(deprecated)OpenAPI 去除了 deprecated 标记
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:404
2023-07-21OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码:404