约束
- 不支持批量挂载。
- 单个裸金属服务器最多挂载60块云硬盘。
- 不支持挂载bootable的卷。
- 裸金属服务器状态(OS-EXT-STS:vm_state属性)处于PAUSED状态下不支持挂卷。
- 要挂载的卷必须是available状态的卷或者共享卷。
- 仅支持挂载SCSI类型的卷。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1/{project_id}/baremetalservers/{server_id}/attachvolume
参数 |
是否必选 |
描述 |
---|---|---|
project_id |
是 |
项目ID。 获取方式请参见获取项目ID。 |
server_id |
是 |
裸金属服务器ID。 可以从裸金属服务器控制台查询,或者通过调用查询裸金属服务器列表(OpenStack原生)API获取。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
volumeId |
是 |
String |
要挂卷的卷ID。 可以从云硬盘控制台查询,或者通过调用“查询云硬盘列表”API获取。 |
device |
否 |
String |
磁盘挂载点,如/dev/sda、/dev/sdb。 新增加的磁盘挂载点不能和已有的磁盘挂载点相同。 需要根据已有设备名称顺序指定,否则不写device或device的值为""时,由系统自动生成。 |
请求示例
POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/attachvolume |
{ "volumeAttachment": { "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6", "device": "" } } |
响应参数
名称 |
参数类型 |
说明 |
---|---|---|
job_id |
String |
提交任务成功后返回的任务ID,用户可以使用该ID对任务执行情况进行查询。 如何根据job_id来查询Job的执行状态,请参考查询Job状态。 |
响应示例
- 正常响应
{ "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" }
错误码
请参考错误码。