1. 删除云服务器

本接口用于主动删除云服务器。

不再使用的云服务器，可通过本接口主动删除。已删除的云服务器无法找回，数据云盘内的数据也会一并删除。
本接口暂未支持批量操作。
本接口支持删除开机状态的云服务器资源。云服务器在删除后会停止计费。

1.1. 通用接口

本接口所属服务类型为 ecs

本接口操作类型为 DeleteInstances

1.1.1. 请求路径

POST {baseUrl}/v3/ecs/DeleteInstances

1.1.2. 请求体

{
  "zoneCode": "cn-zhongwei-a",
  "ecsUuids": ["1d393df7-5ef0-4123-bf44-d2f953efae5e"],
  "deleteEip": false,
  "deleteEbs": false
}

⚠️

注意：

如果您传入的deleteEip为true，则会删除与云服务器计费类型相同的公网IP资源；如果deleteEip为false，则会在删除云服务器前卸载全部公网IP资源。

如果您传入的deleteEbs为true，则会删除与云服务器计费类型相同的数据云盘；如果deleteEbs为false，则会在删除云服务器前卸载全部数据云盘。

系统盘会随云服务器一起删除。

请求体内容说明

属性名	属性类型	是否必须	默认值	说明
zoneCode	String	是	无	可用区编码
ecsUuids	Array	是	无	待删除云服务器 UUID 列表
deleteEip	Boolean	否	false	是否删除绑定的弹性公网 IP
deleteEbs	Boolean	否	false	是否删除挂载的数据云盘

1.1.3. 返回内容

{
  "code": 200,
  "message": "删除成功",
  "data": [
    {
      "jobUuid": "6a75ee53fba1435ead5a37ed7931a035",
      "success": false,
      "progress": 0.0,
      "type": "DeleteECS",
      "done": false,
      "resourceUuid": "1d393df7-5ef0-4123-bf44-d2f953efae5e"
    }
  ]
}

返回内容说明

属性名	属性类型	说明
code	Integer	返回码。正常返回 200，异常返回500或其他业务错误码
message	String	返回信息
data	Array	异步任务进度信息

异步任务进度信息

属性名	属性类型	说明
jobUuid	String	异步任务唯一编码
success	Boolean	异步任务是否执行成功
progress	Double	异步任务执行进度。0-100%
type	String	异步任务类型
done	Boolean	异步任务是否执行完成
resourceUuid	String	异步任务所处理的资源 Uuid

异步任务执行状态详见异步任务。

1.2. 应用场景举例

1.2.1. 删除按需云服务器，并删除云盘和公网 IP

{
    "zoneCode": "cn-zhongwei",
    "ecsUuids": ["fff607c8-e991-4693-959c-1960db8df28a"],
    "deleteEip": true,
    "deleteEbs": true
}

重启云服务器续费云服务器