功能介绍

云服务器挂载磁盘。

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

接口约束

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

调试

您可以在API Explorer中调试该接口。

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"
    }
}

返回值

请参考通用请求返回值。

父主题： 磁盘管理

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家