卸载云服务器磁盘NovaDetachVolume
.jpg)
.jpg)
.jpg)
.jpg)
接口说明
弹性 云服务器 卸载磁盘。
约束说明
弹性云服务器状态为stopped时支持系统盘(也就是/dev/sda挂载点)和用户盘的卸载,没有操作系统限制,也不需要在弹性云服务器内部安装vmtools。
弹性云服务器状态为active态时有如下约束限制:
-
仅支持对数据盘盘位(非/dev/sda挂载点)的卸载。
-
请确认弹性云服务器已安装vmtools并且正常启用,否则会导致卸载失败。
-
对于Linux弹性云服务器,由于操作系统限制,需要客户先登录弹性云服务器,执行umount命令,取消待卸载磁盘与文件系统之间的关联,并确保没有程序正在对该磁盘进行读写操作。否则,卸载磁盘将失败。
-
对于Windows弹性云服务器,在线卸载磁盘,请确保没有程序正在对该磁盘进行读写操作。否则,将造成数据丢失。
-
支持在线卸载 云硬盘 的操作系统包括如下两个部分:
-
在线强制卸载磁盘功能当前仅支持KVM弹性云服务器的VBD磁盘使用。
对于XEN虚拟化类型的弹性云服务器、 裸金属服务器 、以及KVM弹性云服务器的其他磁盘类型,调用该接口时,仅支持在线卸载功能。
-
第一部分请参见外部 镜像 文件的镜像格式和操作系统类型。
-
第二部分如表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 2008 R2 Enterprise 64bit |
| Windows(不支持在线卸载SCSI类型的云硬盘) | Windows Server 2016 R2 Standard 64bit |
| Redhat Linux Enterprise | 7.3 64bit |
| Redhat Linux Enterprise | 6.8 64bit |
- 在线强制卸载的磁盘会占用盘符和pci地址,因此,该盘符和pci地址不能被再次分配。
- 磁盘强制卸载后,仍会占用该弹性云服务器磁盘的配额。
- 系统盘不支持在线强制卸载功能。
- 磁盘在挂载有文件系统的情况下被强制卸载,需要用户手动卸载所挂载的文件系统目录。
- 被强制卸载的磁盘如果创建了逻辑分区,该逻辑分区将不可用。
- 磁盘强制卸载后,弹性云服务器内部会有残留,建议重启。
URL
DELETE https://ecs.cn-north-1.myhuaweicloud.com/v2.1/{project_id}/servers/{server_id}/os-volume_attachments/{volume_id}
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
|
project_id
|
string | path | 是 |
项目ID。 |
|
server_id
|
string | path | 是 |
云服务器ID。 |
|
volume_id
|
string | path | 是 |
磁盘ID。 |
|
delete_flag
|
integer | query | 否 |
在线强制卸载磁盘标志位。 默认为0,为1时代表强制卸载。 |
返回参数
返回码: 202
Accepted
请求示例
示例 1
"DELETE https://{endpoint}/v2.1/6fbe9263116a4b68818cf1edce16bc4f/servers/ab258e25-e351-47c7-b6e3-0749c5d9ed6a/os-volume_attachments/54667652-3029-4af8-9222-2d53066fd61c"
错误码
请参考 错误码说明。
