功能介绍

弹性云服务器卸载磁盘。

接口约束

弹性云服务器状态为stopped时支持系统盘（也就是/dev/sda挂载点）和用户盘的卸载，没有操作系统限制，也不需要在弹性云服务器内部安装UVP VMTools。

弹性云服务器状态为active态时有如下约束限制：

仅支持对数据盘盘位（非/dev/sda挂载点）的卸载。
请确认弹性云服务器已安装UVP VMTools并且正常启用，否则会导致卸载失败。
对于Linux弹性云服务器，由于操作系统限制，需要客户先登录弹性云服务器，执行umount命令，取消待卸载磁盘与文件系统之间的关联，并确保没有程序正在对该磁盘进行读写操作。否则，卸载磁盘将失败。
对于Windows弹性云服务器，在线卸载磁盘，请确保没有程序正在对该磁盘进行读写操作。否则，将造成数据丢失。
支持在线卸载云硬盘的操作系统包括如下两个部分：

第一部分请参见外部镜像文件的镜像格式和操作系统类型。
第二部分如表1所示。

表1 支持在线卸载云硬盘的操作系统

操作系统	版本
CentOS	7.3 64bit
7.2 64bit
6.8 64bit
6.7 64bit
Debian	8.6.0 64bit
8.5.0 64bit
Fedora	25 64bit
24 64bit
SUSE	SUSE Linux Enterprise Server 12 SP2 64bit
SUSE Linux Enterprise Server 12 SP1 64bit
SUSE Linux Enterprise Server 11 SP4 64bit
SUSE Linux Enterprise Server 12 64bit
OpenSUSE	42.2 64bit
42.1 64bit
Oracle Linux Server release	7.3 64bit
7.2 64bit
6.8 64bit
6.7 64bit
Ubuntu Server	16.04 64bit
14.04 64bit
14.04.4 64bit
Windows（不支持在线卸载SCSI类型的云硬盘）	Windows Server 2008 R2 Enterprise 64bit
Windows Server 2012 R2 Standard 64bit
Windows Server 2016 R2 Standard 64bit
Redhat Linux Enterprise	7.3 64bit
6.8 64bit

在线强制卸载磁盘功能当前仅支持KVM弹性云服务器的VBD磁盘使用。

对于XEN虚拟化类型的弹性云服务器、裸金属服务器、以及KVM弹性云服务器的其他磁盘类型，调用该接口时，仅支持在线卸载功能。

在线强制卸载的磁盘会占用盘符和pci地址，因此，该盘符和pci地址不能被再次分配。
磁盘强制卸载后，仍会占用该弹性云服务器磁盘的配额。
系统盘不支持在线强制卸载功能。
磁盘在挂载有文件系统的情况下被强制卸载，需要用户手动卸载所挂载的文件系统目录。
被强制卸载的磁盘如果创建了逻辑分区，该逻辑分区将不可用。
磁盘强制卸载后，弹性云服务器内部会有残留，建议重启。

调试

您可以在API Explorer中调试该接口。

URI

DELETE /v2.1/{project_id}/servers/{server_id}/os-volume_attachments/{volume_id}{?delete_flag}

参数说明请参见表2。

表2 参数说明

参数	是否必选	描述
project_id	是	项目ID。 获取方法请参见获取项目ID。
server_id	是	云服务器ID。
volume_id	是	磁盘ID。

使用方式：DELETE /v2.1/{project_id}/servers/{server_id}/os-volume_attachments/{volume_id}?delete_flag=1

查询参数如表3所示。

表3 查询参数

参数	是否必选	类型	描述
delete_flag	否	Integer	在线强制卸载磁盘标志位。 默认为0，为1时代表强制卸载。

请求消息

无

响应消息

无

请求示例

卸载指定云服务器的磁盘，ID为“54667652-3029-4af8-9222-2d53066fd61c”。

DELETE https://{endpoint}/v2.1/6fbe9263116a4b68818cf1edce16bc4f/servers/ab258e25-e351-47c7-b6e3-0749c5d9ed6a/os-volume_attachments/54667652-3029-4af8-9222-2d53066fd61c

响应示例

无

返回值

请参考通用请求返回值。

父主题： 磁盘管理

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家