Consulta de detalles sobre un disco de EVS (obsoleto)
Función
Esta API se utiliza para consultar detalles sobre un singular disco de EVS.
Método de invocación
Para obtener más información, consulte Invocación a las API.
URI
GET /v3/{project_id}/os-vendor-volumes/{volume_id}
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
String |
El ID del proyecto. Para obtener más información sobre cómo obtener el ID de proyecto, consulte Obtención de un ID de proyecto. |
volume_id |
Sí |
String |
El ID del disco. |
Parámetros 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 autenticación, guarde un caché para evitar invocar con frecuencia a la API. |
Parámetros de respuesta
Código de estado: 200
Parámetro |
Tipo |
Descripción |
---|---|---|
volume |
VolumeDetailV3 object |
La información del disco devuelto. Para obtener más detalles, consulte Parámetros en el campo volume. |
Parámetro |
Tipo |
Descripción |
---|---|---|
attachments |
Array of AttachmentV3 objects |
La información de conexión de disco. Para más detalles, consulte |
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 se puede arrancar. |
consistencygroup_id |
String |
El campo reservado. |
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 |
Este campo no se admite actualmente. |
enterprise_project_id |
String |
El ID del proyecto de empresa 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 |
id |
String |
El ID del disco. |
links |
Array of LinkV3 objects |
El URI del disco. Para más detalles, consulte |
metadata |
VolumeMetadataV3 object |
Los metadatos. |
multiattach |
Boolean |
Si el disco se puede compartir. true: el disco se puede compartir. false: el disco no se puede compartir. |
name |
String |
El nombre del disco. |
replication_status |
String |
El campo reservado. |
service_type |
String |
El tipo de servicio. EVS, DSS y DESS son servicios soportados. |
shareable |
Boolean |
Si el disco se puede compartir.
NOTA:
Este campo ha sido obsoleto. Use 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. Este campo no se admite actualmente. |
status |
String |
El estado del disco. |
tags |
Map<String,String> |
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. Formato de hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX |
user_id |
String |
El campo reservado. |
volume_image_metadata |
Object |
Los metadatos de la imagen de disco.
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.
|
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. |
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 |
El 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. |
Parámetro |
Tipo |
Descripción |
---|---|---|
href |
String |
El enlace de acceso directo correspondiente. |
rel |
String |
El nombre del marcador de enlace de acceso directo. Valor predeterminado: next |
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. 0: sin encriptación 1: encriptación Si este parámetro no aparece, el disco no está encriptado. |
full_clone |
String |
El método de creación cuando el disco se crea a partir de una instantánea.
|
hw:passthrough |
String |
El parámetro que describe el tipo de dispositivo de disco de metadata.
|
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
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. |
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}/v3/{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/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
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.