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 (API de OpenStack nativo)
Actualización más reciente 2025-02-26 GMT+08:00
Ver PDF
Compartir

Carga de una imagen (API de OpenStack nativo)

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:

  1. 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.
  2. Cree metadatos para la imagen realizando las operaciones en Creación de metadatos de imágenes (API de OpenStack nativo). Después de que la API se invoque correctamente, guarde el ID de la imagen.
  3. 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 del URI.
Tabla 1 Descripción de parámetros

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.

La autenticación AK/SK admite solicitudes de API con un cuerpo de no más de 12 MB. Para las solicitudes de API con un cuerpo más grande, se recomienda la autenticación de tokens.

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

Carga de una imagen

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

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-A-Token: $mytoken" -H "Tipo-de-contenido:aplicación/flujo-octeto" -T /mnt/userdisk/ima ges/suse.zvhd

Respuesta

  • Parámetros de respuesta

    Ninguna

  • Ejemplo de respuesta 
    HTTP / 1.1 204

Valores devueltos

  • Normal

    204

  • Anormal

    Valor devuelto

    Description

    400 Bad Request (400: Solicitud errónea)

    Error de solicitud. Para obtener más información, véase Códigos de error.

    401 Unauthorized (401: No autorizado)

    Error de autenticación.

    403 Forbidden (403: Prohibido)

    Usted no tiene los derechos para realizar la operación.

    404 Not Found (404: No se encontró la página)

    No se encontró el recurso solicitado.

    409 Conflict (409: Conflicto)

    Solicitud de conflicto.

    500 Error del sistema

    Error del sistema.