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
Test
RAM authorization
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 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.