Associates a Virtual Border Router (VBR) with a physical connection.
Debug
Use OpenAPI Explorer to perform debug operations and generate SDK code examples.
Request parameters
| Parameter | Type | Required? | Example value | Description |
|---|---|---|---|---|
| Action | String | Yes | AssociatePhysicalConnectionToVirtualBorderRouter |
The name of this action. Value: AssociatePhysicalConnectionToVirtualBorderRouter |
| PhysicalConnectionId | String | Yes | pc-bp1qrb3044eqixog**** |
The ID of the physical connection. |
| RegionId | String | Yes | cn-hangzhou |
The region ID of the physical connection. |
| VbrId | String | Yes | vbr-bp186tnz6rijyhj****** |
The ID of the VBR. |
| VlanId | String | Yes | 123 |
The VLAN ID of the VBR. Value range: 1 to 2999 Note Only the owner of the physical connection can specify this parameter. The VLAN IDs
of two VBRs in the same physical connection must be different.
|
| CircuitCode | String | No | longtel001 |
Optional. The leased line code provided by the service provider for the physical connection. Note This parameter can only be specified by the owner of the physical connection.
|
| ClientToken | String | No | 02fb3da4-130e-11e9-8e44-00xxxxxxxx |
Optional. The client token used to guarantee the idempotence of the request. The value of this parameter is generated by the client. The value is unique among different requests and 1 to 64 ASCII characters in length. |
| LocalGatewayIp | String | No | 10.10.0.1 |
Optional. The Alibaba Cloud-side IP address used by the VBR. |
| PeerGatewayIp | String | No | 10.10.10.9 |
Optional. The customer-side IP address used by the VBR. This parameter can only be specified or modified by the VBR owner. You cannot change the value of this parameter to null for a VBR in the Enabled state. |
| PeeringSubnetMask | String | No | 255.255.255.0 |
Optional. The subnet mask of the Alibaba Cloud-side IP address and the customer-side IP address. The two IP addresses must belong to the same subnet. |
Response parameters
| Parameter | Type | Example value | Description |
|---|---|---|---|
| RequestId | String | 980960B0-2969-40BF-8542-EBB34FD358AB |
The request ID. |
Examples
Request example
http(s)://[Endpoint]/? Action=AssociatePhysicalConnectionToVirtualBorderRouter
&PhysicalConnectionId= pc-bp1qrb3044eqixog****
&RegionId=cn-hangzhou
&VbrId=vbr-bp186tnz6rijyhj******
&VlanId=123
&<CommonParameters>
Response examples
XML format
<AssociatePhysicalConnectionToVirtualBorderRouterResponse>
<RequestId>980960B0-2969-40BF-8542-EBB34FD358AB</RequestId>
</AssociatePhysicalConnectionToVirtualBorderRouterResponse>JSON format
{
"RequestId":"980960B0-2969-40BF-8542-EBB34FD358AB"
}Errors
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 404 | InvalidInstanceId.NotFound | The specified Instance does not exist in the specified region. | The specified instance does not exist in the specified region. |
| 404 | InvalidVbrId.NotFound | The specified VirutalBorderRouter does not exist in our records. | The specified VBR does not exist. |
| 400 | InvalidOperation.RouterInterfaceNotDeleted | The specified VirutalBorderRouter still has routerInterface. | The specified VBR is associated with router interfaces. |
| 400 | InvalidOperation.OperationNotAllowedInState | The specified VirutalBorderRouter is in invalid state. | The status of the VBR does not permit this operation. |
| 403 | Forbidden.OperationNotAllowedByUser | The caller is not allowed to delete the specified VirtualBorderRouter. | You are not allowed to delete the specified VBR. |
| 403 | Forbidden.MultiVlanRi | Multiple vlan router interfaces are found. | Multiple VLAN router interfaces exist. |
| 403 | Forbidden.NoRiFound | No vlan router interfaces are found. | No VLAN router interface is available. |
| 400 | InvalidStatus.NotAllowed | Invalid virtual border router status. | The status of the VBR does not permit this operation. |
| 404 | InvalidRegionId.NotFound | The specified RegionId is not found. | The specified region ID is invalid. Please check if the cloud service is available in the specified region. |
| 400 | InvalidPhysicalConnectionId.NotFound | The specified PhysicalConnectionId is not found. | The specified physical connection ID is invalid. |
| 400 | InvalidVlanId.Used | The specified VlanId has been used. | The specified VLAN is already occupied. |
| 400 | MissingParameter | The input parameter 'PhysicalConnectionId' that is mandatory for processing this request is not supplied. | The PhysicalConnectionId parameter must be specified. |
| 400 | InvalidPhysicalConnectionId.NotEnabled | The specified PhysicalConnectionId is not in Enabled state. | The status of the specified physical connection does not permit this operation. |
| 404 | InvalidVbrOwnerId.NotFound | The specified VbrOwnerId is not valid. | The value of the VbrOwnerId parameter is invalid. |
| 400 | MissingParameter | The input parameter 'VlanId' that is mandatory for processing this request is not supplied. | The VlanId parameter must be specified. |
| 400 | InvalidVlanId.Malformed | The specified VlanId is not valid. | The specified value of the VlanId parameter is invalid. |
| 400 | InvalidCircuitCode.Malformed | The specified CircuitCode is not valid. | The specified value of the CircuitCode parameter is invalid. |
| 400 | MissingParameter | The input parameter 'LocalGatewayIp' that is mandatory for processing this request is not supplied. | The LocalGatewayIp parameter must be specified. |
| 400 | InvalidLocalGatewayIp.Malformed | The specified LocalGatewayIp is not valid. | 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 PeerGatewayIp parameter must be specified. |
| 400 | InvalidPeerGatewayIp.Malformed | The specified PeerGatewayIp is not valid. | The specified value of the PeerGatewayIp parameter is invalid. |
| 400 | MissingParameter | The input parameter 'PeeringSubnetMask' that is mandatory for processing this request is not supplied. | The PeeringSubnetMask parameter must be specified. |
| 400 | InvalidPeeringSubnetMask.Malformed | The specified PeeringSubnetMask is not valid. | The specified value of the PeeringSubnetMask parameter is invalid. |
| 403 | Forbidden.LocalGatewayIpNotAllowedByCaller | The caller is not allowed to specify the LocalGatewayIp parameter. | You are not allowed to specify the LocalGatewayIp parameter. |
| 403 | Forbidden.PeerGatewayIpNotAllowedByCaller | The caller is not allowed to specify the PeerGatewayIp parameter. | You are not allowed to specify the PeerGatewayIp parameter. |
| 403 | Forbidden.PeeringSubnetMaskNotAllowedByCaller | The caller is not allowed to specify the PeeringSubnetMask parameter. | You are not allowed to specify the PeeringSubnetMask parameter. |
| 403 | Forbidden.NameNotAllowedByCaller | The caller is not allowed to specify the Name parameter. | You are not allowed to specify the Name parameter. |
| 403 | Forbidden.DescriptionNotAllowedByCaller | The caller is not allowed to specify the Description parameter. | You are not allowed to specify the Description parameter. |
| 400 | InvalidName.Malformed | The specified ? Name? is not valid. | The format of the name is invalid. |
| 400 | InvalidDescription.Malformed | The specifid ? Description? is not valid. | The format of the description is invalid. The description must be 2 to 256 characters in length. It cannot start with http:// or https://. |
| 400 | QuotaExceeded.vbrPerpConn | Virtual boarder router per PhysicalConnection quota exceed. | The VBR quota for the physical connection is exceeded. |
| 400 | EXCEED_ASSOCIATE_MAX_NUM | assocaite virtual boarder num too many. | The quota of associated VBRs is exceeded. |
| 400 | InvalidIP.Malformed | Ip malformed. | The IP address format is invalid. |
| 400 | InvalidIp.NotSameSubnet | Local gateway ip and peer gateway ip are not in the same subnet. | The local gateway IP address and the peer gateway IP address do not belong to the same subnet. |
| 400 | InvalidStatus.StatusNotEnabled | The physical connection status is invalid. | The status of the physical connection does not permit this operation. |
| 400 | PHYSICAL_NOT_ALLOW_ASSOCIATE_VBR | The specified operation not allow. | The operation failed because the physical connection is associated with VBRs. |
For a list of error codes, visit the API Error Center.