文档中心

云服务器

云盘

DetachVolume - 卸载云盘

DetachVolume - 卸载云盘

调用DetachVolume接口将云盘从ECS实例上卸载。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：DetachVolume

要执行的操作，取值：DetachVolume。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

VolumeId string 必选示例值：vol-3tir92lne23vj0x1****

待卸载的云盘ID。

InstanceId string 必选示例值：i-3tiefmkskq3vj0x0****

挂载云盘的ECS实例ID。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingInstanceID	Missing instance ID.	缺少实例ID。
400	MissingVolumeID	The specified parameter VolumeId is missing.	缺少云盘ID。
400	ErrorInstanceNotMatched	The attached volume does not match the instance parameters.	卷挂载的云主机和云主机参数不匹配。
400	ErrorMissingVolumeID	Missing volume ID.	缺少云盘ID。
400	ErrorMissingInstanceID	Missing instance ID.	缺少实例ID。
400	ErrorSystemVolumeCannotDetach	System volume cannot be directly detached.	系统盘不允许直接卸载。
404	VolumeNotFound	The specified volume does not exist.	云盘不存在。
404	ErrorInvalidInstanceStatus	Instance status exception.	云主机状态异常。
412	SystemVolumeCannotDetach	System volume cannot be directly detached.	系统盘不允许直接卸载。
412	ErrorPrepaidVolumeCannotDetach	Postpaid volumes cannot be detached.	包年包月云盘不允许卸载。
412	ErrorVolumeStatusInMigration	Volume is undergoing data migration.	云盘正在数据迁移中。
412	ErrorVolumeStatusInChanging	Volume type is being changed.	云盘正在变配中。
412	VolumeStatusCannotDetach	Volumes in this state cannot be detached.	该状态的云盘不允许卸载。
412	VolumeCannotDetach	Detach is not supported for this type of volume.	该类型的云盘不支持卸载。
412	AlreadyExitOrder	Order in progress, cannot perform operation.	订单进行中，无法进行操作。

最近更新时间：2026.01.07 17:09:44

这个页面对您有帮助吗？

有用

有用

无用

无用