更新时间：2025-10-31 GMT+08:00
裸金属服务器挂载云硬盘 - AttachBaremetalServerVolume
功能介绍
裸金属服务器创建成功后，如果发现磁盘不够用或者当前磁盘不满足要求，可以将已有云硬盘挂载给裸金属服务器，作为数据盘使用。
约束
- 不支持批量挂载。
- 单个裸金属服务器最多挂载60块云硬盘。
- 不支持挂载bootable的卷。
- 裸金属服务器状态（OS-EXT-STS:vm_state属性）处于PAUSED状态下不支持挂卷。
- 要挂载的卷必须是available状态的卷或者共享卷。
- 仅支持挂载SCSI类型的卷。
URI
POST /v1/{project_id}/baremetalservers/{server_id}/attachvolume
参数说明请参见表1。
|
参数 |
是否必选 |
描述 |
|---|---|---|
|
project_id |
是 |
项目ID。 获取方式请参见获取项目ID。 |
|
server_id |
是 |
裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
volumeAttachment |
是 |
Object |
要挂载的卷相关信息，详情请参见表2。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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": "" } } |
响应参数
|
名称 |
参数类型 |
说明 |
|---|---|---|
|
job_id |
String |
提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。 如何根据job_id来查询Job的执行状态，请参考查询Job状态 - ShowJobInfos。 |
|
名称 |
参数类型 |
说明 |
|---|---|---|
|
error |
字典数据结构 |
提交任务异常时返回的异常信息，详情请参见表5。 |
响应示例
- 正常响应
1 2 3
{ "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" }
错误码
请参考错误码。
父主题： 裸金属服务器云硬盘管理
