更新时间:2024-04-16 GMT+08:00

卸载云服务器磁盘

功能介绍

弹性云服务器卸载磁盘。

接口约束

弹性云服务器状态为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}

参数说明请参见表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

响应示例

返回值

请参考通用请求返回值