4.7.1 裸金属服务器挂载云硬盘
功能介绍
裸金属服务器创建成功后，如果发现磁盘不够用或者当前磁盘不满足要求，可以将已 有云硬盘挂载给裸金属服务器，作为数据盘使用。
约束
● 不支持批量挂载。
● 单个裸金属服务器最多挂载60块云硬盘。
● 不支持挂载bootable的卷。
● 裸金属服务器状态（OS-EXT-STS:vm_state属性）处于SUSPENDED和PAUSED状 态下不支持挂卷。
● 要挂载的卷必须是available状态的卷或者共享卷。
● 仅支持挂载SCSI类型的卷。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1/{project_id}/baremetalservers/{server_id}/attachvolume 参数说明请参见表4-67。
表4-67 参数说明
参数 是否必选 描述
project_id 是 项目ID。
获取方式请参见获取项目ID。
server_id 是 裸金属服务器ID。
可以从裸金属服务器控制台查询，或者通过 调用查询裸金属服务器列表（OpenStack原 生）API获取。
请求消息
● 请求参数
参数 是否必选 参数类型 描述
volumeAttac
hment 是 Object 要挂载的卷相关信息，详情请参
见表4-68。
表4-68 volumeAttachment 数据结构说明
参数 是否必选 参数类型 描述
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": ""
} }
响应消息
请参考任务Id的响应。
返回值
正常返回值：
返回值 说明
202 服务器已接受请求，延迟处理。
其他返回值请参考状态码。
错误码
请参考错误码。
4.7.2 裸金属服务器卸载云硬盘
功能介绍
将挂载至裸金属服务器中的磁盘卸载。
● 对于挂载在系统盘盘位（也就是“/dev/sda”挂载点）上的磁盘，仅支持离线卸 载。
● 对于挂载在数据盘盘位（非“/dev/sda”挂载点）上的磁盘，支持离线卸载和在 线卸载磁盘。
离线和在线表示裸金属服务器处于“关机”或“运行中”状态。
约束
裸金属服务器状态为“关机”时支持用户盘的卸载且没有操作系统的限制。当裸金属 服务器状态为“运行中”时卸载磁盘有如下约束：
● 对于Linux裸金属服务器，由于操作系统限制，需要客户先登录裸金属服务器，执 行unmount命令，取消待卸载磁盘与文件系统之间的关联，并确保没有程序正在 对该磁盘进行读写操作。否则，卸载磁盘将失败。
● 对于Windows裸金属服务器，在线卸载磁盘，请确保没有程序正在对该磁盘进行 读写操作。否则，将造成数据丢失。
调试
您可以在API Explorer中调试该接口。
URI
DELETE /v1/{project_id}/baremetalservers/{server_id}/detachvolume/
{attachment_id}
参数说明请参见表4-69。
表4-69 参数说明
参数 是否必选 描述
project_id 是 项目ID。
获取方式请参见获取项目ID。
server_id 是 裸金属服务器ID。
可以从裸金属服务器控制台查询，或者通过 调用查询裸金属服务器列表（OpenStack 原生）API获取。
参数 是否必选 描述
attachment_id 是 裸金属服务器的云硬盘ID。
可以通过查询裸金属服务器挂载的云硬盘信 息API获取其挂载的云硬盘ID列表。
请求消息
● 请求参数 无
● 请求样例
DELETE https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/
cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/detachvolume/6b604cef-9bd8-4f5a-ae56-45839e6e1f0a
响应消息
请参考任务Id的响应。
返回值
正常返回值：
返回值 说明
202 服务器已接受请求，延迟处理。
其他返回值请参考状态码。
错误码
请参考错误码。
4.7.3 查询裸金属服务器挂载的云硬盘信息
功能介绍
查询裸金属服务器挂载的云硬盘信息。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/baremetalservers/{server_id}/os-volume_attachments 参数说明请参见表4-70。
表4-70 参数说明
参数 是否必选 描述
project_id 是 项目ID。
获取方式请参见获取项目ID。
server_id 是 裸金属服务器ID。
可以从裸金属服务器控制台查询，或者通过调 用查询裸金属服务器列表（OpenStack原生）
API获取。
请求消息
● 请求参数 无
● 请求样例
GET https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/4d8c3732-a248-40ed-bebc-539a6ffd25c0/os-volume_attachments
响应消息
● 响应参数
参数 参数类型 描述
volumeAttachmen
ts Array of objects 裸金属服务器挂载信息列表，详情请 参见表2 volumeAttachments字段 数据结构说明。
表4-71 volumeAttachments 字段数据结构说明
参数 参数类型 描述
device String 挂载目录，例如“/dev/sdd”。
id String 挂载资源ID。
serverId String 所属裸金属服务器ID。
volumeId String 挂载云磁盘ID。
● 响应样例
{ "volumeAttachments": [ {
"device": "/dev/sdd",
"id": "a26887c6-c47b-4654-abb5-dfadf7d3f803", "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0", "volumeId": "a26887c6-c47b-4654-abb5-dfadf7d3f803"
}, {
"device": "/dev/sdc",
"id": "a26887c6-c47b-4654-abb5-dfadf7d3f804", "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0", "volumeId": "a26887c6-c47b-4654-abb5-dfadf7d3f804"
} ] }
返回值
正常返回值：
返回值 说明
200 服务器已成功处理了请求。
其他返回值请参考状态码。
错误码
请参考错误码。