Initiates a connection from an initiator router interface to a receiver router interface.

After you call this operation, the router interface enters the Connecting state. When the connection is established, it enters the Active state.

When you call this operation, make sure that the following requirements are met:

  • Only an initiator router interface in the Idle state can initiate a connection.
  • You can create only one pair of connected router interfaces between two routers.
  • You cannot initiate a connection if your Alibaba Cloud account has a router interface with overdue payments.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ConnectRouterInterface

The operation that you want to perform.

Set the value to ConnectRouterInterface.

RegionId String Yes cn-hangzhou

The ID of the region where the router interface is deployed. You can call the DescribeRegions operation to query region IDs.

RouterInterfaceId String Yes ri-2zeo3xzyf38r4urzd****

The ID of the initiator router interface.

Response parameters

Parameter Type Example Description
RequestId String DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6

The ID of the request.

Examples

Sample requests


http(s)://vpc.aliyuncs.com/? Action=ConnectRouterInterface
&RegionId= cn-hangzhou
&RouterInterfaceId=ri-2zeo3xzyf38r4urz****
&<Common Request Parameters>

Sample success responses

XML format

<ConnectRouterInterfaceResponse>
      <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</ConnectRouterInterfaceResponse>

JSON format

{
	"RequestId":"0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Error codes

HttpCode Error code Error message Description
404 InvalidRouterInterfaceId.NotFound The specified RouterInterfaceId does not exist in our record. The error message returned because the specified router interface does not exist. Check whether the specified router interface is valid.
400 IncorrectRole.NotInitiatingSide The specified RouterInterface is not InitiatingSide. The error message returned because the specified router interface is not an initiator. Select an initiator router interface.
400 IncorrectOppositeInterfaceInfo Cannot connect on the same router The error message returned because you cannot connect a router to itself.
400 Forbidden.OnlyOneConnection The Specified routers have a connection already The error message returned because the router is already connected to a router interface.
400 Forbidden.OnlyOneConnection Cannot connect concurrently between same routers The error message returned because you cannot initiate a connection on the same router.
400 Forbidden.BillsOutstanding You cannot use this action because you have bills outstanding. The error message returned because you have uncompleted payments and cannot call this operation.
404 CROSS_BID.FORBIDDEN Connect RouterInterface across bid is illegal The error message returned because cross-BID connections are invalid.

For a list of error codes, visit the API Error Center.