更新时间:2024-10-22 GMT+08:00

裸金属服务器挂载云硬盘(废弃)

功能介绍

为裸金属服务器挂载云硬盘。

当前API已废弃,请使用“裸金属服务器挂载云硬盘”。

约束

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

URI

POST /v2.1/{project_id}/servers/{server_id}/os-volume_attachments

参数说明请参见表1

表1 参数说明

参数

是否必选

描述

project_id

项目ID。

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

server_id

裸金属服务器ID。

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

请求参数

参数

是否必选

参数类型

描述

volumeAttachment

Object

要挂载的卷相关信息,详情请参见表2

表2 volumeAttachment数据结构说明

参数

是否必选

参数类型

描述

volumeId

String

要挂卷的卷ID。

device

String

磁盘挂载点,如/dev/sda、/dev/sdb。

新增加的磁盘挂载点不能和已有的磁盘挂载点相同。

需要根据已有设备名称顺序指定,否则由系统自动生成。

请求示例

挂载一块ID为b53f23bd-ee8f-49ec-9420-d1acfeaf91d6的云硬盘到ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器上,挂载点为/dev/sdb。
1
POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/os-volume_attachments
1
2
3
4
5
6
{
    "volumeAttachment": {
        "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6",
        "device": "/dev/sdb"
    }
}

响应参数

参数

参数类型

描述

volumeAttachment

Object

裸金属服务器挂载信息列表,详情请参见表3

表3 volumeAttachment字段数据结构说明

参数

参数类型

描述

device

String

设备名称,例如“/dev/vdb”。

serverId

String

挂载的裸金属服务器,UUID格式。

id

String

卷的UUID。

volumeId

String

挂载ID,目前实现与卷UUID相同。

响应示例

1
2
3
4
5
6
7
8
{
    "volumeAttachment": {
        "id": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6",
        "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6",
        "serverId": "820abbd0-2d8e-4bc5-ae46-69cacfd4fbaa",
        "device": "/dev/vdb"
    }
}

返回值

正常返回值:

返回值

说明

200

服务器已成功处理了请求。

其他返回值请参考状态码

错误码

请参考错误码