查询云硬盘列表(废弃) - ListDisks
功能介绍
查询所有云硬盘的概要列表。该接口已废弃，请使用性能更佳的接口。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
GET /v2/{project_id}/cloudvolumes
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
marker |
否 |
String |
取值为上一页数据的最后一条记录的id，返回值为该项后面的项。取值为上一页数据的最后一条记录的id，返回值为该项后面的项。 |
|
name |
否 |
String |
云硬盘名称。 |
|
status |
否 |
String |
云硬盘状态，具体请参见云硬盘状态。 |
|
limit |
否 |
Integer |
返回结果个数限制。默认值为1000。 |
|
availability_zone |
否 |
String |
AZ信息。 |
|
sort_key |
否 |
String |
参数解释 返回结果按该关键字排序。 约束限制 不涉及。 取值范围
默认取值 created_at |
|
sort_dir |
否 |
String |
降序或升序，分别对应desc和asc，默认为“desc”。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
volumes |
Array of DiskSummary objects |
查询请求返回的云硬盘列表。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
云硬盘ID。 |
|
links |
Array of Link objects |
云硬盘uri自描述信息。 |
|
name |
String |
云硬盘的名称。最大支持85个字符。 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释 出现错误时，返回的错误码。 取值范围 错误码和其对应的含义请参考错误码说明。 |
|
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 |
错误码
请参见错误码。
