Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda> Image Management Service> Referencia de la API> Las API de Native OpenStack> Imagen (Native OpenStack APIs)> Carga de una imagen (Native OpenStack API)

Actualización más reciente 2022-11-07 GMT+08:00

Ver PDF

Carga de una imagen (Native OpenStack API)

Función

Esta API se utiliza para cargar una imagen local a la plataforma en la nube. La imagen que se va a cargar debe ser inferior a 2 GB. Para cargar una imagen de más de 2 GB, consulte Registro de una imagen.

Para obtener más información acerca de cómo utilizar archivos externos para crear imágenes, consulte Creación de una imagen de disco de sistema Windows a partir de un archivo de imagen externo y Creación de una imagen de disco de sistema Linux a partir de un archivo de imagen externo.

A continuación se describe cómo usar esta API:

Prepara la imagen que se va a cargar. La imagen puede estar en formato QCOW2, VMDK, VHD, RAW, VHDX, QED, VDI, QCOW, ZVHD2 o ZVHD.
Cree metadatos para la imagen realizando las operaciones en Creación de metadatos de imágenes (Native OpenStack API). Después de que la API se invoque correctamente, guarde el ID de la imagen.
Sube el archivo de imagen con el ID de imagen obtenido en 2.

URI

PUT /v2/images/{image_id}/file

Tabla 1 enumera los parámetros en el URI.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Tipo	Descripción
image_id	Sí	String	Especifica el ID de imagen. image_id es el ID de la imagen que ha creado invocando la API para crear metadatos de imagen. La carga de imágenes puede fallar si usa otros ID de imagen. Después de invocar esta API, puede comprobar el estado de la imagen con el ID de la imagen. Cuando el estado de la imagen cambia a active, la imagen se carga correctamente.

Solicitud

Parámetros de solicitud

Parámetro	Obligatorio	Tipo	Descripción
image_file	Sí	file	Especifica el archivo local que se va a cargar.

Ejemplo de solicitud

PUT https://{Endpoint}/v2/images/84ac7f2b-bf19-4efb-86a0-b5be8771b476/file

Si usas el comando curl para llamar a la API, la solicitud de ejemplo es la siguiente:

curl -i --insecure 'https://IP/v2/images/84ac7f2b-bf19-4efb-86a0-b5be8771b476/file' -X PUT -H "X-Auth-Token: $mytoken" -H "Content-Type:application/octet-stream" -T /mnt/userdisk/images/suse.zvhd

Respuesta

Parámetros de respuesta
Ninguno
Ejemplo de respuesta
```
HTTP/1.1 204
```

Valores devueltos

Normal
204

Anormal

Valor devuelto	Descripción
400 Bad Request	Error de solicitud. Para más detalles, 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.
409 Conflict	Solicitud de conflicto.
500 System Error	Error del sistema.