Associates a virtual border router (VBR) with a physical connection.

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 AssociatePhysicalConnectionToVirtualBorderRouter

The operation that you want to perform.

Set the value to AssociatePhysicalConnectionToVirtualBorderRouter.

PhysicalConnectionId String Yes pc-bp1qrb3044eqixog****

The ID of the physical connection.
RegionId String Yes cn-hangzhou

The ID of the region where the physical connection is deployed.
VbrId String Yes vbr-bp186tnz6rijyhj******

The ID of the VBR.
VlanId String Yes 123

The VLAN ID of the VBR.

Valid values: 1 to 2999.

Note Only the owner of the physical connection can set this parameter. The VLAN IDs of two VBRs of the same physical connection must be different.
CircuitCode String No longtel001

The circuit code provided by the Internet service provider (ISP) of the physical connection.

Note Only the owner of the physical connection can set this parameter.
LocalGatewayIp String No 10.10.**. **

The IP address of the VBR on the Alibaba Cloud side.
PeerGatewayIp String No 10.10.**. **

The IP address of the peer router interface of the VBR.

Only the owner of the VBR can set or modify the value. If the VBR is in the Enabled state, you cannot leave this parameter empty.

PeeringSubnetMask String No 255.255.255.0

The subnet mask for the IP addresses of the VBR on the Alibaba Cloud side and on the user side.

The two IP addresses must fall within the same subnet.
ClientToken String No 02fb3da4-130e-11e9-8e44-00xxxxxxxx

The client token that is used to ensure the idempotence of the request.

You can use the client to generate the value, but you must ensure that it is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.

Response parameters

Parameter Type Example Description
RequestId String 980960B0-2969-40BF-8542-EBB34FD358AB

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/? Action=AssociatePhysicalConnectionToVirtualBorderRouter
&PhysicalConnectionId= pc-bp1qrb3044eqixog****
&RegionId=cn-hangzhou
&VbrId=vbr-bp186tnz6rijyhj******
&VlanId=123
&<Common request parameters>

Sample success responses

XML format 

<AssociatePhysicalConnectionToVirtualBorderRouterResponse>
	  <RequestId>980960B0-2969-40BF-8542-EBB34FD358AB</RequestId>
    </AssociatePhysicalConnectionToVirtualBorderRouterResponse>

JSON format 

{
    "RequestId": "980960B0-2969-40BF-8542-EBB34FD358AB"
}

Error codes

HttpCode Error code Error message Description
404 InvalidInstanceId.NotFound The specified Instance does not exist in the specified region. The error message returned because the instance does not exist in the specified region.
404 InvalidVbrId.NotFound The specified VirutalBorderRouter does not exist in our records. The error message returned because the specified VBR ID does not exist. Check whether the specified VBR ID is valid.
400 InvalidOperation.RouterInterfaceNotDeleted The specified VirutalBorderRouter still has routerInterface. The error message returned because the VBR is associated with a router interface.
400 InvalidOperation.OperationNotAllowedInState The specified VirutalBorderRouter is in invalid state. The error message returned because the state of the VBR is invalid. Check the state of the VBR.
403 Forbidden.OperationNotAllowedByUser The caller is not allowed to delete the specified VirtualBorderRouter. The error message returned because you are not allowed to delete the VBR.
403 Forbidden.MultiVlanRi Multiple vlan router interfaces are found. The error message returned because multiple VLAN router interfaces exist.
403 Forbidden.NoRiFound No vlan router interfaces are found. The error message returned because no VLAN router interface is available.
400 InvalidStatus.NotAllowed Invalid virtual border router status. The error message returned because the state of the VBR does not support this operation.
404 InvalidRegionId.NotFound The specified RegionId is not found. The error message returned because the specified region ID does not exist. Check whether the region ID is valid.
400 InvalidPhysicalConnectionId.NotFound The specified PhysicalConnectionId is not found. The error message returned because the ID of the physical connection does not exist.
400 InvalidVlanId.Used The specified VlanId has been used. The error message returned because the VLAN ID is being used.
400 MissingParameter The input parameter 'PhysicalConnectionId' that is mandatory for processing this request is not supplied. The error message returned because PhysicalConnectionId is not set.
400 InvalidPhysicalConnectionId.NotEnabled The specified PhysicalConnectionId is not in Enabled state. The error message returned because the state of the physical connection is invalid. Check the physical connection and try again.
404 InvalidVbrOwnerId.NotFound The specified VbrOwnerId is not valid. The error message returned because VbrOwnerId is set to an invalid value.
400 MissingParameter The input parameter 'VlanId' that is mandatory for processing this request is not supplied. The error message returned because VlanId is not set.
400 InvalidVlanId.Malformed The specified VlanId is not valid. The error message returned because VlanId is set to an invalid value.
400 InvalidCircuitCode.Malformed The specified CircuitCode is not valid. The error message returned because CircuitCode is set to an invalid value.
400 MissingParameter The input parameter 'LocalGatewayIp' that is mandatory for processing this request is not supplied. The error message returned because LocalGatewayIp is not set.
400 InvalidLocalGatewayIp.Malformed The specified LocalGatewayIp is not valid. The error message returned because the IP address of the local gateway is invalid.
400 MissingParameter The input parameter 'PeerGatewayIp' that is mandatory for processing this request is not supplied. The error message returned because PeerGatewayIp is not set.
400 InvalidPeerGatewayIp.Malformed The specified PeerGatewayIp is not valid. The error message returned because PeerGatewayIp is set to an invalid value.
400 MissingParameter The input parameter 'PeeringSubnetMask' that is mandatory for processing this request is not supplied. The error message returned because PeeringSubnetMask is not set.
400 InvalidPeeringSubnetMask.Malformed The specified PeeringSubnetMask is not valid. The error message returned because PeeringSubnetMask is set to an invalid value. Check whether PeeringSubnetMask is set to a valid value.
403 Forbidden.LocalGatewayIpNotAllowedByCaller The caller is not allowed to specify the LocalGatewayIp parameter. The error message returned because you are not allowed to set LocalGatewayIp.
403 Forbidden.PeerGatewayIpNotAllowedByCaller The caller is not allowed to specify the PeerGatewayIp parameter. The error message returned because you are not allowed to set PeerGatewayIp.
403 Forbidden.PeeringSubnetMaskNotAllowedByCaller The caller is not allowed to specify the PeeringSubnetMask parameter. The error message returned because you are not allowed to set PeeringSubnetMask.
403 Forbidden.NameNotAllowedByCaller The caller is not allowed to specify the Name parameter. The error message returned because you are not allowed to set Name.
403 Forbidden.DescriptionNotAllowedByCaller The caller is not allowed to specify the Description parameter. The error message returned because you are not allowed to set Description.
400 InvalidName.Malformed The specified ? Name? is not valid. The error message returned because the format of the name is invalid.
400 InvalidDescription.Malformed The specifid ? Description? is not valid. The error message returned because the format of the resource description is invalid. The description must be 2 to 256 characters in length and cannot start with http:// or https://.
400 QuotaExceeded.vbrPerpConn Virtual boarder router per PhysicalConnection quota exceed. The error message returned because the number of VBRs of each physical connection has reached the upper limit. Reduce the number of VBRs and try again.
400 EXCEED_ASSOCIATE_MAX_NUM assocaite virtual boarder num too many. The error message returned because the number of associated VBRs has reached the upper limit.
400 InvalidIP.Malformed Ip malformed. The error message returned because the format of the IP address is invalid.
400 InvalidIp.NotSameSubnet Local gateway ip and peer gateway ip are not in the same subnet. The error message returned because the IP addresses of the local gateway and the peer gateway do not fall within the same subnet.
400 InvalidStatus.StatusNotEnabled The physical connection status is invalid. The error message returned because the state of the physical connection does not support this operation. Check the state of the physical connection.
400 PHYSICAL_NOT_ALLOW_ASSOCIATE_VBR The specified operation not allow. The error message returned because the physical connection is associated with a VBR and the operation cannot be performed.

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