All Products
Search
Document Center

Dedicated Host:ReleaseDedicatedHost

Last Updated:Apr 11, 2024

Releases a pay-as-you-go dedicated host.

Operation description

Usage notes

Before you release a pay-as-you-go dedicated host, make sure that no ECS instances are deployed on the dedicated host.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The region ID of the dedicated host. You can call the DescribeRegions operation to query the most recent region list.

cn-hangzhou
DedicatedHostIdstringYes

The ID of the dedicated host.

dh-bp199lyny9b3****

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The request ID.

A1B15AC8-E6F6-49A4-8985-8C07104B9199

Examples

Sample success responses

JSONformat

{
  "RequestId": "A1B15AC8-E6F6-49A4-8985-8C07104B9199"
}

Error codes

HTTP status codeError codeError messageDescription
400ChargeTypeViolationThe operation is not permitted due to charge type of the dedicated host.-
400IncorrectHostStatus.InitializingThe specified dedicatedHost status is not support this operation-
403InstanceExistInstance exists on the dedicated host.Instances are present on the dedicated host. You must remove the instances before you can release the dedicated host.
404InvalidDedicatedHostId.NotFoundThe specified DedicatedHostId does not exist.-
500InternalErrorThe request processing has failed due to some unknown error.An internal error has occurred. Try again later.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-08-01The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 400 change
    Error Codes 403 change
    delete Error Codes: 404
    delete Error Codes: 500