文档首页/ 专属主机 DeH/ API参考/ API/ 释放专属主机 - DeleteDedicatedHost
更新时间:2025-11-14 GMT+08:00

释放专属主机 - DeleteDedicatedHost

功能介绍

释放专属主机。

约束限制

若专属主机上存在云服务器,则不允许释放。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项

URI

DELETE /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}

参数说明请参见表1

表1 参数说明

参数

参数类型

是否必选

描述

project_id

String

项目ID。

dedicated_host_id

String

专属主机ID。

可以从专属主机控制台查询,或者通过调用查询专属主机列表 - ListDedicatedHostsAPI获取。

请求消息

响应消息

请求示例

释放ID为74259164-e63a-4ad9-9c77-a1bd2c9aa187的专属主机。

DELETE https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts/74259164-e63a-4ad9-9c77-a1bd2c9aa187

响应示例

Http Response Code: 204

返回值

表2 返回值-错误码说明

错误码

说明

409 Conflict

若专属主机上存在云服务器,则不允许释放。

更多返回值,请参见状态码