All Products
Search
Document Center

Virtual Private Cloud:DeleteDhcpOptionsSet

Last Updated:Aug 28, 2026

Deletes a DHCP options set.

Operation description

Description

  • DeleteDhcpOptionsSet is an asynchronous operation. The system returns a request ID and runs the task in the background. Call the GetDhcpOptionsSet operation to check the deletion status:

    • If the DHCP options set is in the Deleting state, the deletion is in progress.

    • If the DHCP options set is no longer returned, the deletion is complete.

  • Do not call DeleteDhcpOptionsSet repeatedly within the specified period of time.

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 DHCP options set. Call the DescribeRegions operation to query available regions.

cn-hangzhou

DhcpOptionsSetId

string

Yes

The ID of the DHCP options set.

dopt-o6w0df4epg9zo8isy****

ClientToken

string

No

The client token used to ensure idempotency of the request.

You can use the client to generate the token. The token must be unique across requests and can contain only ASCII characters.

Note

If you do not specify this parameter, the system uses the request ID as the client token. The request ID may differ for each request.

0c593ea1-3bea-11e9-b96b-88e9fe637760

DryRun

boolean

No

Specifies whether to perform a dry run without performing the actual request. Valid values:

true: performs a dry run. The system checks for missing parameter values, incorrect request syntax, and service limits. If the request fails the dry run, an error message is returned. If the request passes the dry run, the DryRunOperation error code is returned.

false (default): performs a dry run and performs the actual request. If the request passes the dry run, a 2xx HTTP status code is returned and the operation is performed.

false

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 IncorrectStatus.DhcpOptionsSet The DhcpOptionsSet status does not support this operation. The DHCP options set associated with the VPC is being configured and does not support this operation. Retry after the status stabilizes.
400 OperationUnsupported.DhcpOptionsSet The DHCP options set feature in this region is not supported. The current region does not support the DHCP options sets feature.
400 DependencyViolation.VpcAttachment DhcpOptionsSet cannot be deleted when it is attached to VPC. The DHCP options set is associated with a VPC and cannot be deleted.
400 InvalidDhcpOptionsSetId.NotFound The specified dhcpOptionsSetId does not exist. The DHCP options set does not exist. Verify the DhcpOptionsSetId value.
400 MissingParam.DhcpOptionsSetId Missing parameter DhcpOptionsSetId. Missing parameter DhcpOptionsSetId
400 InvalidRegionId.NotFound The specified RegionId does not exist. The specified region does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.