# 查询云硬盘列表(废弃) - ListDisks
#### 功能介绍
查询所有云硬盘的概要列表。该接口已废弃，请使用性能更佳的接口。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-evs/evs_04_0009.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-evs/evs_04_0023.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
GET /v2/{project_id}/cloudvolumes
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述    |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID。 |
   
表2Query参数 
| 参数                | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| marker            | 否    | String  | 取值为上一页数据的最后一条记录的id，返回值为该项后面的项。取值为上一页数据的最后一条记录的id，返回值为该项后面的项。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| name              | 否    | String  | 云硬盘名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| status            | 否    | String  | 云硬盘状态，具体请参见[云硬盘状态](https://support.huaweicloud.com/api-evs/evs_04_0040.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| limit             | 否    | Integer | 返回结果个数限制。默认值为1000。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| availability_zone | 否    | String  | AZ信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| sort_key          | 否    | String  | **参数解释** 返回结果按该关键字排序。 **约束限制** 不涉及。 **取值范围** - id：云硬盘ID。   - status：云硬盘状态，取值可参考：\["[云硬盘状态](https://support.huaweicloud.com/api-evs/evs_04_0040.html)"\]。   - size：云硬盘大小，单位为GiB。   - created_at：云硬盘创建时间。    **默认取值** created_at |
| sort_dir          | 否    | String  | 降序或升序，分别对应desc和asc，默认为"desc"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                            |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数      | 参数类型                                                               | 描述            |
|:---|:---|:---|
| volumes | Array of [DiskSummary] objects | 查询请求返回的云硬盘列表。 |
   
 表5DiskSummary 
| 参数    | 参数类型                                                 | 描述                                                                                                                             |
|:---|:---|:---|
| id    | String                                               | **参数解释** 云硬盘的唯一标识ID **取值范围** 不涉及。 |
| links | Array of [Link] objects | 云硬盘uri自描述信息。                                                                                                                   |
| name  | String                                               | 云硬盘的名称。最大支持85个字符。                                                                                                              |
   
 表6Link 
| 参数   | 参数类型   | 描述                                                                                                                            |
|:---|:---|:---|
| href | String | **参数解释** 对应的快捷链接。 **取值范围** 不涉及。  |
| rel  | String | **参数解释** 快捷链接标记名称。 **取值范围** 不涉及。 |
   
**状态码：400**
表7响应Body参数 
| 参数    | 参数类型                                         | 描述                                                                                                                                                                                                                        |
|:---|:---|:---|
| error | [Error] object | **参数解释** 出现错误时，返回的错误码。错误码和其对应的含义请参考[错误码说明](https://support.huaweicloud.com/api-evs/evs_04_0038.html)。 **取值范围** 包含错误码和错误消息的对象 |
   
 表8Error 
| 参数      | 参数类型   | 描述                                                                                                                                                                                                           |
|:---|:---|:---|
| code    | String | **参数解释** 出现错误时，返回的错误码。 **取值范围** 错误码和其对应的含义请参考[错误码说明](https://support.huaweicloud.com/api-evs/evs_04_0038.html)。 |
| message | String | **参数解释** 出现错误时，返回的错误消息。 **取值范围** 描述错误消息的字符串                                                                     |
   
#### 请求示例
无
#### 响应示例
**状态码：200**
OK
```
{
  "volumes" : [ {
    "id" : "e6cf4401-15f6-44bd-ae2b-cff4dc9523e6",
    "links" : [ {
      "href" : "https://volume.az0.dc1.domainname.com/v2/cd631140887d4b6e9c786b67a6dd4c02/volumes/e6cf4401-15f6-44bd-ae2b-cff4dc9523e6",
      "rel" : "self"
    }, {
      "href" : "https://volume.az0.dc1.domainname.com/cd631140887d4b6e9c786b67a6dd4c02/volumes/e6cf4401-15f6-44bd-ae2b-cff4dc9523e6",
      "rel" : "bookmark"
    } ],
    "name" : "hallo5"
  }, {
    "id" : "4c5e8203-f70e-4717-90cd-4a8f636888d1",
    "links" : [ {
      "href" : "https://volume.az0.dc1.domainname.com/v2/cd631140887d4b6e9c786b67a6dd4c02/volumes/4c5e8203-f70e-4717-90cd-4a8f636888d1",
      "rel" : "self"
    }, {
      "href" : "https://volume.az0.dc1.domainname.com/cd631140887d4b6e9c786b67a6dd4c02/volumes/4c5e8203-f70e-4717-90cd-4a8f636888d1",
      "rel" : "bookmark"
    } ],
    "name" : "hallo4"
  } ]
}
```
**状态码：400**
Bad Request
```
{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}
```
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 200 | OK          |
| 400 | Bad Request |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-evs/evs_04_0038.html)。