文档首页> 云硬盘 EVS> API参考> Cinder API> 云硬盘管理> 查询所有云硬盘详情

更新时间：2024-01-02 GMT+08:00

在线调试

CLI示例

查看PDF

查询所有云硬盘详情

功能介绍

查询所有云硬盘详情。

调用方法

请参见如何调用API。

URI

GET /v2/{project_id}/volumes/detail

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。获取方法请参见"获取项目ID"。

表2 Query参数
参数	是否必选	参数类型	描述
marker	否	String	取值为上一页数据的最后一条记录的id，返回值为该项后面的项
name	否	String	云硬盘名称。最大支持85个字符。
limit	否	Integer	返回结果个数限制。最小值1，最大值1000，默认为1000。返回的结果中记录数不超过limit值。当租户所有的云硬盘数量大于50个时，为了提升您的查询效率，建议查询的时候使用limit参数，并且参数值最大设置为50。查询示例： GET /v2/xxx/volumes/detail?limit=50，表示查询第1~50个云硬盘。GET /v2/xxx/volumes/detail?offset=50&limit=50，表示查询第51~100个云硬盘。
sort_key	否	String	返回结果按该关键字排序，支持id，status，size，created_at等关键字，默认为“created_at”。
sort_dir	否	String	返回结果按照降序或升序排列，默认为“desc”。降序：desc 升序：asc
offset	否	Integer	偏移量偏移量为一个大于0小于磁盘总个数的整数，表示查询该偏移量后面的所有的云硬盘。
status	否	String	云硬盘状态
metadata	否	String	云硬盘元数据。该参数通过Json格式进行传参，如：GET /v2/{project_id}/volumes/detail?metadata={"hw:passthrough": "true"}
availability_zone	否	String	AZ信息

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
volumes	Array of VolumeDetail objects	查询请求返回的云硬盘列表。
volumes_links	Array of Link objects	云硬盘列表查询位置标记。如果本次查询只返回部分列表信息时，会返回查询到的当前云硬盘mark标记的url，可以继续使用这个url查询剩余列表信息。

表5 VolumeDetail
参数	参数类型	描述
id	String	云硬盘ID。
links	Array of Link objects	云硬盘uri自描述信息。
name	String	云硬盘名称。
status	String	云硬盘状态。云硬盘状态，具体请参见云硬盘状态。
attachments	Array of VolumeAttachment objects	是否挂载信息。
availability_zone	String	云硬盘所属AZ。
source_volid	String	源云硬盘ID，如果是从源云硬盘创建，则有值。当前云硬盘服务不支持该字段。
snapshot_id	String	快照ID，如果是从快照创建，则有值。
description	String	云硬盘描述。
bootable	String	是否为启动云硬盘。 true：表示为启动云硬盘。 false：表示为非启动云硬盘。
encrypted	Boolean	当前云硬盘服务不支持该字段。
created_at	String	云硬盘创建时间。时间格式：UTC YYYY-MM-DDTHH:MM:SS.XXXXXX
volume_type	String	云硬盘类型。目前支持"SATA"，"SAS"，"GPSSD"，"SSD"，"ESSD"，"GPSSD2"，"ESSD2"七种。 "SATA"为普通IO云硬盘(已售罄) "SAS"为高IO云硬盘 "GPSSD"为通用型SSD云硬盘 "SSD"为超高IO云硬盘 "ESSD"为极速IO云硬盘 "GPSSD2"为通用型SSD V2云硬盘 "ESSD2"为极速型SSD V2云硬盘
replication_status	String	预留属性。
consistencygroup_id	String	预留属性。
metadata	VolumeMetadata object	云硬盘的元数据。如果元数据中不包含hw:passthrough字段，云硬盘默认为VBD类型。如果元数据中不包含__system__encrypted字段，云硬盘默认为不加密。
size	Integer	云硬盘大小，单位为GiB。
user_id	String	预留属性。
updated_at	String	云硬盘更新时间。时间格式：UTC YYYY-MM-DDTHH:MM:SS.XXXXXX
shareable	Boolean	是否为可共享云硬盘。说明：该字段已经废弃，请使用multiattach。
multiattach	Boolean	是否为可共享云硬盘。
os-vol-tenant-attr:tenant_id	String	云硬盘所属的租户ID。租户ID就是项目ID。
volume_image_metadata	Object	云硬盘镜像的元数据。关于“volume_image_metadata”字段的详细说明，具体请参见："查询镜像详情"。
os-vol-host-attr:host	String	预留属性。
os-volume-replication:extended_status	String	预留属性。
os-vol-mig-status-attr:migstat	String	预留属性。
os-vol-mig-status-attr:name_id	String	预留属性。
iops	iops object	云硬盘的iops信息，云硬盘类型是ESSD2、GPSSD2才返回。
throughput	throughput object	云硬盘的吞吐量信息，云硬盘类型是GPSSD2才返回。

表6 VolumeAttachment
参数	参数类型	描述
attached_at	String	挂载的时间信息。时间格式：UTC YYYY-MM-DDTHH:MM:SS.XXXXXX
attachment_id	String	挂载信息对应的ID。
device	String	挂载点
host_name	String	云硬盘挂载到的云服务器云主机对应的物理主机的名称。
id	String	挂载的资源ID
server_id	String	云硬盘挂载到的云服务器云主机的 ID。
volume_id	String	云硬盘ID

表7 VolumeMetadata
参数	参数类型	描述
__system__cmkid	String	metadata中的加密cmkid字段，与__system__encrypted配合表示需要加密，cmkid长度固定为36个字节。说明：请参考查询密钥列表，通过HTTPS请求获取密钥ID。
__system__encrypted	String	metadata中的表示加密功能的字段，0代表不加密，1代表加密。该字段不存在时，云硬盘默认为不加密。
full_clone	String	从快照创建云硬盘时，如需使用link克隆方式，请指定该字段的值为0。
hw:passthrough	String	true表示云硬盘的设备类型为SCSI类型，即允许ECS操作系统直接访问底层存储介质。支持SCSI锁命令。 false表示云硬盘的设备类型为VBD (虚拟块存储设备 , Virtual Block Device)类型，即为默认类型，VBD只能支持简单的SCSI读写命令。该字段不存在时，云硬盘默认为VBD类型。

表8 iops
参数	参数类型	描述
frozened	Boolean	冻结标签。缺省值：false
id	String	云硬盘iops标识。
total_val	Integer	iops大小。
volume_id	String	云硬盘ID。

表9 throughput
参数	参数类型	描述
frozened	Boolean	冻结标签。缺省值：false
id	String	云硬盘吞吐量标识。
total_val	Integer	吞吐量大小。
volume_id	String	云盘ID。

**表10** Link
参数	参数类型	描述
href	String	对应的快捷链接。
rel	String	快捷链接标记名称。缺省值：next

状态码： 400

**表11** 响应Body参数
参数	参数类型	描述
error	Error object	出现错误时，返回的错误信息。

**表12** Error
参数	参数类型	描述
code	String	出现错误时，返回的错误码。错误码和其对应的含义请参考错误码说明。
message	String	出现错误时，返回的错误消息。

请求示例

GET https://{endpoint}/v2/{project_id}/volumes/detail

响应示例

状态码： 200

{
  "volumes" : [ {
    "attachments" : [ ],
    "availability_zone" : "az-dc-1",
    "bootable" : "false",
    "created_at" : "2016-05-25T02:42:10.856332",
    "encrypted" : false,
    "id" : "b104b8db-170d-441b-897a-3c8ba9c5a214",
    "links" : [ {
      "href" : "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/b104b8db-170d-441b-897a-3c8ba9c5a214",
      "rel" : "self"
    }, {
      "href" : "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/b104b8db-170d-441b-897a-3c8ba9c5a214",
      "rel" : "bookmark"
    } ],
    "metadata" : { },
    "name" : "zjb_u25_test",
    "os-vol-host-attr:host" : "pod01.xxx#SATA",
    "volume_image_metadata" : { },
    "os-vol-tenant-attr:tenant_id" : "dd14c6ac581f40059e27f5320b60bf2f",
    "replication_status" : "disabled",
    "multiattach" : false,
    "size" : 1,
    "status" : "available",
    "updated_at" : "2016-05-25T02:42:22.341984",
    "user_id" : "b0524e8342084ef5b74f158f78fc3049",
    "volume_type" : "SATA",
    "consistencygroup_id" : null,
    "os-vol-mig-status-attr:migstat" : null,
    "os-vol-mig-status-attr:name_id" : null,
    "snapshot_id" : null,
    "source_volid" : null
  } ],
  "volumes_links" : [ {
    "href" : "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/detail?limit=1&marker=b104b8db-170d-441b-897a-3c8ba9c5a214",
    "rel" : "next"
  } ]
}

状态码： 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

状态码

状态码	描述
200	OK
400	Bad Request

错误码

请参见错误码。

父主题： 云硬盘管理

上一篇：查询单个云硬盘详情

下一篇：查询扩展接口

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

查询所有云硬盘详情

功能介绍

调用方法

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

相关产品

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线