卸载云服务器磁盘

功能介绍

弹性云服务器卸载磁盘。

接口约束

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

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

1. 仅支持对数据盘盘位（非/dev/sda挂载点）的卸载。
2. 请确认弹性云服务器已安装UVP VMTools并且正常启用，否则会导致卸载失败。
3. 对于Linux弹性云服务器，由于操作系统限制，需要客户先登录弹性云服务器，执行umount命令，取消待卸载磁盘与文件系统之间的关联，并确保没有程序正在对该磁盘进行读写操作。否则，卸载磁盘将失败。
4. 对于Windows弹性云服务器，在线卸载磁盘，请确保没有程序正在对该磁盘进行读写操作。否则，将造成数据丢失。
5. 支持在线卸载云硬盘的操作系统包括如下两个部分：
   • 第一部分请参见《镜像服务用户指南》的“简介 > 概念 > 官方公共镜像支持的操作系统类型”章节。
   • 第二部分如表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

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

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

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

URI

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

请求消息

无

响应消息

无

请求示例

卸载指定云服务器的磁盘，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

响应示例

无

返回值

请参考通用请求返回值。