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 detalles sobre todos los discos de EVS (obsoleto)

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

Ver PDF

Consulta de detalles sobre todos los discos de EVS (obsoleto)

Función

Esta API se utiliza para consultar detalles sobre todos los discos de EVS.

Nota:

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

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.

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}/os-vendor-volumes/detail

**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
availability_zone	No	String	La información de AZ.
dedicated_storage_id	No	String	El ID del grupo de almacenamiento dedicado. Todos los discos del grupo de almacenamiento dedicado se pueden filtrar por la coincidencia exacta.
dedicated_storage_name	No	String	El nombre del grupo de almacenamiento dedicado. Todos los discos del grupo de almacenamiento dedicado se pueden filtrar por coincidencia difusa.
id	No	String	El ID del disco.
ids	No	Array of strings	Los ID de discos. El valor está en formato ids=['id1','id2',...,'idx']. En la respuesta, el valor ids solo contiene los ID de disco válidos. Los ID de disco no válidos se ignoran. Puede consultar detalles sobre hasta 60 discos. Si se especifican tanto id como ids en la solicitud, id se ignorará.
limit	No	Integer	Cantidad máxima de resultados de consultas que se pueden devolver. El valor debe ser un número entero mayor que 0. El valor predeterminado es 1000.
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.
metadata	No	String	Los metadatos del disco.
multiattach	No	Boolean	Si el disco es compartible.
name	No	String	El nombre del disco.
offset	No	Integer	El desplazamiento de la consulta. Se consultarán todos los discos después de este desplazamiento. El valor debe ser un número entero mayor que 0 pero menor que la cantidad total de discos.
service_type	No	String	Definición El tipo de servicio. Restricciones N/D Rango EVS DSS DESS Valor predeterminado N/D
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.
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
status	No	String	El estado del disco. Para obtener más información, consulte Estado del disco de EVS.
volume_type_id	No	String	El ID del tipo de disco.
snapshot_policy_id	No	String	El ID de la política de instantáneas automáticas.

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
count	Integer	El número de discos consultados. Este valor no se ve afectado por la paginación.
volumes	Array of DiskDetail objects	La lista de discos devueltos.
volumes_links	Array of Link objects	El marcador de posición de consulta en la lista de discos. Si solo se devuelven algunos discos en esta consulta, se devuelve la URL del último disco consultado. Puede utilizar esta URL para continuar consultando los discos restantes en la siguiente consulta.

**Tabla 5** DiskDetail
Parámetro	Tipo	Descripción
attachments	Array of DiskAttachment objects	La información de conexión del disco.
availability_zone	String	La AZ a la que pertenece el disco.
bootable	String	Si el disco es arrancable.
consistencygroup_id	String	El ID del grupo de consistencia al que pertenece el disco.
count	String	La cantidad de discos consultados.
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	Si el disco está encriptado.
enterprise_project_id	String	El ID del proyecto empresarial al que se ha agregado el disco. Actualmente, este campo no se admite.
id	String	El ID del disco.
links	Array of Link objects	El URI del disco.
metadata	DiskMetadata object	Los metadatos.
multiattach	Boolean	Si el disco es compartible.
name	String	El nombre del disco.
os-vendor-extended:lock_check_endpoint	String	La URL de retorno utilizada para comprobar la validez del bloqueo.
os-vendor-extended:lock_scene	String	La operación o el servicio que bloquea el disco. El valor puede ser: TO_PERIOD_LOCK: cambio de pago por uso a anual/mensual SPEC_CHG_LOCK: modificación de especificaciones OTHER_SVC_LOCK: otros escenarios
os-vendor-extended:lock_source_id	String	El ID del recurso al que pertenece el bloqueo.
os-vendor-extended:lock_source_service	String	El tipo de recurso al que pertenece el bloqueo.
os-vol-host-attr:host	String	El host al que pertenece el disco.
os-vol-mig-status-attr:migstat	String	El campo reservado.
os-vol-mig-status-attr:name_id	String	El campo reservado.
os-vol-tenant-attr:tenant_id	String	El ID del tenant al que pertenece el disco.
os-volume-replication:driver_data	String	El campo reservado.
os-volume-replication:extended_status	String	El campo reservado.
replication_status	String	El campo reservado.
service_type	String	Definición El tipo de servicio. Restricciones N/D Rango EVS DSS DESS Valor predeterminado N/D
shareable	String	Si el disco es compartible.
size	Integer	El tamaño del disco.
snapshot_id	String	El ID de la instantánea.
source_volid	String	El ID del disco de origen.
status	String	El estado del disco. Para obtener más información, consulte Estado del disco de EVS.
tags	Object	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.
user_id	String	El campo reservado.
volume_image_metadata	Object	Los metadatos de la imagen. Este campo tiene un valor si el disco se crea a partir de una imagen. O bien, se devuelve null. 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.
root_resource_type	String	El tipo de recurso raíz.
root_resource_id	String	El ID del recurso raíz.
parent_resource_type	String	El tipo de recurso principal.
parent_resource_id	String	El ID del recurso principal.

**Tabla 6** DiskAttachment
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	El ID del adjunto.
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 7** DiskMetadata
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. El valor puede ser 0 (sin encriptación) o 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. Se admiten los 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.

**Tabla 8** 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 9** 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 10** 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}/v2/{project_id}/os-vendor-volumes/detail

https://{endpoint}/v2/{project_id}/os-vendor-volumes/detail

Ejemplos de respuestas

Código de estado: 200

{
  "count" : 1,
  "volumes" : [ {
    "attachments" : [ ],
    "availability_zone" : "xxx",
    "bootable" : "false",
    "created_at" : "2016-05-25T02:42:10.856332",
    "encrypted" : false,
    "id" : "b104b8db-170d-441b-897a-3c8ba9c5a214",
    "links" : [ {
      "href" : "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/b104b8db-170d-441b-897a-3c8ba9c5a214",
      "rel" : "self"
    }, {
      "href" : "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/b104b8db-170d-441b-897a-3c8ba9c5a214",
      "rel" : "bookmark"
    } ],
    "metadata" : {
      "__openstack_region_name" : "pod01.xxx",
      "a" : "b",
      "quantityGB" : "1",
      "volInfoUrl" : "fusionstorage://172.30.64.10/0/FEFEEB07D3924CDEA93C612D4E16882D"
    },
    "name" : "zjb_u25_test",
    "os-vol-host-attr:host" : "pod01.xxx#SATA",
    "volume_image_metadata" : { },
    "os-vol-tenant-attr:tenant_id" : "dd14c6ac581f40059e27f5320b60bf2f",
    "replication_status" : "disabled",
    "multiattach" : false,
    "size" : 1,
    "status" : "available",
    "updated_at" : "2016-05-25T02:42:22.341984",
    "user_id" : "b0524e8342084ef5b74f158f78fc3049",
    "volume_type" : "SATA",
    "service_type" : "EVS",
    "wwn" : " 688860300000d136fa16f48f05992360"
  } ],
  "volumes_links" : [ {
    "href" : "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/detail?limit=1&marker=b104b8db-170d-441b-897a-3c8ba9c5a214",
    "rel" : "next"
  } ]
}

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: Ampliación de la capacidad de un disco de EVS (obsoleto)

Tema siguiente: Consulta de detalles sobre un disco de EVS (obsoleto)

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.