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.