更新时间:2023-07-17 GMT+08:00

挂载弹性云服务器磁盘

功能介绍

云服务器挂载磁盘。

弹性云服务器挂载磁盘应用示例请参考弹性云服务器挂载磁盘

接口约束

  1. 挂载bootable卷必须指定挂载盘符。
  2. 由备份创建的磁盘不能挂载为系统盘。
  3. 弹性云服务器状态(弹性云服务器的OS-EXT-STS:vm_state属性)处于SUSPENDED和PAUSED状态下不支持挂卷。
  4. 待挂载的云硬盘必须是available状态。
  5. 待挂载的云硬盘与云服务器属于同一可用区。
  6. VBD类型的云硬盘不支持挂载到裸金属服务器上。

URI

POST /v2.1/{project_id}/servers/{server_id}/os-volume_attachments

参数说明请参见表1
表1 参数说明

参数

是否必选

描述

project_id

项目ID。

获取方法请参见获取项目ID

server_id

云服务器ID。

请求消息

请求参数如表2所示。
表2 请求参数

参数

是否必选

参数类型

描述

volumeAttachment

Object

要挂载的卷相关信息,详情请参见表3

表3 volumeAttachment数据结构说明

参数

是否必选

参数类型

描述

volumeId

String

待挂载磁盘的磁盘ID,UUID格式。

device

String

磁盘挂载点,如/dev/sda,/dev/sdb。

新增加的磁盘挂载点不能和已有的磁盘挂载点相同。

需要根据已有设备名称顺序指定,否则由系统自动生成。

说明:

VBD磁盘挂载点只支持从/dev/vdb到/dev/vdx,建议按英文字母顺序进行挂载,否则可能出现云服务器中磁盘盘符错乱的情况。

响应消息

响应参数如表 响应参数所示。
表4 响应参数

参数

参数类型

描述

volumeAttachment

object

云服务器挂载信息,详情请参见表5

表5 volumeAttachment字段数据结构说明

参数

参数类型

描述

device

String

设备名称。

serverId

String

挂载的云服务器ID,UUID格式。

id

String

卷的ID,UUID格式。

volumeId

String

挂载ID,目前实现与卷UUID相同。

请求示例

挂载ID为“54667652-3029-4af8-9222-2d53066fd61c”的磁盘到指定云服务器,挂载点为“/dev/sdb”。

POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-volume_attachments

{
    "volumeAttachment": {
        "volumeId": "54667652-3029-4af8-9222-2d53066fd61c",
        "device": "/dev/sdb"
    }
}

响应示例

{
    "volumeAttachment": {
        "device": "/dev/vdb",
        "serverId": "ab258e25-e351-47c7-b6e3-0749c5d9ed6a",
        "id": "54667652-3029-4af8-9222-2d53066fd61c",
        "volumeId": "54667652-3029-4af8-9222-2d53066fd61c"
    }
}

返回值

请参考通用请求返回值