响应参数
4.6 磁盘管理
"port_state": "ACTIVE", "fixed_ips": [
{
"subnet_id": "ba31e1f5-fa76-4530-862c-5176fad033cf", "ip_address": "192.168.0.33"
} ],
"net_id": "610a4af2-1d90-4d2b-8057-dc238b26febf", "port_id": "04819c0a-6a07-44b6-945e-fb932071888e", "mac_addr": "fa:16:3e:45:65:c4"
} ] }
返回值
请参考通用请求返回值。
4.6 磁盘管理
4.6.1 查询弹性云服务器单个磁盘信息
功能介绍
查询弹性云服务器挂载的单个磁盘信息。
该接口支持企业项目细粒度权限的校验，具体细粒度请参见 ecs:cloudServers:get
URI
GET /v1/{project_id}/cloudservers/{server_id}/block_device/{volume_id}
参数说明请参见表4-120。
表4-120 参数说明
参数 是否必选 描述
server_id 是 弹性云服务器ID，UUID格式。
project_id 是 项目ID。
获取方法请参见获取项目ID。
volume_id 是 云硬盘ID，UUID格式。
请求消息
无
响应消息
响应参数如表4-121所示。
表4-121 响应参数
参数 参数类型 描述
volumeAttachme
nt Object 云服务器挂载信息，更多信息请参见表
4-122。
表4-122 volumeAttachment 参数
参数 参数类型 描述
serverId String 弹性云服务器ID，UUID格式。
volumeId String 云硬盘ID，UUID格式。
id String 挂载ID，与云硬盘ID相同。
UUID格式。
size Integer 云硬盘大小，单位GB。
device String 云硬盘挂载盘符，即磁盘挂载点。
pciAddress String pci地址。
bootIndex Integer 云硬盘启动顺序。
● 0为系统盘。
● 非0为数据盘
bus String 磁盘总线类型 。
取值范围：virtio、scsi
请求示例
GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/block_device/{volume_id}
响应示例
{ "volumeAttachment": { "pciAddress": "0000:02:01.0",
"volumeId": "a26887c6-c47b-4654-abb5-asdf234r234r"
"device": "/dev/vda",
"serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0", "id": "a26887c6-c47b-4654-abb5-asdf234r234r", "size": "40",
"bootIndex": 0, "bus":"virtio"
} }
返回值
请参考通用请求返回值。
错误码
请参考错误码。
4.6.2 查询弹性云服务器挂载磁盘列表信息
功能介绍
查询弹性云服务器挂载的磁盘列表信息。
URI
GET /v1/{project_id}/cloudservers/{server_id}/os-volume_attachments 参数说明请参见表4-123。
表4-123 参数说明
参数 是否必选 描述
project_id 是 项目ID。
获取方法请参见获取项目ID。
server_id 是 弹性云服务器ID，UUID格式。
请求消息
无
响应消息
响应参数如表4-124所示。
表4-124 响应参数
参数 参数类型 描述
volumeAttachment
s Array of objects 云服务器挂载信息列表，详情请参见表 4-125。
表4-125 volumeAttachments 字段数据结构说明
参数 参数类型 描述
device String 云硬盘挂载盘符，即磁盘挂载点。
参数 参数类型 描述
id String 挂载ID，与云硬盘ID相同。
UUID格式。
serverId String 弹性云服务器ID，UUID格式。
volumeId String 云硬盘ID，UUID格式。
请求示例
GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-volume_attachments
响应示例
{ "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"
} ] }
返回值
请参考通用请求返回值。
错误码
请参考错误码。
4.6.3 查询弹性云服务器挂载磁盘列表详情信息
功能介绍
查询弹性云服务器挂载的磁盘列表详情信息。
URI
GET /v1/{project_id}/cloudservers/{server_id}/block_device 参数说明请参见表4-126。
表4-126 参数说明
参数 是否必选 描述
project_id 是 项目ID。
获取方法请参见获取项目ID。
server_id 是 弹性云服务器ID，格式为UUID。
请求消息
无
响应消息
响应参数如表4-127所示。
表4-127 响应参数
参数 参数类型 描述
volumeAttachments Array of
objects 云服务器挂载信息列表，更多信息请参见 表4-128。
attachableQuantity Object 云服务器可挂载磁盘数量，更多信息请参 见表4-129。
表4-128 volumeAttachments 参数
参数 参数类型 描述
serverId String 弹性云服务器ID，UUID格式。
volumeId String 云硬盘ID，UUID格式。
id String 挂载ID，与云硬盘ID相同。
UUID格式。
size Integer 云磁盘大小，单位GB。
device String 云硬盘挂载盘符，即磁盘挂载点。
pciAddress String pci地址。
bootIndex Integer 云硬盘启动顺序。
● 0为系统盘
● 非0为数据盘
bus String 磁盘总线类型 。
取值范围：virtio、scsi
表4-129 attachableQuantity 参数
参数 参数类型 描述
free_scsi Integer 云服务器可挂载scsi类型磁盘数量。
free_blk Integer 云服务器可挂载virtio_blk类型磁盘数量。
free_disk Integer 云服务器可挂载磁盘总数。
请求示例
GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/block_device
响应示例
{ "attachableQuantity": { "free_scsi": 23, "free_blk": 15, "free_disk": 23 },
"volumeAttachments": [ {
"pciAddress": "0000:02:01.0",
"volumeId": "a26887c6-c47b-4654-abb5-dfadf7d3f803", "device": "/dev/vda",
"serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0", "id": "a26887c6-c47b-4654-abb5-dfadf7d3f803", "size": "40",
"volumeId": "a26887c6-c47b-4654-abb5-asdf234r234r", "device": "/dev/vdb",
"serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0", "id": "a26887c6-c47b-4654-abb5-asdf234r234r", "size": "10",
URI
POST /v1/{project_id}/cloudservers/{server_id}/attachvolume 参数说明请参见表4-130。
表4-130 参数说明
参数 是否必选 描述
project_id 是 项目ID。
获取方法请参见获取项目 ID。
server_id 是 云服务器ID。
请求消息
表4-131 请求参数
参数 是否必
选
参数类型 描述
volumeAttachm
ent 是 Object 云服务器挂载信息，参考表4-132。
表4-132 volumeAttachment 数据结构说明
参数 是否必
选
参数类型 描述
volumeId 是 String 待挂载磁盘的磁盘ID，UUID格式。
device 否 String 磁盘挂载点。
说明
● 新增加的磁盘挂载点不能和已有的磁盘 挂载点相同。
● 对于采用XEN虚拟化类型的弹性云服务 器，device为必选参数；系统盘挂载点 请指定/dev/sda；数据盘挂载点请按英 文字母顺序依次指定，如/dev/
sdb，/dev/sdc，如果指定了以
“/dev/vd”开头的挂载点，系统默认改 为“/dev/sd”。
● 对于采用KVM虚拟化类型的弹性云服务 器，系统盘挂载点请指定/dev/vda；数 据盘挂载点可不用指定，也可按英文字 母顺序依次指定，如/dev/vdb，/dev/
vdc，如果指定了以“/dev/sd”开头的 挂载点，系统默认改为“/dev/vd”。
响应消息
请参考响应（任务类）。
请求示例
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/attachvolume { "volumeAttachment": {
"volumeId": "a26887c6-c47b-4654-abb5-dfadf7d3f803", "device": "/dev/sda"
} }
响应示例
{ "job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}
返回值
请参考通用请求返回值。
错误码
请参考错误码。
4.6.5 弹性云服务器卸载磁盘
功能介绍
从弹性云服务器中卸载磁盘。
URI
DELETE /v1/{project_id}/cloudservers/{server_id}/detachvolume/{volume_id}?
delete_flag=0
参数说明请参见表4-133。
表4-133 参数说明
参数 是否必选 描述
project_id 是 项目ID。
获取方法请参见获取项目ID。
server_id 是 云服务器ID。
volume_id 是 磁盘ID。
参数 是否必选 描述
delete_flag 否 是否强制卸载数据盘。
● 是，值为“1”。
● 否，值为“0”。
默认值为0。
请求消息
无
响应消息
请参考响应（任务类）。
请求示例
DELETE https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/detachvolume/{volume_id}
响应示例
无
返回值
请参考通用请求返回值。
错误码
请参考错误码。