Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Elastic Volume Service/ Referencia de la API/ API/ Gestión de discos/ Consulta de discos de EVS (obsoleto)
Actualización más reciente 2026-04-23 GMT+08:00
Ver PDF
Compartir

Consulta de discos de EVS (obsoleto)

Función

Esta API se utiliza para consultar todos los discos de EVS. Esta API ha sido obsoleta. Utilice otra API.

Método de invocación

Para obtener más información, consulte Invocación de las API.

Información de autorización

Cada cuenta tiene todos los permisos necesarios para invocar todas las API, pero los usuarios de IAM deben tener asignados los permisos requeridos.

  • Si está utilizando la autorización basada en roles/políticas, consulte Políticas de permisos y acciones admitidas para obtener más información sobre los permisos requeridos.
  • Si está utilizando la autorización basada en políticas de identidad, no se requiere ningún permiso basado en políticas de identidad para invocar esta API.

URI

GET /v2/{project_id}/cloudvolumes

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

El ID del proyecto.
Tabla 2 Parámetros de consulta

Parámetro

Obligatorio

Tipo

Descripción

marker

No

String

El ID del último registro de la página anterior. El valor devuelto es el valor del elemento después de este. El ID del último registro de la página anterior. El valor devuelto es el valor del elemento después de este.

name

No

String

El nombre del disco.

status

No

String

El estado del disco. Para obtener más información, consulte Estado del disco de EVS.

limit

No

Integer

Cantidad máxima de resultados de consultas que se pueden devolver. El valor predeterminado es 1000.

availability_zone

No

String

La información de AZ.

sort_key

No

String

Definición

La palabra clave en función de la cual se ordenan los resultados devueltos.

Restricciones

N/D

Rango

  • id: El ID del disco.

  • status: El estado del disco. Para obtener el ID del disco, consulte ["Estado del disco de EVS"].

  • created_at: La hora en que se creó el disco.

-size: La capacidad del disco, en GiB.

Valor predeterminado

created_at

sort_dir

No

String

El orden de clasificación de resultados. El valor puede ser desc (orden descendente) o asc (orden ascendente), y el valor predeterminado es desc.

Parámetros de solicitud

Tabla 3 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Un token obtenido de IAM tiene una validez de 24 horas. Cuando utilice un token para la autenticación, almacénelo en memoria caché para evitar invocar frecuentemente la API.

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

volumes

Array of DiskSummary objects

La lista de discos devueltos.
Tabla 5 DiskSummary

Parámetro

Tipo

Descripción

id

String

El ID del disco.

links

Array of Link objects

El URI del disco.

name

String

El nombre del disco. Puede ingresar hasta 85 caracteres.
Tabla 6 Link

Parámetro

Tipo

Descripción

href

String

Definición

El enlace de acceso directo correspondiente.

Rango

N/D

rel

String

Definición

El nombre del marcador del enlace de acceso directo.

Rango

N/D

Código de estado: 400

Tabla 7 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error

Error object

Definición

El código de error devuelto si se produce un error. Para obtener más información sobre el código de error, consulte Códigos de error.

Rango

N/D
Tabla 8 Error

Parámetro

Tipo

Descripción

code

String

Definición

El código de error devuelto si se produce un error.

Rango

Para obtener más información sobre el código de error, consulte Códigos de error.

message

String

Definición

El mensaje de error devuelto si se produce un error.

Rango

N/D

Ejemplos de solicitudes

Ninguno

Ejemplos de respuestas

Código de estado: 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"
  } ]
}

Código de estado: 400

Bad Request

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

Códigos de estado

Código de estado

Descripción

200

OK

400

Bad Request

Códigos de error

Consulte Códigos de error.

Tema principal: Gestión de discos