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}
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
String |
El ID del 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 |
DiskDetail object |
Los detalles del disco. |
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.
|
wwn |
String |
El identificador único utilizado al conectar el disco. |
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. |
Parámetro |
Tipo |
Descripción |
---|---|---|
href |
String |
El enlace de acceso directo correspondiente. |
rel |
String |
El nombre del marcador de enlace de acceso directo. |
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.
|
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}/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.