云主机

产品文档

云主机

deleteInstance

描述

删除一台云主机实例。

详细操作说明请参考帮助文档:删除实例

接口说明

  • 不可以删除包年包月未到期的实例。
  • 不可以删除没有计费信息的实例,如实例无计费信息,说明在实例创建过程中出现了异常,请联系客服处理。
  • 实例状态必须为 running(运行)、 stopped(停止)、 error(错误)状态,同时实例没有正在进行中的任务才可以删除。
  • 如果云主机中挂载的数据盘为按配置计费的云硬盘且 AutoDelete 属性为 true,那么数据盘会随实例一起删除。
  • 实例中绑定的弹性公网IP不会随实例一起删除,如果不需要保留,需要单独进行删除。
  • 如出现不能删除的情况请 提交工单 或联系京东云客服。


敏感操作,可开启MFA操作保护

请求方式

DELETE

请求地址

https://vm.jdcloud-api.com/v1/regions/{regionId}/instances/{instanceId}

名称 类型 是否必需 示例值 描述
regionId String cn-north-1 地域ID。
instanceId String i-eumm****d6 云主机ID。

请求参数

返回参数

名称 类型 示例值 描述
requestId String c2hmmaan8w06w19qcdfuic4w03f7ft2d 请求ID。

请求示例

DELETE

/v1/regions/cn-north-1/instances/i-eumm****d6

返回示例

{
    "requestId": "a0633f72670e59f8c6db36b1ee257011"
}

返回码

HTTP状态码 错误码 描述 错误解析
200 OK
400 FAILED_PRECONDITION Invalid instance status 'xx' 错误的实例状态。
400 FAILED_PRECONDITION Conflict with underlay image task 'xx' 实例正在制作镜像,请稍后再试。
400 FAILED_PRECONDITION Can't delete 'prepaid_by_duration' instance which isn't overdue 不能删除包年包月未到期的实例。
403 PERMISSION_DENIED Can't delete no charged resource 不能删除没有计费信息的实例。
403 PERMISSION_DENIED Can't delete 'prepaid_by_duration' instance in white list 不能删除白名单用户的包年包月。
404 NOT_FOUND Instance 'xx' not found. 实例不存在。
500 INTERNAL Internal server error 系统内部错误,请稍后重试。如果多次尝试失败,请提交工单。
500 UNKNOWN Unknown server error 服务暂时不可用,请稍后重试。如果多次尝试失败,请提交工单。
更新时间:2021-09-01 20:20:29
文档反馈 docs feedback