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/ Las API obsoletas/ API/ Gestión de discos/ Consulta de detalles sobre un disco de EVS (obsoleto)

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

Ver PDF

Consulta de detalles sobre un disco de EVS (obsoleto)

Función

Esta API se utiliza para consultar detalles sobre un solo disco de EVS.

Método de invocación

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

URI

GET /v3/{project_id}/os-vendor-volumes/{volume_id}

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	El ID del proyecto. Para obtener más información, consulte Obtención de un ID de proyecto.
volume_id	Sí	String	El ID del disco.

Parámetros de solicitud

**Tabla 2** 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 3** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
volume	VolumeDetailV3 object	La información del disco devuelto. Para obtener más información, consulte Parámetros en el campo volume.

**Tabla 4** VolumeDetailV3
Parámetro	Tipo	Descripción
attachments	Array of AttachmentV3 objects	La información de conexión del disco. Para obtener más detalles, consulte la sección Parámetros en el campo attachments.
availability_zone	String	La AZ a la que pertenece el disco.
bootable	String	Si el disco es arrancable. true: El disco es arrancable. false: El disco no es arrancable.
consistencygroup_id	String	El campo reservado.
created_at	String	La hora en que se creó el disco. Formato de tiempo: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX
dedicated_storage_id	String	El ID del grupo de almacenamiento dedicado que aloja el disco.
dedicated_storage_name	String	El nombre del grupo de almacenamiento dedicado que aloja el disco.
description	String	La descripción del disco.
encrypted	Boolean	Actualmente, este campo no se admite.
enterprise_project_id	String	El ID del proyecto empresarial al que se ha agregado el disco. Para obtener más información sobre proyectos empresariales y cómo obtener identificadores de proyectos empresariales, consulte Guía del usuario de Enterprise Management.
id	String	El ID del disco.
links	Array of LinkV3 objects	El URI del disco. Para obtener más detalles, consulte la sección •Parámetros en el campo links.
metadata	VolumeMetadataV3 object	Los metadatos.
multiattach	Boolean	Si el disco es compartible. true: disco compartido false: disco no compartido
name	String	El nombre del disco.
replication_status	String	El campo reservado.
service_type	String	El tipo de servicio. Los servicios admitidos son EVS, DSS y DESS.
shareable	Boolean	Si el disco es compartible. NOTA: Este campo ha sido obsoleto. Utilice multiattach.
size	Integer	El tamaño del disco, en GiB.
snapshot_id	String	El ID de la instantánea. Este parámetro tiene un valor si el disco se crea a partir de una instantánea.
source_volid	String	El ID del disco de origen. Este parámetro tiene un valor si el disco se crea a partir de un disco de origen. Actualmente, este campo no se admite.
status	String	El estado del disco. Para obtener más información, consulte Estado del disco de EVS.
tags	Map<String,String>	Las etiquetas del disco. Este campo tiene valores si el disco tiene etiquetas. O bien, se deja vacío.
updated_at	String	La hora en que se actualizó el disco. Formato de tiempo: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX
user_id	String	El campo reservado.
volume_image_metadata	Object	Los metadatos de la imagen del disco. NOTA: Para obtener más información sobre el campo volume_image_metadata, consulte Consulta de detalles de imágenes (API nativa de OpenStack).
volume_type	String	El tipo de disco. El valor puede ser SATA, SAS, GPSSD o SSD. SATA: el tipo de E/S común SAS: el tipo de E/S alta GPSSD: el tipo de SSD de uso general SSD: el tipo de E/S ultraalta
wwn	String	El identificador único utilizado al conectar el disco.
os-vol-tenant-attr:tenant_id	String	El ID del tenant al que pertenece el disco. El ID del tenant es el mismo que el ID del proyecto.
os-vol-mig-status-attr:migstat	String	El campo reservado.
os-vol-mig-status-attr:name_id	String	El campo reservado.
os-volume-replication:extended_status	String	El campo reservado.
os-vol-host-attr:host	String	El campo reservado.
storage_cluster_id	String	El campo reservado.

**Tabla 5** AttachmentV3
Parámetro	Tipo	Descripción
attached_at	String	La hora en que se conectó el disco. Formato de tiempo: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX
attachment_id	String	The attachment ID.
device	String	El nombre del dispositivo.
host_name	String	El nombre del host físico que aloja el servidor en la nube al que está conectado el disco.
id	String	El ID del disco conectado.
server_id	String	El ID del servidor al que está conectado el disco.
volume_id	String	El ID del disco.

**Tabla 6** LinkV3
Parámetro	Tipo	Descripción
href	String	El enlace de acceso directo correspondiente.
rel	String	El nombre del marcador del enlace de acceso directo.

**Tabla 7** VolumeMetadataV3
Parámetro	Tipo	Descripción
__system__cmkid	String	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.
__system__encrypted	String	El campo de encriptación en metadata. 0: no encriptación 1: encriptación Si este parámetro no aparece, el disco no está encriptado.
hw:passthrough	String	El parámetro que describe el tipo de dispositivo de disco en metadata. 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, que solo admite comandos simples de lectura/escritura SCSI. Si este parámetro no aparece, el tipo de dispositivo de disco es VBD.
orderID	String	El parámetro que describe el modo de facturación de disco de metadata. Si este parámetro tiene un valor, el disco se factura anualmente/mensualmente. Si no es así, el disco se factura sobre una base de pago por uso.

Código de estado: 400

**Tabla 8** 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 9** 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://{endpoint}/v3/{project_id}/os-vendor-volumes/{volume_id}

Ejemplos de respuestas

Código de estado: 200

{
  "volume" : {
    "attachments" : [ ],
    "links" : [ {
      "href" : "https://volume.az0.dc1.domainname.com/v3/40acc331ac784f34842ba4f08ff2be48/volumes/591ac654-26d8-41be-bb77-4f90699d2d41",
      "rel" : "self"
    }, {
      "href" : "https://volume.az0.dc1.domainname.com/40acc331ac784f34842ba4f08ff2be48/volumes/591ac654-26d8-41be-bb77-4f90699d2d41",
      "rel" : "bookmark"
    } ],
    "availability_zone" : "az-dc-1",
    "os-vol-host-attr:host" : "az-dc-1#SSD",
    "encrypted" : false,
    "multiattach" : true,
    "updated_at" : "2016-02-03T02:19:29.895237",
    "replication_status" : "disabled",
    "id" : "591ac654-26d8-41be-bb77-4f90699d2d41",
    "size" : 40,
    "user_id" : "fd03ee73295e45478d88e15263d2ee4e",
    "os-vol-tenant-attr:tenant_id" : "40acc331ac784f34842ba4f08ff2be48",
    "metadata" : { },
    "tags" : {
      "key1" : "value1",
      "key2" : "value2"
    },
    "enterprise_project_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635",
    "status" : "error_restoring",
    "description" : "auto-created_from_restore_from_backup",
    "name" : "restore_backup_0115efb3-678c-4a9e-bff6-d3cd278238b9",
    "bootable" : "false",
    "created_at" : "2016-02-03T02:19:11.723797",
    "service_type" : "EVS",
    "wwn" : "688860300000d136fa16f48f05992360",
    "backup_id" : "null"
  }
}

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

Tema anterior: Creación de discos de EVS (obsoleto)

Tema siguiente: Gestión de instantáneas heredadas

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.