Deletes a Virtual Border Router (VBR).

Note the following before you delete a VBR:

  • Before you delete a VBR, you must delete all router interfaces on the VBR.
  • You can only delete a VBR that is in the Unconfirmed, Enabled, or Terminated state.
  • If the VBR you want to delete is under another Alibaba Cloud account, the VBR must be in the Unconfirmed state.

Debug

Use OpenAPI Explorer to perform debug operations and generate SDK code examples.

Request parameters

Parameter Type Required? Example value Description
Action String Yes DeleteVirtualBorderRouter

The name of this action.

Value: DeleteVirtualBorderRouter
RegionId String Yes cn-shanghai

The ID of the region to which the VBR belongs. To query the region ID, call DescribeRegions.

VbrId String Yes vbr-bp12mw1f8k3jgygk9****

The ID of the VBR.

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

Optional. The client token. It is used to guarantee the idempotence of the request.

The value of this parameter is generated by the client and is unique among all requests. It can contain up to 64 ASCII characters.

Response parameters

Parameter Type Example value Description
RequestId String F8BF7D24-F3EB-4E23-9208-B77C6EB78E75

The request ID.

Examples

Request example


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

Response examples

XML format 

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

JSON format 

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

Errors

HTTP status code Error code Error message Description
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 The virtual border has been associated by physicalConnection. The VBR is already associated with a physical connection.

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