更新时间:2024-10-22 GMT+08:00

裸金属服务器挂载云硬盘

功能介绍

裸金属服务器创建成功后,如果发现磁盘不够用或者当前磁盘不满足要求,可以将已有云硬盘挂载给裸金属服务器,作为数据盘使用。

约束

  • 不支持批量挂载。
  • 单个裸金属服务器最多挂载60块云硬盘。
  • 不支持挂载bootable的卷。
  • 裸金属服务器状态(OS-EXT-STS:vm_state属性)处于PAUSED状态下不支持挂卷。
  • 要挂载的卷必须是available状态的卷或者共享卷。
  • 仅支持挂载SCSI类型的卷。

URI

POST /v1/{project_id}/baremetalservers/{server_id}/attachvolume

参数说明请参见表1

表1 参数说明

参数

是否必选

描述

project_id

项目ID。

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

server_id

裸金属服务器ID。

可以从裸金属服务器控制台查询,或者通过调用查询裸金属服务器列表(废弃)获取。

请求参数

参数

是否必选

参数类型

描述

volumeAttachment

Object

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

表2 volumeAttachment数据结构说明

参数

是否必选

参数类型

描述

volumeId

String

要挂卷的卷ID。

可以从云硬盘控制台查询,或者通过调用“查询云硬盘列表”API获取。

device

String

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

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

需要根据已有设备名称顺序指定,否则不写device或device的值为""时,由系统自动生成。

请求示例

挂载ID为b53f23bd-ee8f-49ec-9420-d1acfeaf91d6的云硬盘到ID为cf2a8b97-b5c6-47ef-9714-eb27adf26e5b的裸金属服务器。
1
POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/attachvolume
1
2
3
4
5
6
{
    "volumeAttachment": {
        "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6",
        "device": ""
    }
}

响应参数

表3 正常响应要素说明

名称

参数类型

说明

job_id

String

提交任务成功后返回的任务ID,用户可以使用该ID对任务执行情况进行查询。

如何根据job_id来查询Job的执行状态,请参考查询Job状态

表4 异常响应要素说明

名称

参数类型

说明

error

字典数据结构

提交任务异常时返回的异常信息,详情请参见表5

表5 error数据结构

名称

参数类型

说明

message

String

任务异常错误信息描述。

code

String

任务异常错误信息编码。

响应示例

  • 正常响应
    1
    2
    3
    { 
        "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" 
    } 
    

返回值

正常返回值:

返回值

说明

202

服务器已接受请求,延迟处理。

其他返回值请参考状态码

错误码

请参考错误码