查询云硬盘列表
功能介绍
查询云硬盘列表。
调用方法
请参见如何调用API。
URI
GET /v3/{project_id}/volumes
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。 获取方法请参见"获取项目ID"。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
marker |
否 |
String |
分页查询的起始资源id，取值为上一页最后一条查询记录的资源id。 |
|
name |
否 |
String |
云硬盘名称。最大支持64个字符。 |
|
limit |
否 |
Integer |
返回结果个数限制。 最小值1，最大值1000，默认为1000。返回的结果中记录数不超过limit值。 当租户所有的云硬盘数量大于50个时，为了提升您的查询效率，建议查询的时候使用limit参数，并且参数值最大设置为50。查询示例： GET /v2/xxx/volumes?limit=50，表示查询第1~50个云硬盘。GET /v2/xxx/volumes?offset=50&limit=50，表示查询第51~100个云硬盘。 |
|
sort_dir |
否 |
String |
返回结果按照降序或升序排列，默认为“desc”。 降序：desc 升序：asc |
|
sort_key |
否 |
String |
返回结果按该关键字排序，支持id，status，size，created_at等关键字，默认为“created_at”。 |
|
offset |
否 |
Integer |
偏移量 偏移量为一个大于0小于磁盘总个数的整数，表示查询该偏移量后面的所有的云硬盘。 |
|
status |
否 |
String |
云硬盘状态， 具体请参见云硬盘状态。 |
|
metadata |
否 |
String |
云硬盘元数据。 |
|
availability_zone |
否 |
String |
AZ信息。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
volumes |
Array of VolumeBody objects |
查询请求返回的云硬盘列表。 |
|
volumes_links |
Array of Link objects |
云硬盘列表查询位置标记。如果本次查询只返回部分列表信息时，会返回查询到的当前云硬盘mark标记的url，可以继续使用这个url查询剩余列表信息。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
云硬盘ID。 |
|
links |
Array of Link objects |
云硬盘URI自描述信息。 |
|
name |
String |
云硬盘名称。 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
Error object |
参数解释 出现错误时，返回的错误信息。 取值范围 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释 出现错误时，返回的错误码。 取值范围 错误码和其对应的含义请参考错误码说明。 |
|
message |
String |
参数解释 出现错误时，返回的错误消息。 取值范围 不涉及。 |
请求示例
GET https://{endpoint}/v3/{project_id}/volumes?status=available
响应示例
状态码：200
OK
{
"volumes" : [ {
"id" : "6b604cef-9bd8-4f5a-ae56-45839e6e1f0a",
"links" : [ {
"href" : "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/6b604cef-9bd8-4f5a-ae56-45839e6e1f0a",
"rel" : "self"
}, {
"href" : "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/6b604cef-9bd8-4f5a-ae56-45839e6e1f0a",
"rel" : "bookmark"
} ],
"name" : "zjb_u25_test"
}, {
"id" : "2bce4552-9a7d-48fa-8484-abbbf64b206e",
"links" : [ {
"href" : "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/2bce4552-9a7d-48fa-8484-abbbf64b206e",
"rel" : "self"
}, {
"href" : "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/2bce4552-9a7d-48fa-8484-abbbf64b206e",
"rel" : "bookmark"
} ],
"name" : "zjb_u25_test"
}, {
"id" : "3f1b98ec-a8b5-4e92-a727-88def62d5ad3",
"links" : [ {
"href" : "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/3f1b98ec-a8b5-4e92-a727-88def62d5ad3",
"rel" : "self"
}, {
"href" : "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/3f1b98ec-a8b5-4e92-a727-88def62d5ad3",
"rel" : "bookmark"
} ],
"name" : "zjb_u25_test"
} ],
"volumes_links" : [ {
"href" : "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes?limit=3&marker=3f1b98ec-a8b5-4e92-a727-88def62d5ad3",
"rel" : "next"
} ]
}
状态码：400
Bad Request
{
"error" : {
"message" : "XXXX",
"code" : "XXX"
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
错误码
请参见错误码。
