Consulta de detalles sobre todos los discos
Función
Esta API se utiliza para consultar detalles sobre todos los discos.
URI
- Formato URI
- Descripción del parámetro
Parámetro
Obligatorio
Descripción
project_id
Sí
Especifica el ID del proyecto.
Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
- Parámetros de filtro de solicitud
Parámetro
Tipo
Obligatorio
Descripción
marker
String
No
name
String
No
Especifica el nombre del disco.
status
String
No
Especifica el estado del disco. Para más detalles, consulte Estado de disco EVS.
limit
Integer
No
Especifica el número máximo de resultados de consulta que se pueden devolver.
availability_zone
String
No
Especifica la AZ.
sort_key
String
No
Especifica 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.
sort_dir
String
No
Especifica el orden de clasificación del resultado. El valor predeterminado es desc.- desc: indica el orden descendente.
- asc: indica el orden ascendente.
Solicitud
- Solicitud de ejemplo
GET https://{endpoint}/v2/{project_id}/cloudvolumes/detail?status=available
Respuesta
- Descripción del parámetro
Parámetro
Tipo
Descripción
volumes
Array of objects
Especifica la lista de discos consultados. Para obtener más información, consulte Parámetros en el campo de volumes.
error
Object
Especifica el mensaje de error devuelto cuando se produce un error. Para obtener más información, consulte Parámetros en el campo de error.
- Parámetros en el campo volumes
Parámetro
Tipo
Descripción
id
String
links
Array of objects
Especifica el URI del disco. Para obtener más información, consulte Parámetros en el campo de enlaces.
name
String
Especifica el nombre del disco.
status
String
Especifica el estado del disco. Para más detalles, consulte Estado de disco EVS.
attachments
Array of objects
Especifica la información de datos adjuntos del disco. Para obtener más información, consulte Parámetros en el campo de datos adjuntos.
availability_zone
String
Especifica la zona de disponibilidad al que pertenece el disco.
source_volid
String
Especifica 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 actualmente no es compatible.
snapshot_id
String
Especifica el ID de la instantánea. Este parámetro tiene un valor si el disco se crea a partir de una instantánea.
description
String
Especifica la descripción del disco.
os-vol-tenant-attr:tenant_id
String
Especifica el ID del inquilino al que pertenece el disco.
volume_image_metadata
Object
Especifica los metadatos de la imagen de disco.
NOTA:Para obtener más información sobre volume_image_metadata, consulte Consulta de detalles de imagen (Native OpenStack API).
created_at
String
Especifica la hora a la que se creó el disco.
Formato de hora: UTC AAAA-MM-DDTHH:MM:SS.+XX.XX
volume_type
String
Especifica el tipo de disco.
Currently, the value can be SSD, GPSSD, or SAS.- SSD: specifies the ultra-high I/O disk type.
- GPSSD: specifies the general purpose SSD disk type.
- SAS: specifies the high I/O disk type.
size
Integer
Especifica el tamaño del disco, en GB.
bootable
String
Especifica si el disco es arrancable.- true: especifica un disco de arranque.
- false: especifica un disco no arrancable.
metadata
Object
Especifica los metadatos del disco. Para obtener más información, consulte Parámetros en el campo de metadatos.
Si metadata no contienen el campo hw:passthrough, el tipo de dispositivo de disco es VBD.
Si metadata no contienen el campo __system__encrypted, el disco no está cifrado.
os-vol-host-attr:host
String
shareable
String
Especifica si el disco es compartible.
NOTA:Este campo ya no se utiliza. Usa multiattach.
multiattach
Boolean
Especifica si el disco es compartible.- true: especifica un disco compartido.
- false: especifica un disco no compartido.
- Parámetros en el campo links
Parámetro
Tipo
Descripción
href
String
Especifica el enlace de acceso directo correspondiente.
rel
String
Especifica el nombre del marcador de enlace de acceso directo.
- Parámetros en el campo attachments
Parámetro
Tipo
Descripción
server_id
String
Especifica el ID del servidor al que está conectado el disco.
attachment_id
String
Especifica ID de la información de datos adjuntos.
attached_at
String
Especifica la hora a la que se ha conectado el disco.
host_name
String
Especifica el nombre del host físico que aloja el servidor al que está conectado el disco.
volume_id
String
Especifica el ID de disco.
device
String
Especifica el nombre del dispositivo.
id
String
Especifica el ID del recurso adjunto.
- Parameters in the metadata field
Parameter
Type
Description
__system__encrypted
String
Specifies the parameter that describes the encryption function in metadata. The value can be 0 or 1.- 0: indicates the disk is not encrypted.
- 1: indicates the disk is encrypted.
- If this parameter does not appear, the disk is not encrypted by default.
__system__cmkid
String
Specifies the encryption CMK ID in metadata. This parameter is used together with __system__encrypted for encryption. The length of cmkid is fixed at 36 bytes.
hw:passthrough
String
Specifies the parameter that describes the disk device type in metadata. The value can be true or false.- If this parameter is set to true, the disk device type is SCSI, which allows ECS OSs to directly access the underlying storage media and supports SCSI reservation commands.
- If this parameter is set to false, the disk device type is VBD (the default type), that is, Virtual Block Device (VBD), which supports only simple SCSI read/write commands.
- If this parameter does not appear, the disk device type is VBD.
full_clone
String
Specifies the clone method. When the disk is created from a snapshot, the parameter value is 0, indicating the linked cloning method.
orderID
String
Specifies the parameter that describes the disk billing mode in metadata.
If this parameter is specified, the disk is billed on a yearly/monthly basis. If this parameter is not specified, the disk is billed on a pay-per-use basis.
- Parámetros en el campo de error
Parámetro
Tipo
Descripción
message
String
Especifica el mensaje de error devuelto cuando se produce un error.
code
String
Especifica el código de error devuelto cuando se produce un error.
Para obtener más información sobre el código de error, consulte Códigos de error.
- Ejemplo de respuesta
{ "volumes": [ { "id": "c6ccc84e-feff-4114-ad83-42a11c0434e2", "links": [ { "href": "https://volume.az0.dc1.domainname.com/v2/9e179fd535e44f19a9dabb36deadf47e/volumes/c6ccc84e-feff-4114-ad83-42a11c0434e2", "rel": "self" }, { "href": "https://volume.az0.dc1.domainname.com/9e179fd535e44f19a9dabb36deadf47e/volumes/c6ccc84e-feff-4114-ad83-42a11c0434e2", "rel": "bookmark" } ], "name": "test_volume", "status": "available", "attachments": [ ], "description": null, "size": 100, "metadata": null, "bootable": "false", "availability_zone": "az-dc-1", "os-vol-host-attr:host": "az-dc-1#sas", "source_volid": null, "snapshot_id": null, "created_at": "2015-09-17T06:37:16.275659", "volume_type": "SAS", "os-vol-tenant-attr:tenant_id": "9e179fd535e44f19a9dabb36deadf47e", "volume_image_metadata": null }, { "id": "a05d9342-bf27-44a6-8ab8-33afc7545d19", "links": [ { "href": "https://volume.az0.dc1.domainname.com/v2/9e179fd535e44f19a9dabb36deadf47e/volumes/a05d9342-bf27-44a6-8ab8-33afc7545d19", "rel": "self" }, { "href": "https://volume.az0.dc1.domainname.com/9e179fd535e44f19a9dabb36deadf47e/volumes/a05d9342-bf27-44a6-8ab8-33afc7545d19", "rel": "bookmark" } ], "name": "test_volume", "status": "available", "attachments": [ ], "description": null, "size": 100, "metadata": null, "bootable": "false", "availability_zone": "az-dc-1", "os-vol-host-attr:host": "az-dc-1#sas", "source_volid": null, "snapshot_id": null, "created_at": "2015-09-17T06:37:16.192556", "volume_type": "SAS", "os-vol-tenant-attr:tenant_id": "9e179fd535e44f19a9dabb36deadf47e", "volume_image_metadata": null } ] }
o
{ "error": { "message": "XXXX", "code": "XXX" } }
Códigos de error
Para más detalles, consulte Códigos de error.