盘类型列表"可以查到，即 volume_types参数说明表格中
6.1.10 查询单个云硬盘详情(废弃)
状态码： 400 Bad Request
{ "error" : {
"message" : "XXXX", "code" : "XXX"
}}
状态码
状态码 描述
200 云硬盘的信息。
400 Bad Request
错误码
请参见错误码。
6.1.10 查询单个云硬盘详情(废弃)
功能介绍
查询单个云硬盘的详细信息。该接口已废弃，请使用性能更佳的接口。
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/{project_id}/os-vendor-volumes/{volume_id}
表6-76 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID
volume_id 是 String 云硬盘ID
请求参数
表6-77 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String Token的有效期为24小时，需要 使用一个Token鉴权时，可以先 缓存起来，避免频繁调用。
响应参数
状态码： 200
表6-78 响应 Body 参数
参数 参数类型 描述
volume DiskDetail
object 云硬盘详情。
表6-79 DiskDetail
参数 参数类型 描述
attachments Array of DiskAttachm ent objects
云硬盘的挂载信息。
availability_zo
ne String 云硬盘所属的AZ信息。
bootable String 是否为可启动云硬盘。
consistencygr
oup_id String 所属一致性组ID。
count String 已查询出的云硬盘列表中云硬盘的 数量 created_at String 云硬盘创建时间。
时间格式：UTC YYYY-MM-DDTHH:MM:SS.XXXXXX dedicated_sto
rage_id String 云硬盘所属的专属存储池ID dedicated_sto
rage_name String 云硬盘所属的专属存储池的名称 description String 云硬盘描述。
encrypted Boolean 是否为加密云硬盘。
参数 参数类型 描述 enterprise_pro
ject_id String 云硬盘上绑定的企业项目ID。 当前云硬盘服务不 支持该字段
id String 云硬盘ID。
links Array of Link
objects 云硬盘URI自描述信息。
metadata DiskMetadat
a object 元数据。
multiattach Boolean 创建共享云硬盘的信息
name String 云硬盘名称。
os-vendorextend ed:lock_check _endpoint
String 检查锁是否有效的回调链接
os-vendorextend ed:lock_scene
String 云硬盘的加锁类型
os-vendorextend ed:lock_sourc e_id
String 云硬盘的锁归属的资源ID
os-vendorextend ed:lock_sourc e_service
String 云硬盘的锁归属的服务类型
os-vol-hostattr:host String 云硬盘所在的主机
os-vol-migstatusattr:
migstat
String 预留属性
os-vol-migstatusattr:
name_id
String 预留属性
os-voltenantattr:
tenant_id
String 云硬盘所属的租户ID
os-volumereplica tion:driver_da ta
String 预留属性
参数 参数类型 描述 os-volumereplica
tion:extended _status
String 预留属性
replication_st
atus String 预留属性
service_type String 服务类型，结果为EVS、DSS、 DESS。
shareable Boolean 是否为可共享云硬盘。
size Integer 云硬盘大小。
snapshot_id String 快照ID。
source_volid String 源云硬盘ID。
status String 云硬盘状态，请参见 云硬盘状态。
tags Object 云硬盘的标签。
如果云硬盘有标签，则会有该字段，否则该字段 为空。
updated_at String 云硬盘更新时间。
user_id String 预留属性 volume_imag
e_metadata Object 如果云硬盘是从镜像创建的则会有该字段，否则 该字段为空。 说明： 关于
“volume_image_metadata”字段的详细说明，
具体请参见查询镜像详情（OpenStack原生）。
volume_type String 云硬盘类型。
目前支持"SATA"，"SAS"，"GPSSD"和"SSD"四 种。
● "SATA"为普通IO云硬盘
● "SAS"为高IO云硬盘
● "GPSSD"为通用型SSD云硬盘
● "SSD"为超高IO云硬盘
wwn String 云硬盘挂载时的唯一标识
表6-80 DiskAttachment
参数 参数类型 描述
attached_at String 挂载的时间信息。
时间格式：UTC YYYY-MM-DDTHH:MM:SS.XXXXXX
参数 参数类型 描述 attachment_i
d String 挂载信息对应的ID。
device String 挂载点
host_name String 云硬盘挂载到的云服务器云主机对应 的物理主机 的名称。
id String 挂载的资源ID
server_id String 云硬盘挂载到的云服务器云主机的 ID。
volume_id String 云硬盘ID
表6-81 Link
参数 参数类型 描述
href String 对应的快捷链接。
rel String 快捷链接标记名称。
表6-82 DiskMetadata
参数 参数类型 描述
__system__cm
kid String metadata中的加密cmkid字段，与
__system__encrypted配合表示需要加密，cmkid 长度固定为36个字节。
__system__en
crypted String metadata中的表示加密功能的字段，0代表不加 密，1代表加密。 该字段不存在时，云硬盘默认 为不加密。
full_clone String 从快照创建云硬盘时，字段的值为0表示使用link 克隆方式。
hw:passthrou
gh String metadata中的表示云硬盘设备类型的字段。
● true表示云硬盘的设备类型为SCSI类型，即允 许ECS操作系统直接访问底层存储介质。支持 SCSI锁命令。
● false表示云硬盘的设备类型为VBD类型，即为 默认类型，VBD只能支持简单的SCSI读写命 令。
● 该字段不存在时，云硬盘默认为VBD类型。
表6-83 响应 Body 参数
参数 参数类型 描述
error Error object 出现错误时，返回的错误信息
表6-84 Error
参数 参数类型 描述
code String 出现错误时，返回的错误码。 错误码和其对应的 含义请参考错误码说明。
message String 错误提示信息。
请求示例
"href" : "https://volume.az0.dc1.domainname.com/v2/40acc331ac784f34842ba4f08ff2be48/volumes/
591ac654-26d8-41be-bb77-4f90699d2d41", "rel" : "self"
}, {
"href" : "https://volume.az0.dc1.domainname.com/40acc331ac784f34842ba4f08ff2be48/volumes/
591ac654-26d8-41be-bb77-4f90699d2d41", "rel" : "bookmark"
} ],
"availability_zone" : "az-dc-1", "os-vol-host-attr:host" : "az-dc-1#SSD", "encrypted" : false,
"multiattach" : true,
"updated_at" : "2016-02-03T02:19:29.895237", "os-volume-replication:extended_status" : null, "replication_status" : "disabled",
"snapshot_id" : null,
"id" : "591ac654-26d8-41be-bb77-4f90699d2d41", "size" : 40,
"user_id" : "fd03ee73295e45478d88e15263d2ee4e",
"os-vol-tenant-attr:tenant_id" : "40acc331ac784f34842ba4f08ff2be48", "volume_image_metadata" : null,
"os-vol-mig-status-attr:migstat" : null, "metadata" : { },
"tags" : {
"key1" : "value1", "key2" : "value2"
},
"status" : "available",
"description" : "auto-created_from_restore_from_backup", "source_volid" : null,
"consistencygroup_id" : null,
"os-vol-mig-status-attr:name_id" : null,
"name" : "restore_backup_0115efb3-678c-4a9e-bff6-d3cd278238b9", "bootable" : "false",
"created_at" : "2016-02-03T02:19:11.723797", "volume_type" : null,
"service_type" : "EVS", "dedicated_storage_id" : null, "dedicated_storage_name" : null,
"wwn" : " 688860300000d136fa16f48f05992360"
}}
状态码： 400 Bad Request
{ "error" : {
"message" : "XXXX", "code" : "XXX"
}}
状态码
状态码 描述
200 OK
400 Bad Request
错误码
请参见错误码。