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 un disco de EVS (obsoleto)
Actualización más reciente 2024-09-04 GMT+08:00

Consulta de detalles sobre un disco de EVS (obsoleto)

Función

Esta API se utiliza para consultar detalles sobre un singular disco de EVS. Esta API ha sido obsoleta. Use otra API.

Método de invocación

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

URI

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

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

El ID del proyecto.

volume_id

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

String

Un token obtenido de IAM tiene una validez de 24 horas. Cuando utilice un token para autenticación, guarde un caché para evitar invocar con frecuencia a 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

DiskDetail object

Los detalles del disco.

Tabla 4 DiskDetail

Parámetro

Tipo

Descripción

attachments

Array of DiskAttachment objects

La información de conexión de 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

El número de discos consultados.

created_at

String

La hora en que se creó el disco.

Formato de hora: 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á cifrado.

enterprise_project_id

String

El ID del proyecto de empresa al que se ha agregado el disco. Este campo no se admite actualmente.

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 se puede compartir.

name

String

El nombre del disco.

os-vendor-extended:lock_check_endpoint

String

La URL de devolución de llamada utilizada para comprobar la validez del bloqueo.

os-vendor-extended:lock_scene

String

La operación o el servicio que bloquea el disco.

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

El tipo de servicio. EVS, DSS y DESS son servicios soportados.

shareable

String

Si el disco se puede compartir.

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 detalles, consulte Estado del disco de EVS.

tags

Object

Las etiquetas de disco.

Este campo tiene valores si el disco tiene etiquetas. O, se deja vacío.

updated_at

String

La hora en que se actualizó el disco.

user_id

String

El campo reservado.

volume_image_metadata

Elemento

Los metadatos de la imagen. Este campo tiene un valor si el disco se crea a partir de una imagen. O se devuelve null.

NOTA:

Para obtener más detalles sobre el campo volume_image_metadata, véase Consulta de detalles de imagen (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.

Tabla 5 DiskAttachment

Parámetro

Tipo

Descripción

attached_at

String

La hora a la que se ha conectado el disco.

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

attachment_id

String

El ID del archivo adjunto.

device

String

El nombre del dispositivo.

host_name

String

Nombre del host físico que alberga 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 de CMK de encriptación de 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 de metadata. El valor puede ser 0 (sin encriptación) o 1 (encriptación). Si este parámetro no aparece, el disco no está cifrado.

full_clone

String

El método de clon. Cuando el disco se crea a partir de una instantánea, el valor 0 indica el método de clonación vinculado.

hw:passthrough

String

El parámetro que describe el tipo de dispositivo de disco de metadata.

  • Si el valor de este parámetro es true, el tipo de dispositivo de disco es SCSI, lo que permite que los sistemas operativos de ECS accedan directamente a los medios de almacenamiento subyacentes. Se admiten 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 de SCSI.

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

Código de estado: 400

Tabla 8 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error

Error object

El mensaje de error devuelto si se produce un error. Para obtener más detalles, consulte Parámetros en el campo error.

Tabla 9 Error

Parámetro

Tipo

Descripción

code

String

El código de error devuelto si se produce un error. Para conocer los códigos de error y sus significados, véase Códigos de error.

message

String

El mensaje de error devuelto si se produce un error.

Ejemplo de solicitudes

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

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

Ejemplo de respuestas

Código de estado: 200

Aceptar

{
  "volume" : {
    "attachments" : [ ],
    "links" : [ {
      "href" : "https://volume.az0.dc1.domainname.com/v2/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"
    },
    "status" : "available",
    "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"
  }
}

Código de estado: 400

Error en la solicitud

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

Códigos de estado

Código de estado

Descripción

200

Aceptar

400

Error en la solicitud

Códigos de error

Consulte Códigos de error.