All Products
Search
Document Center

Express Connect:DeleteVirtualBorderRouter

Last Updated:Aug 28, 2026

Deletes a virtual border router (VBR).

Operation description

Before you call this operation, note the following limits:

  • Before you delete a VBR, you must delete all router interfaces of the VBR.

  • You can delete only a VBR in the unconfirmed, active, or terminated state.

  • The owner of an Express Connect circuit can delete a VBR that belongs to another account only if the VBR is in the unconfirmed state.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

The region ID of the VBR. You can call the DescribeRegions operation to query the latest region list.

cn-shanghai

VbrId

string

Yes

The ID of the VBR.

vbr-bp12mw1f8k3jgygk9****

ClientToken

string

No

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

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

02fb3da4-130e-11e9-8e44-0016e04115b

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Examples

Success response

JSON format

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

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidOperation.RouterInterfaceNotDeleted The specified VirutalBorderRouter still has routerInterface.
400 InvalidOperation.OperationNotAllowedInState The specified VirutalBorderRouter is in invalid state.
400 InvalidStatus.NotAllowed The virtual border has been associated by physicalConnection.
400 DependencyViolation.RouterInterfaceReferedByRouteEntry The specified VirutalBorderRouter is refered by routeEntry. The VBR is already used.
400 DependencyViolation.BgpGroup bgp group exists, cannot delete vbr. The VBR is associated with a BGP group and cannot be deleted.
400 DependencyViolation.Nqa nqa exists, cannot delete vbr. You cannot delete the VBR because nqa exists.
400 DependencyViolation.BgpNetwork bgp network exists, cannot delete vbr. You cannot delete the VBR because the VBR has advertised BGP CIDR blocks.
400 OperationUnsupported.VBRAttachedCen Operation failed because the VBR is attached to CEN.
400 InvalidStatus.vbrAttatchToEcr Invalid virtual border router ecr status. VBR and ECR are bound, please unbind first
403 Forbidden.OperationDeleteNotAllowedByUser The caller is not allowed to delete the specified VirtualBorderRouter. The caller is not allowed to delete the specified VirtualBorderRouter.
403 Forbidden.MultiVlanRi Multiple vlan router interfaces are found.
403 Forbidden.NoRiFound No vlan router interfaces are found.
404 InvalidRegionId.NotFound The RegionId provided does not exist in our records.
404 InvalidVbrId.NotFound The specified VirutalBorderRouter does not exist in our records.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.