Exportación de datos de disco de EVS como imagen
Función
Esta API se utiliza para exportar datos de un sistema o disco de datos como una imagen de IMS. La imagen exportada se mostrará en la lista de imágenes privadas de IMS y se podrá ver y utilizar.
Restricciones
La capacidad del disco debe ser menor o igual a 1 TiB.
Método de invocación
Para obtener más información, consulte Invocación a las API.
URI
POST /v2/{project_id}/volumes/{volume_id}/action
|
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 |
El token del usuario. Se puede obtener invocando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario. |
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
os-volume_upload_image |
Sí |
CinderExportToImageOption object |
Marcador de operación de exportación de imagen. |
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
container_format |
No |
String |
Tipo de contenedor de la imagen exportada. El valor puede ser ami, ari, aki, ovf, o bare. El valor predeterminado es bare. Valor predeterminado: bare Valores de enumeración:
|
|
disk_format |
No |
String |
El formato de la imagen exportada. El valor puede ser vhd, zvhd, zvhd2, raw, o qcow2. El valor predeterminado es vhd. Predeterminado: vhd Valores de enumeración:
|
|
force |
No |
Boolean |
Si la imagen puede exportarse forzosamente. El valor predeterminado es false. Si el valor de este parámetro es false, no se podrán exportar imágenes forzosamente cuando el estado del disco sea in-use. Si el valor de este parámetro es true, las imágenes pueden exportarse forzosamente aunque el estado del disco sea in-use. |
|
image_name |
Sí |
String |
El nombre de la imagen exportada. Puede contener de 1 a 128 caracteres. Puede contener letras, dígitos, guiones (-), puntos (.), guiones bajos (_) y espacios. |
|
__os_type |
No |
String |
Tipo de sistema operativo de la imagen que se va a exportar. Solo se soportan windows y linux. El valor predeterminado es linux. Esta configuración de parámetro solo tiene efecto cuando el campo __os_type no está incluido en volume_image_metadata y el estado del disco está available. Si no se especifica este parámetro, se utiliza el valor predeterminado linux. Valor predeterminado: linux Valores de enumeración:
|
Parámetros de respuesta
Código de estado: 202
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
os-volume_upload_image |
Image object |
Marcador de operación de exportación de imagen. |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
container_format |
String |
Tipo de contenedor de la imagen exportada. El valor puede ser ami, ari, aki, ovf, o bare. El valor predeterminado es bare. |
|
disk_format |
String |
El formato de la imagen exportada. El valor puede ser vhd, zvhd, zvhd2, raw, o qcow2. El valor predeterminado es vhd. |
|
display_description |
String |
La descripción del disco. |
|
id |
String |
El ID del disco. |
|
image_id |
String |
El ID de la imagen exportada. |
|
image_name |
String |
El nombre de la imagen exportada. |
|
size |
Integer |
La capacidad del disco. |
|
status |
String |
El estado del disco después de exportar la imagen. El valor correcto está uploading. |
|
updated_at |
String |
La hora en que se actualizó el disco. Formato de hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX |
|
volume_type |
VolumeType object |
El tipo de disco. |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
id |
String |
El ID de tipo de disco. |
|
name |
String |
El nombre del tipo de disco. |
|
extra_specs |
VolumeTypeExtraSpecs object |
La variante del tipo de disco. |
|
description |
String |
La descripción del tipo de disco. |
|
qos_specs_id |
String |
El campo reservado. |
|
is_public |
Boolean |
El campo reservado. |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
RESKEY:availability_zones |
String |
La lista de las AZ donde se soporta el tipo de disco. Los elementos de la lista están separados por comas (,). Si no se especifica este parámetro, todas las AZ admiten el tipo de disco. |
|
availability-zone |
String |
El campo reservado. |
|
os-vendor-extended:sold_out_availability_zones |
String |
La lista de AZ donde se agotó el tipo de disco. Los elementos de la lista están separados por comas (,). |
|
volume_backend_name |
String |
El campo reservado. |
|
HW:availability_zone |
String |
El campo reservado. |
Código de estado: 400
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
error |
Error object |
El mensaje de error devuelto si se produce un error. |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
code |
String |
El código de error devuelto si se produce un error. Para obtener más detalles sobre 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
Exportación de un disco de EVS como imagen (Si el tipo de contenedor de la imagen exportada es desnudo, el formato de la imagen exportada es VHD, el tipo de SO de la imagen exportada es Linux y el disco de EVS está en estado de uso, puede exportar la imagen forzosamente.)
POST https://{endpoint}/v2/{project_id}/volumes/{volume_id}/action
{
"os-volume_upload_image" : {
"image_name" : "sxmatch2",
"force" : true,
"container_format" : "bare",
"disk_format" : "vhd",
"__os_type" : "linux"
}
}
Ejemplo de respuestas
Código de estado: 202
Aceptado
{
"os-volume_upload_image" : {
"status" : "uploading",
"size" : 40,
"id" : "16369c5d-384d-4e64-b37a-56d898769362",
"image_id" : "c5333daa-fbc8-4d1d-bf79-b0567bb45d15",
"image_name" : "evs-ims-test1027",
"volume_type" : {
"description" : "None",
"deleted" : false,
"created_at" : "2015-05-24T14:47:22.132268",
"updated_at" : "2017-07-29T11:29:33.730076",
"extra_specs" : {
"volume_backend_name" : "<or> FusionStorage_SATA <or> FusionStorage_SAS <or> fusionstoragesata",
"XX:availability_zone" : "kvmxen.dc1"
},
"is_public" : true,
"id" : "8247b6ed-37f0-4c48-8ef1-f0027fb332bc",
"name" : "SATA"
},
"container_format" : "bare",
"disk_format" : "vhd",
"display_description" : "",
"updated_at" : "2018-01-11T01:50:25.800931"
}
}
Código de estado: 400
Error en la solicitud
{
"error" : {
"message" : "XXXX",
"code" : "XXX"
}
}
Códigos de estado
|
Código de estado |
Descripción |
|---|---|
|
202 |
Aceptado |
|
400 |
Error en la solicitud |
Códigos de error
Consulte Códigos de error.
