# 裸金属服务器挂载云硬盘 - AttachBaremetalServerVolume #### 功能介绍 裸金属服务器创建成功后，如果发现磁盘不够用或者当前磁盘不满足要求，可以将已有云硬盘挂载给裸金属服务器，作为数据盘使用。 #### 约束 - 不支持批量挂载。 - 单个裸金属服务器最多挂载60块云硬盘。 - 不支持挂载bootable的卷。 - 裸金属服务器状态（OS-EXT-STS:vm_state属性）处于PAUSED状态下不支持挂卷。 - 要挂载的卷必须是available状态的卷或者共享卷。 - 仅支持挂载SCSI类型的卷。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/doc?api=AttachBaremetalServerVolume)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-bms/bms_api_0900.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | bms:servers:attachVolume | write | instance\* | - g:EnterpriseProjectId - g:ResourceTag/\ - bms:KmsKeyId - evs:Encrypted - bms:VolumeType - bms:VolumeId | - | evs:volumes:use | #### URI POST /v1/{project_id}/baremetalservers/{server_id}/attachvolume 参数说明请参见[表1]。 表1参数说明 | 参数 | 是否必选 | 描述 | |:---|:---|:---| | project_id | 是 | 项目ID。 获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-bms/bms_api_appendix_03.html)。 | | server_id | 是 | 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用[查询裸金属服务器列表（废弃）](https://support.huaweicloud.com/api-bms/bms_api_0709.html)获取。 | #### 请求参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | volumeAttachment | 是 | Object | 要挂载的卷相关信息，详情请参见[表2]。 | 表2volumeAttachment数据结构说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | volumeId | 是 | String | 要挂卷的卷ID。 可以从云硬盘控制台查询，或者通过调用"[查询云硬盘列表](https://support.huaweicloud.com/api-evs/evs_04_3032.html)"API获取。 | | device | 否 | String | 磁盘挂载点，如/dev/sda、/dev/sdb。 新增加的磁盘挂载点不能和已有的磁盘挂载点相同。 需要根据已有设备名称顺序指定，否则不写device或device的值为""时，由系统自动生成。 | #### 请求示例 挂载ID为b53f23bd-ee8f-49ec-9420-d1acfeaf91d6的云硬盘到ID为cf2a8b97-b5c6-47ef-9714-eb27adf26e5b的裸金属服务器。 ``` POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/attachvolume ``` ``` { "volumeAttachment": { "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6", "device": "" } } ``` #### 响应参数 表3正常响应要素说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | job_id | String | 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。 如何根据job_id来查询Job的执行状态，请参考[查询Job状态 - ShowJobInfos](https://support.huaweicloud.com/api-bms/bms_api_0640.html)。 | 表4异常响应要素说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | error | 字典数据结构 | 提交任务异常时返回的异常信息，详情请参见[表5]。 | 表5error数据结构 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | message | String | 任务异常错误信息描述。 | | code | String | 任务异常错误信息编码。 | #### 响应示例 - 正常响应 ``` { "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" } ``` #### 返回值 正常返回值： | 返回值 | 说明 | |:---|:---| | 202 | 服务器已接受请求，延迟处理。 | 其他返回值请参考[状态码](https://support.huaweicloud.com/api-bms/bms_api_0801.html)。 #### 错误码 请参考[错误码](https://support.huaweicloud.com/api-bms/bms_api_0802.html)。