Deletes a reserved CIDR block of a vSwitch.
Operation description
-
Before you call this operation, make sure all prefix delegations assigned from the reserved CIDR block to ENIs are deleted. Call UnassignPrivateIpAddresses or UnassignIpv6Addresses to release ENI IPv4 or IPv6 addresses first.
- DeleteVSwitchCidrReservation is an asynchronous operation. The system returns an instance ID, but the reserved CIDR block is not yet deleted and a background task is still running. Call ListVSwitchCidrReservations to check the deletion status:
-
Releasing: the reserved CIDR block is being deleted.
-
Released: the reserved CIDR block is deleted.
-
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| VSwitchCidrReservationId |
string |
Yes |
The ID of the reserved CIDR block. |
vcr-bp1m12saqteraw3rp**** |
| RegionId |
string |
Yes |
The region ID of the vSwitch. Call DescribeRegions to query available regions. |
cn-hangzhou |
| DryRun |
boolean |
No |
Specifies whether to perform a dry run. Valid values: true: performs a dry run. The system validates the request without performing the operation. If validation fails, an error message is returned. If validation succeeds, the false (default): sends the request. A 2xx HTTP status code is returned if the request succeeds. |
false |
| ClientToken |
string |
No |
The client token used to ensure idempotency. Generate a unique ASCII token for each request. Note
If not specified, the system uses the request ID as the client token. The request ID may differ for each request. |
123e4567-e89b-12d3-a456-426655440000 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response body. |
||
| RequestId |
string |
The request ID. |
54B48E3D-DF70-471B-AA93-08E683A1B45 |
Examples
Success response
JSON format
{
"RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | DependencyViolation.IpPrefix | DependencyViolation.IpPrefix | The error message returned because a prefix list is assigned to the resource. Delete the prefix list and try again. |
| 400 | IncorrectStatus.CidrReservation | The status of the CIDR reservation is incorrect. | The status of the reserved CIDR block does not support this operation. Try again later. |
| 400 | ResourceNotFound.CidrReservation | reserve segment not exist. | The network segment does not exist. |
| 404 | ResourceNotFound.CidrReservation | ResourceNotFound.CidrReservation |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.