文档首页 > > API参考> API(推荐)> 生命周期管理> 删除云服务器

删除云服务器

分享
更新时间: 2019/11/20 GMT+08:00

功能介绍

根据指定的云服务器ID列表,删除云服务器。

系统支持删除单台云服务器和批量删除多台云服务器操作,批量删除云服务器时,一次最多可以删除1000台。

URI

POST /v1/{project_id}/cloudservers/delete

参数说明请参见 表1
表1 参数说明

参数

是否必选

描述

project_id

项目ID。

获取方法请参见获取项目ID

请求消息

请求参数如 表2所示。
表2 请求参数

参数

是否必选

参数类型

描述

servers

列表数据结构

所需要删除的云服务器列表,详情请参见表3

delete_publicip

Boolean

配置删除云服务器是否删除云服务器绑定的弹性IP。如果选择不删除,则系统仅做解绑定操作,保留弹性IP资源。

取值为true或false,默认为false。

  • true:删除云服务器时会同时删除绑定在云服务器上的弹性IP。
  • false:删除云服务器时,仅解绑定在云服务器上的弹性IP,不删除弹性IP。

delete_volume

Boolean

配置删除云服务器是否删除云服务器对应的数据盘,如果选择不删除,则系统仅做卸载操作,保留云磁盘资源。

取值为false或true,默认为false。

  • true:删除云服务器时会同时删除挂载在云服务器上的数据盘。
  • false:删除云服务器时,仅卸载云服务器上挂载的数据盘,不删除该数据盘。
表3 servers字段数据结构说明

参数

是否必选

参数类型

描述

id

String

需要删除的云服务器ID。

响应消息

请参考响应(任务类)

请求示例

请求示例
POST https://{endpoint}/v1/{project_id}/cloudservers/delete
{
    "servers": [
        {
            "id": "616fb98f-46ca-475e-917e-2563e5a8cd19"
        }
    ], 
    "delete_publicip": false, 
    "delete_volume": false,
    "reserve_elasticnic" : "false"
}

响应示例

{
    "job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}

{
    "error": {
        "message": "request body is illeagal.", 
        "code": "Ecs.0005"
    }
}

返回值

请参考通用请求返回值

错误码

请参考错误码说明

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区