Help Center/ Elastic Volume Service/ API Reference/ API/ Disk Management/ Querying EVS Disks (Deprecated)
Updated on 2025-11-25 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Querying EVS Disks (Deprecated)

Function

This API is used to query all EVS disks. This API has been deprecated. Use another API.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, no identity policy-based permission required for calling this API.

URI

GET /v2/{project_id}/cloudvolumes

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

The project ID.
Table 2 Query Parameters

Parameter

Mandatory

Type

Description

marker

No

String

The ID of the last record on the previous page. The returned value is the value of the item after this one. The ID of the last record on the previous page. The returned value is the value of the item after this one.

name

No

String

The disk name.

status

No

String

The disk status. For details, see EVS Disk Status.

limit

No

Integer

The maximum number of query results that can be returned. The default value is 1000.

availability_zone

No

String

The AZ information.

sort_key

No

String

Definition

The keyword based on which the returned results are sorted.

Constraints

N/A

Range

  • id: The disk ID.

  • status: The disk status. To obtain the disk ID, see ["EVS Disk Status"].

  • created_at: The time when the disk was created.

-size: The disk capacity, in GiB.

Default Value

created_at

sort_dir

No

String

The result sorting order. The value can be desc (descending order) or asc (ascending order), and the default value is desc.

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

A token obtained from IAM is valid for 24 hours. When using a token for authentication, cache it to avoid frequently calling the API.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

volumes

Array of DiskSummary objects

The list of returned disks.
Table 5 DiskSummary

Parameter

Type

Description

id

String

The disk ID.

links

Array of Link objects

The disk URI.

name

String

The disk name. You can enter up to 85 characters.
Table 6 Link

Parameter

Type

Description

href

String

Definition

The corresponding shortcut link.

Range

N/A

rel

String

Definition

The shortcut link marker name.

Range

N/A

Status code: 400

Table 7 Response body parameters

Parameter

Type

Description

error

Error object

Definition

The error code returned if an error occurs. For details about the error code, see Error Codes.

Range

N/A
Table 8 Error

Parameter

Type

Description

code

String

Definition

The error code returned if an error occurs.

Range

For details about the error code, see Error Codes.

message

String

Definition

The error message returned if an error occurs.

Range

N/A

Example Requests

None

Example Responses

Status code: 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"
  } ]
}

Status code: 400

Bad Request

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

Status Codes

Status Code

Description

200

OK

400

Bad Request

Error Codes

See Error Codes.

Parent topic: Disk Management