Deletes a virtual border router (VBR).

Limits

When you call this operation, take note of the following limits:

  • Before you delete a VBR, you must delete all router interfaces of the VBR.
  • You can delete only a VBR that is in the Unconfirmed, Enabled, or Terminated state.
  • If the owner of an Express Connect circuit wants to delete a VBR that belongs to another Alibaba Cloud account, the VBR must be in the Unconfirmed state.

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 DeleteVirtualBorderRouter

The operation that you want to perform.

Set the value to DeleteVirtualBorderRouter.

RegionId String Yes cn-shanghai

The ID of the region where the VBR is deployed. You can call the DescribeRegions operation to query the most recent region list.

VbrId String Yes vbr-bp12mw1f8k3jgygk9****

The ID of the VBR.

ClientToken String No 02fb3da4-130e-11e9-8e44-0016e04115b

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

You can use the client to generate a token, but you must ensure that the token 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 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DeleteVirtualBorderRouter
&RegionId=cn-shanghai
&VbrId=vbr-bp12mw1f8k3jgygk9****
&<Common request parameters>

Sample success responses

XML format 

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

JSON format 

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

Error codes

HttpCode Error code Error message Description
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 specified VBR is in an invalid state. Check the state of the VBR.
403 Forbidden.OperationDeleteNotAllowedByUser The caller is not allowed to delete the specified VirtualBorderRouter. The error message returned because you do not have the permissions 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 The virtual border has been associated by physicalConnection. The error message returned because the VBR is associated with an Express Connect circuit.

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