Delete a VBR.
Note the following before deleting a VBR:
- You must delete all router interfaces on the VBR.
- You can only delete a VBR in the Unconfirmed, Enabled, or Terminated status.
- If the VBR you want to delete is under another Alibaba Cloud account, the VBR must be in the Unconfirmed status.
Debug
By using API Explorer, you can easily debug APIs, automatically generate SDK code examples, and quickly search for APIs. API Explorer can help reduce possible difficulty with using cloud APIs. We recommend that you use API Explorer.
Request parameters
| Parameter | Type | Required? | Example value | Description |
|---|---|---|---|---|
| Action | String | Yes | DeleteVirtualBorderRouter | The action to perform. Valid value: DeleteVirtualBorderRouter |
| RegionId | String | Yes | cn-shanghai | The ID of the region where the VBR is located. You can obtain the region ID by calling the DescribeRegions API. |
| VbrId | String | Yes | vbr-bp12mw1f8k3jgygk9bmlj | The ID of the VBR. |
| ClientToken | String | No | 02fb3da4-130e-11e9-8e44-0016e04115b | A client token used to guarantee the idempotence of requests. This parameter value is generated by the client and must be unique. It cannot exceed 64 ASCII characters. |
Response parameters
| Parameter | Type | Example value | Description |
|---|---|---|---|
| RequestId | String | F8BF7D24-F3EB-4E23-9208-B77C6EB78E75 | The ID of the request. |
Examples
Request example
http(s)://vpc.aliyuncs.com/?Action=DeleteVirtualBorderRouter
&RegionId=cn-shanghai
&VbrId=vbr-bp12mw1f8k3jgygk9bmlj
&<CommonParameters>
-
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 specified VBR does not exist. |
| 400 | InvalidOperation.RouterInterfaceNotDeleted | The specified VirutalBorderRouter still has routerInterface. | The specified VBR has associated router interfaces. |
| 400 | InvalidOperation.OperationNotAllowedInState | The specified VirutalBorderRouter is in invalid state. | The status of the VBR is invalid. |
| 403 | Forbidden.OperationNotAllowedByUser | The caller is not allowed to delete the specified VirtualBorderRouter. | You are not allowed to delete the VBR. |
| 403 | Forbidden.MultiVlanRi | Multiple vlan router interfaces are found. | Multiple VLAN router interfaces exist. |
| 400 | InvalidStatus.NotAllowed | The virtual border has been associated by physicalConnection. | The VBR has associated with a physical connection. |