文档首页/云化数据中心 CloudDC/API参考/API/裸机实例管理/删除实例 - DeleteInstance
更新时间：2025-12-04 GMT+08:00
在线调试
CLI示例
查看PDF
分享

删除实例 - DeleteInstance

功能介绍

删除实例，此接口为异步接口，可通过 ShowInstanceStatus 查询实例状态，实例状态从 shutting-down 变为 terminated，表明删除实例成功。

调用方法

请参见如何调用API。

授权信息

当前API调用无需身份策略权限。

URI

DELETE /v1/{project_id}/instances/{id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID

约束限制：

不涉及

取值范围：

账号的项目ID

默认取值：

不涉及

id

是

String

参数解释：

实例ID, 创建实例CreateInstance请求响应返回的值

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

调用接口的认证方式分为Token，如果您使用的Token方式，此参数为必填，请填写Token的值

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

响应参数

状态码：204

表3 响应Body参数

参数

参数类型

描述

-

String

-

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码

error_msg

String

参数解释：

错误描述

状态码：401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码

error_msg

String

参数解释：

错误描述

状态码：429

表6 响应Body参数

参数

参数类型

描述

-

String

-

状态码：500

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码

error_msg

String

参数解释：

错误描述

请求示例

删除实例

DELETE https://{endpoint}/v1/{project_id}/instances/{id}

响应示例

无

状态码

状态码

描述

204

服务器已成功处理了请求

400

请求参数错误，请求失败

401

请求未鉴权

429

请求过载

500

服务端内部错误

错误码

请参见错误码。

父主题：裸机实例管理

相关文档