Consulta de detalles sobre todos los discos de EVS (obsoletos)
Función
Esta API se utiliza para consultar detalles sobre todos los discos de EVS. Nota: 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/detail
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
project_id |
Sí |
String |
El ID del proyecto. |
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
availability_zone |
No |
String |
La información de zona de disponibilidad. |
|
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 |
Los ID del disco. El valor está en formato ids=['id1','id2',...,'idx']. En la respuesta, el valor ids solo contiene los ID de disco válidos. Se ignoran los ID de disco no válidos. Se pueden consultar los detalles sobre un máximo de 60 discos. Si se especifican tanto id como ids en la solicitud, se omitirá id. |
|
limit |
No |
Integer |
El número máximo de resultados de consulta que se pueden devolver. El valor debe ser un 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 se puede compartir. |
|
name |
No |
String |
El nombre del disco. |
|
offset |
No |
Integer |
El desplazamiento de la consulta. Se consultan todos los discos después de este desplazamiento. El valor debe ser un entero mayor que 0 pero menor que el número de discos. |
|
service_type |
No |
String |
El tipo de servicio. EVS, DSS y DESS son servicios soportados. |
|
sort_dir |
No |
String |
El orden de clasificación del resultado. El valor puede ser desc (en orden descendente) o asc (en orden ascendente) y el valor predeterminado es desc. |
|
sort_key |
No |
String |
La palabra clave en función de la cual se ordenan los resultados devueltos. El valor puede ser id, status, size, o created_at, y el valor predeterminado es created_at. |
|
status |
No |
String |
El estado del disco. |
|
volume_type_id |
No |
String |
El ID de tipo de 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 |
|---|---|---|
|
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 la consulta en la lista de discos. Si solo se devuelven algunos discos en esta consulta, se devuelve la dirección URL del último disco consultado. Puede utilizar esta dirección URL para continuar consultando los discos restantes en la siguiente consulta. |
|
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 |
Object |
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 |
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 |
|---|---|---|
|
__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.
|
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
href |
String |
El enlace de acceso directo correspondiente. |
|
rel |
String |
El nombre del marcador de enlace de acceso directo. |
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/detail
https://{endpoint}/v2/{project_id}/os-vendor-volumes/detail
Ejemplo de respuestas
Código de estado: 200
Aceptar
{
"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
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.
