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.
Actualización más reciente 2022-11-04 GMT+08:00

Consulta de discos EVS (obsoletos)

Función

Esta API se utiliza para consultar discos EVS y mostrar los resultados de la consulta en una lista.

Esta API ha sido obsoleta. Usa otra API. Para más detalles, consulte Consulta de discos EVS.

URI

  • Formato URI

    GET /v2/{project_id}/cloudvolumes

  • Descripción del parámetro

    Parámetro

    Obligatorio

    Descripción

    project_id

    Especifica el ID del proyecto.

    Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.

  • Parámetros de filtro de solicitud

    Parámetro

    Tipo

    Obligatorio

    Descripción

    marker

    String

    No

      

    name

    String

    No

    Especifica el nombre del disco.

    status

    String

    No

    Especifica el estado del disco. Para más detalles, consulte Estado de disco EVS.

    limit

    Integer

    No

    Especifica el número máximo de resultados de consulta que se pueden devolver.

    availability_zone

    String

    No

    Especifica la AZ.

    sort_key

    String

    No

    Especifica la palabra clave en función de la cual se ordenan los resultados devueltos. El valor puede ser id, status, size, o created_at, y el valor predeterminado es created_at.

    sort_dir

    String

    No

    Especifica el orden de clasificación del resultado. El valor predeterminado es desc.
    • desc: indica el orden descendente.
    • asc: indica el orden ascendente.

Solicitud

En el ejemplo siguiente se muestra cómo consultar los discos en el estado available.
  • Solicitud de ejemplo
    GET https://{endpoint}/v2/{project_id}/cloudvolumes?status=available

Respuesta

  • Descripción del parámetro

    Parámetro

    Tipo

    Descripción

    volumes

    Array of objects

    Especifica la lista de discos consultados. Para obtener más información, consulte Parámetros en el campo volumes.

    error

    Object

    Especifica el mensaje de error devuelto cuando se produce un error. Para obtener más información, consulte Parámetros en el campo de error.

  • Parámetros en el campo volumes

    Parámetro

    Tipo

    Descripción

    id

    String

      

    links

    Array of objects

    Especifica el URI del disco. Para obtener más información, consulte Parámetros en el campo Enlaces.

    name

    String

    Especifica el nombre del disco.

  • Parámetros en el campo links

    Parámetro

    Tipo

    Descripción

    href

    String

    Especifica el enlace de acceso directo correspondiente.

    rel

    String

    Especifica el nombre del marcador de enlace de acceso directo.

  • Parámetros en el campo de error

    Parámetro

    Tipo

    Descripción

    message

    String

    Especifica el mensaje de error devuelto cuando se produce un error.

    code

    String

    Especifica el código de error devuelto cuando se produce un error.

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

  • Ejemplo de respuesta
    {
        "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"
            }
        ]
    }

    o

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

Códigos de estado

  • Normal

    200

Códigos de error

Para más detalles, consulte Códigos de error.