# 卸载云服务器磁盘（废弃） - NovaDetachVolume #### 功能介绍 弹性云服务器卸载磁盘。 当前API已废弃，请使用[弹性云服务器卸载磁盘 - DetachServerVolume](https://support.huaweicloud.com/api-ecs/ecs_02_0606.html)。 #### 接口约束 弹性云服务器状态为stopped时支持系统盘（也就是/dev/sda挂载点）和用户盘的卸载，没有操作系统限制，也不需要在弹性云服务器内部安装UVP VMTools。 弹性云服务器状态为active态时有如下约束限制： 1. 仅支持对数据盘盘位（非/dev/sda挂载点）的卸载。 2. 请确认弹性云服务器已安装UVP VMTools并且正常启用，否则会导致卸载失败。 3. 对于Linux弹性云服务器，由于操作系统限制，需要客户先登录弹性云服务器，执行**umount**命令，取消待卸载磁盘与文件系统之间的关联，并确保没有程序正在对该磁盘进行读写操作。否则，卸载磁盘将失败。 4. 对于Windows弹性云服务器，在线卸载磁盘，请确保没有程序正在对该磁盘进行读写操作。否则，将造成数据丢失。 5. 支持在线卸载云硬盘的操作系统包括如下两个部分： - 第一部分请参见[外部镜像文件的镜像格式和操作系统类型](https://support.huaweicloud.com/productdesc-ims/zh-cn_topic_0030713143.html)。 - 第二部分如[表1]所示。 表1支持在线卸载云硬盘的操作系统 | 操作系统 | 版本 | |:---|:---| | CentOS | 7.3 64bit | | CentOS | 7.2 64bit | | CentOS | 6.8 64bit | | CentOS | 6.7 64bit | | Debian | 8.6.0 64bit | | Debian | 8.5.0 64bit | | Fedora | 25 64bit | | Fedora | 24 64bit | | SUSE | SUSE Linux Enterprise Server 12 SP2 64bit | | SUSE | SUSE Linux Enterprise Server 12 SP1 64bit | | SUSE | SUSE Linux Enterprise Server 11 SP4 64bit | | SUSE | SUSE Linux Enterprise Server 12 64bit | | OpenSUSE | 42.2 64bit | | OpenSUSE | 42.1 64bit | | Oracle Linux Server release | 7.3 64bit | | Oracle Linux Server release | 7.2 64bit | | Oracle Linux Server release | 6.8 64bit | | Oracle Linux Server release | 6.7 64bit | | Ubuntu Server | 16.04 64bit | | Ubuntu Server | 14.04 64bit | | Ubuntu Server | 14.04.4 64bit | | Windows（不支持在线卸载SCSI类型的云硬盘） | Windows Server 2008 R2 Enterprise 64bit | | Windows（不支持在线卸载SCSI类型的云硬盘） | Windows Server 2012 R2 Standard 64bit | | Windows（不支持在线卸载SCSI类型的云硬盘） | Windows Server 2016 R2 Standard 64bit | | Redhat Linux Enterprise | 7.3 64bit | | Redhat Linux Enterprise | 6.8 64bit | 6. 在线强制卸载磁盘功能当前仅支持KVM弹性云服务器的VBD磁盘使用。 对于XEN虚拟化类型的弹性云服务器、裸金属服务器、以及KVM弹性云服务器的其他磁盘类型，调用该接口时，仅支持在线卸载功能。 7. 在线强制卸载的磁盘会占用盘符和pci地址，因此，该盘符和pci地址不能被再次分配。 8. 磁盘强制卸载后，仍会占用该弹性云服务器磁盘的配额。 9. 系统盘不支持在线强制卸载功能。 10. 磁盘在挂载有文件系统的情况下被强制卸载，需要用户手动卸载所挂载的文件系统目录。 11. 被强制卸载的磁盘如果创建了逻辑分区，该逻辑分区将不可用。 12. 磁盘强制卸载后，弹性云服务器内部会有残留，建议重启。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ECS&api=NovaDetachVolume)中调试该接口。 #### URI DELETE /v2.1/{project_id}/servers/{server_id}/os-volume_attachments/{volume_id} 参数说明请参见[表2]。 表2参数说明 | 参数 | 是否必选 | 描述 | |:---|:---|:---| | project_id | 是 | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 | | 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 ``` #### 响应示例 无 #### 返回值 请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。