华为云计算 云知识 裸金属服务器挂载云硬盘AttachBaremetalServerVolume
裸金属服务器挂载云硬盘AttachBaremetalServerVolume

 

功能介绍

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

约束

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

调试

您可以在API Explorer中调试该接口。

URI

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

参数说明请参见表1。

表1 参数说明

参数

是否必选

描述

project_id

项目ID。

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

server_id

裸金属服务器ID。

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

请求参数

参数

是否必选

参数类型

描述

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的裸金属服务器。
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状态

表4 异常响应要素说明

名称

参数类型

说明

error

字典数据结构

提交任务异常时返回的异常信息,详情请参见表1 error数据结构。

表5 error数据结构

名称

参数类型

说明

message

String

任务异常错误信息描述。

code

String

任务异常错误信息编码。

响应示例

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

返回值

正常返回值:

返回值

说明

202

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

其他返回值请参考状态码

错误码

请参考错误码

上一篇:密钥管理服务 下一篇:华为云首届技术创新大赛

云硬盘 EVS

云硬盘(Elastic Volume Service)是一种为ECS、BMS等计算服务提供持久性块存储的服务,通过数据冗余和缓存加速等多项技术,提供高可用性和持久性,以及稳定的低时延性能。您可以对云硬盘做格式化、创建文件系统等操作,并对数据做持久化存储