Exportación de una imagen
Función
Esta es una API de extensión y se usa para exportar una imagen privada a un bucket de OBS.

Antes de exportar una imagen, asegúrese de que tiene el permiso Administrador del inquilino para OBS.
Restricciones
- Una imagen solo se puede exportar a un bucket estándar que esté en la misma región que la imagen.
- No se pueden exportar las siguientes imágenes privadas:
- Imágenes completas de ECS
- Imágenes de ISO
- Imágenes privadas creadas a partir de una imagen pública de Windows, SUSE, Red Hat, Ubuntu u Oracle Linux
- Imágenes privadas creadas a partir de una imagen de Marketplace
- El tamaño de la imagen debe ser inferior a 1 TB. Las imágenes de más de 128 GB solo admiten exportación rápida.
En algunas regiones, una imagen de más de 128 GB se puede exportar normalmente (no es una exportación rápida).
URI
POST /v1/cloudimages/{image_id}/file
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
image_id |
Sí |
String |
Especifica el ID de imagen. Para obtener más información sobre cómo obtener el ID de imagen, consulte Consulta de imágenes. |
Solicitud
- Parámetros de solicitud
Parámetro
Obligatorio
Tipo
Descripción
bucket_url
Sí
String
Especifica la dirección URL del archivo de imagen con el formato de Bucket name:File name.
NOTA:La clase de almacenamiento del bucket de OBS debe ser Standard.
file_format
Sí
String
Especifica el formato de archivo. El valor puede ser qcow2, vhd, zvhd, o vmdk.
is_quick_export
No
Boolean
Si desea habilitar la exportación rápida. El valor puede ser true o false.
NOTA:Si se habilita la exportación rápida, no se puede especificar file_format.
Ejemplo de solicitud
Exportación de una imagen a un archivo QCOW2 (dirección del archivo en el bucket de OBS de destino: ims-image:centos7_5.qcow2)
1 2 3 4 5 6 |
POST https://{Endpoint}/v1/cloudimages/d164b5df-1bc3-4c3f-893e-3e471fd16e64/file { "bucket_url": "ims-image:centos7_5.qcow2", "file_format": "qcow2", "is_quick_export": false } |
Respuesta
- Parámetros de respuesta
Parámetro
Tipo
Descripción
job_id
String
Especifica el ID de trabajo asincrónico.
Para obtener más información, véase Consulta del estado de un trabajo asincrónico.
- Ejemplo de respuesta
STATUS CODE 200
1 2 3
{ "job_id": "edc89b490d7d4392898e19b2deb34797" }
Valores devueltos
- Normal
- Anormal
Valor devuelto
Descripción
400 Bad Request
Error de solicitud. Para obtener más información sobre el código de error devuelto, consulte Códigos de error.
401 Unauthorized
Error de autenticación.
403 Forbidden
Usted no tiene los derechos para realizar la operación.
404 Not Found
No se encontró el recurso solicitado.
500 Internal Server Error
Error interno del servicio.
503 Service Unavailable
El servicio no está disponible.