Associates a virtual border router (VBR) with a physical connection.
Debugging
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.