All Products
Search
Document Center

Virtual Private Cloud:DeleteVSwitchCidrReservation

Last Updated:Aug 27, 2026

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

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

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 DryRunOperation error code is returned.

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.