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 un disco de EVS en la papelera de reciclaje

Actualización más reciente 2026-04-23 GMT+08:00

Ver PDF

Consulta de detalles sobre un disco de EVS en la papelera de reciclaje

Función

Esta API se utiliza para consultar detalles sobre un solo disco 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/{volume_id}

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	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
volume_id	Sí	String	Definición El ID del disco. Puede invocar la API Consulta de detalles sobre todos los discos de EVS para obtener el ID del disco. Restricciones N/D Rango N/D Valor predeterminado N/D

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	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 3** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
volume	recycleBinVolume object	Definición Los detalles del disco. Rango N/D

**Tabla 4** 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 5** 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 6** 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 7** 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/55b4c5a7-a82e-4881-9463-f8fbf8730d4f

Ejemplos de respuestas

Código de estado: 200

{
  "volume" : {
    "id" : "552f3de0-5a22-49a6-9e99-18b1e9cd6b71",
    "name" : "IaaS_Universal_Tenant_Basic_Computing_BMS_503_0",
    "status" : "restorable",
    "size" : 10,
    "metadata" : {
      "hw:passthrough" : "true",
      "readonly" : "False"
    },
    "bootable" : "false",
    "tags" : { },
    "wwn" : "6888603000026e18fa16988434130925",
    "availability_zone" : "AZ2",
    "created_at" : "2019-01-15T01:48:07.432000",
    "volume_type" : "SATA",
    "multiattach" : false,
    "updated_at" : "2019-01-15T01:54:35.369000",
    "service_type" : "EVS",
    "volume_image_metadata" : { },
    "enterprise_project_id" : "0",
    "plan_delete_at" : "2019-01-22T01:54:30.255000",
    "pre_deleted_at" : "2019-01-15T01:54:30.255000"
  }
}

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 la papelera de reciclaje

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

Tema siguiente: Eliminación de un disco de la papelera de reciclaje

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.