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 la papelera de reciclaje/ Consulta de detalles sobre todos los discos de EVS en la papelera de reciclaje
Actualización más reciente 2026-04-23 GMT+08:00

Consulta de detalles sobre todos los discos de EVS en la papelera de reciclaje

Función

Esta API se utiliza para consultar detalles sobre todos los discos de EVS en la papelera de reciclaje.

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 /v3/{project_id}/recycle-bin-volumes/detail

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

Definición

El ID del proyecto. Para obtener más información, consulte Obtención de un ID de proyecto.

Restricciones

N/D

Rango

N/D

Valor predeterminado

N/D

Tabla 2 Parámetros de consulta

Parámetro

Obligatorio

Tipo

Descripción

name

No

String

Definición

El nombre del disco.

Puede invocar la API Consulta de detalles sobre todos los discos de EVS para obtener el nombre del disco.

Restricciones

Puede contener un máximo de 64 caracteres.

Rango

N/D

Valor predeterminado

N/D

status

No

String

Definición

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

Restricciones

N/D

Rango

N/D

Valor predeterminado

N/D

limit

No

Integer

Definición

Cantidad máxima de resultados de consultas que se pueden devolver.

Restricciones

N/D

Rango

1–1000

Valor predeterminado

1000

availability_zone

No

String

Definición

La información de AZ.

Puede invocar la API Consulta de todas las zonas de disponibilidad o consultar Regiones y puntos de conexión para obtener la información de la zona de disponibilidad.

Restricciones

N/D

Rango

N/D

Valor predeterminado

N/D

service_type

No

String

Definición

El tipo de servicio.

Restricciones

N/D

Rango

  • EVS

  • DSS

Valor predeterminado

N/D

offset

No

Integer

Definición

El desplazamiento en la consulta de paginación.

Restricciones

N/D

Rango

El valor es un número entero mayor que 0, pero menor que el número total de discos.

Valor predeterminado

0

Parámetros de solicitud

Tabla 3 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

String

Definición

El token de usuario.

Puede obtenerlo invocando la API de IAM para obtener un token de usuario. El token es el valor de X-Subject-Token en el encabezado de respuesta.

Restricciones

N/D

Rango

N/D

Valor predeterminado

N/D

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

count

Integer

Definición

El número total de discos.

Rango

N/D

volumes

Array of recycleBinVolume objects

Definición

La lista de discos.

Rango

N/D

Tabla 5 recycleBinVolume

Parámetro

Tipo

Descripción

id

String

Definición

El ID del disco.

Rango

N/D

name

String

Definición

El nombre del disco.

Rango

N/D

description

String

Definición

La descripción del disco.

Rango

N/D

status

String

Definición

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

Rango

N/D

attachments

Array of Attachment objects

Definición

La información de la conexión del disco.

Rango

N/D

multiattach

String

Definición

Si el disco es compartible.

Rango

  • true: disco compartido

  • false: disco no compartido

size

Integer

Definición

La capacidad del disco, en GiB.

Rango

N/D

metadata

Map<String,Object>

Definición

La información de metadatos del disco. Los invocadores pueden agregar o eliminar la información de metadatos.

Rango

Las claves de este parámetro utilizadas en EVS se describen a continuación:

  • __system__cmkid

    El ID del CMK de encriptación en metadata. Este parámetro se utiliza junto con __system__encrypted para la encriptación. La longitud de cmkid se fija en 36 bytes.

    Para obtener detalles sobre cómo obtener el ID de clave, véase Consulta de la lista de claves.

  • __system__encrypted

    El campo de encriptación en metadata. El valor puede ser 0 (sin encriptación) o 1 (encriptación).

    Si este parámetro no se especifica, el atributo de encriptación del disco es el mismo que el del origen de datos. Si el disco no se crea a partir de un origen de datos, el disco no se cifra de forma predeterminada.

  • hw:passthrough

    • Si el valor de este parámetro es true, el tipo de dispositivo de disco es SCSI, lo que permite que los SO de ECS accedan directamente al medio de almacenamiento subyacente y admitan comandos de reserva SCSI.

    • Si el valor de este parámetro es false, el tipo de dispositivo de disco es VBD (tipo de dispositivo predeterminado), que solo admite comandos simples de lectura/escritura SCSI.

    • Si no se especifica este parámetro, el tipo de dispositivo de disco es VBD.

bootable

String

Definición

Si el disco es arrancable.

Rango

  • true: El disco es arrancable.

  • false: El disco no es arrancable.

tags

Map<String,String>

Definición

Las etiquetas del disco.

Rango

N/D

availability_zone

String

Definición

La AZ a la que pertenece el disco.

Rango

N/D

created_at

String

Definición

La hora en que se creó el disco.

Rango

Formato de tiempo: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX

service_type

String

Definición

El servicio al que pertenece el disco.

Rango

  • EVS

  • DSS

updated_at

String

Definición

La hora en que se actualizó la información del disco.

Rango

Formato de tiempo: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX

volume_type

String

Definición

El tipo de disco.

Rango

El valor puede ser SATA, SAS, GPSSD, SSD, ESSD o GPSSD2.

  • SATA: el tipo de E/S común (fin de venta)

  • SAS: el tipo de E/S alta

  • GPSSD: el tipo de SSD de uso general

  • SSD: el tipo de E/S ultraalta

  • ESSD: el tipo de SSD de capacidad extrema

  • GPSSD2: el tipo de SSD V2 de uso general

enterprise_project_id

String

Definición

El ID del proyecto empresarial.

Rango

N/D

plan_delete_at

String

Definición

La hora a la que un disco eliminado se removerá de forma permanente de la papelera de reciclaje.

Rango

Formato de tiempo: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX

pre_deleted_at

String

Definición

La hora a la que un disco se movió a la papelera de reciclaje.

Rango

Formato de tiempo: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX

dedicated_storage_id

String

Definición

El ID del grupo de almacenamiento dedicado que aloja el disco.

Rango

N/D

dedicated_storage_name

String

Definición

El nombre del grupo de almacenamiento dedicado que aloja el disco.

Rango

N/D

volume_image_metadata

String

Definición

Los metadatos de la imagen del disco.

Para obtener más información sobre el campo volume_image_metadata, consulte Consulta de detalles de imágenes (API nativa de OpenStack).

Rango

N/D

wwn

String

Definición

El identificador único del disco.

Rango

N/D

Tabla 6 Attachment

Parámetro

Tipo

Descripción

attached_at

String

Definición

La hora en que se conectó el disco.

Rango

Formato de tiempo: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX

attachment_id

String

Definición

El ID del adjunto.

Rango

N/D

device

String

Definición

El nombre del dispositivo.

Rango

N/D

host_name

String

Definición

El nombre del host físico que aloja el servidor en la nube al que está conectado el disco.

Rango

N/D

id

String

Definición

El ID del disco conectado.

Rango

N/D

server_id

String

Definición

El ID del servidor al que está conectado el disco.

Rango

N/D

volume_id

String

Definición

El ID del disco.

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

GET https://evs.cn-north-1.myhuaweicloud.com/v3/490e121341fc481d95f946ef844cb06a/recycle-bin-volumes/detail

Ejemplos de respuestas

Código de estado: 200

OK

{
  "count" : 1,
  "volumes" : [ {
    "id" : "0482c74b-1f85-4bc9-868c-64caecc16b61",
    "name" : "test",
    "status" : "restorable",
    "multiattach" : false,
    "size" : 89,
    "metadata" : { },
    "bootable" : "false",
    "tags" : { },
    "availability_zone" : "az1.dc1",
    "created_at" : "2018-12-11T07:25:15.531000",
    "volume_type" : "SATA",
    "volume_image_metadata" : { },
    "updated_at" : "2019-01-12T18:01:50.851000",
    "service_type" : "EVS",
    "enterprise_project_id" : "0",
    "plan_delete_at" : "2019-01-18T22:31:58.642000",
    "pre_deleted_at" : "2019-01-11T22:31:58.642000"
  } ]
}

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.