搜本产品 
detachDisk
描述
为一台云主机缷载云硬盘
详细操作说明请参考帮助文档：缷载云硬盘
接口说明
- 云主机和云硬盘都没有正在进行中的的任务时才可以操作。
- 云主机状态必须是
running或stopped状态。操作系统盘时必须先停止实例。
请求方式
POST
请求地址
https://vm.jdcloud-api.com/v1/regions/{regionId}/instances/{instanceId}:detachDisk
| 名称 | 类型 | 是否必需 | 示例值 | 描述 |
|---|---|---|---|---|
| regionId | String | 是 | cn-north-1 | 地域ID。 |
| instanceId | String | 是 | i-eumm****d6 | 云主机ID。 |
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| diskId | String | 是 | vol-u8r2****c1 | 云硬盘ID。 |
| force | Boolean | 否 | 是否强制缷载，默认False。 如果此参数传值为True，数据盘的IO会被强制断掉。 |
返回参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| requestId | String | c2hmmaan8w06w19qcdfuic4w03f7ft2d | 请求ID。 |
请求示例
POST
/v1/regions/cn-north-1/instances/i-eumm****d6:detachDisk
{
"diskId" : "vol-u8r2****c1"
}
返回示例
{
"requestId": "a0633f72670e59f8c6db36b1ee257011"
}
返回码
| HTTP状态码 | 错误码 | 描述 | 错误解析 |
|---|---|---|---|
| 200 | OK | ||
| 400 | FAILED_PRECONDITION | Conflict with underlay task xx | 云主机实例正在执行其它任务，请稍后再试。 |
| 400 | FAILED_PRECONDITION | Invalid instance status xx | 错误的云主机状态。 |
| 400 | FAILED_PRECONDITION | Please stop the instance first | 需要先停止实例。 |
| 400 | FAILED_PRECONDITION | Disk busy in 'xx' | 云硬盘正在执行其它任务，请稍后再试。 |
| 400 | FAILED_PRECONDITION | Invalid disk status 'xx' | 云硬盘状态错误。 |
| 404 | NOT_FOUND | Instance 'xx' not found. | 云主机实例不存在。 |
| 404 | NOT_FOUND | Disk 'xx' not found. | 云硬盘不存在。 |
| 500 | INTERNAL | Internal server error | 系统内部错误，请稍后重试。如果多次尝试失败，请提交工单。 |
| 500 | UNKNOWN | Unknown server error | 服务暂时不可用，请稍后重试。如果多次尝试失败，请提交工单。 |
更新时间：2021-09-01 20:20:29
文档反馈
