Registro de una imagen

Función

Esta API se utiliza para registrar un archivo de imagen como una imagen privada no inicializada en la plataforma en la nube.

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

1. Subir el archivo de imagen a un bucket de OBS. Para obtener más información, consulte Carga de un archivo o carpeta.
2. Use la API de creación de metadatos de imágenes para crear metadatos de imágenes. Después de que la API se invoque correctamente, guarde el ID de la imagen. Para obtener información sobre cómo crear metadatos de imágenes, consulte Creación de metadatos de imágenes (API de OpenStack nativo).
3. Use la API para registrar imágenes y el ID de imagen obtenido en 2 para registrar el archivo de imagen como una imagen privada.
4. Después de que la API se invoca correctamente como una asincrónica, el sistema de servicio en la nube recibe una solicitud. Consulte el estado de la imagen utilizando el ID de imagen y verifique si el archivo de imagen se ha registrado correctamente. Cuando el estado de la imagen cambia a active, el archivo de imagen se registra correctamente como una imagen privada.

   Para obtener más información sobre cómo consultar el estado de una tarea asincrónica, consulte Consulta del estado de un trabajo asincrónico.

Antes de registrar un archivo de imagen, asegúrese de que tiene el permiso Administrador del inquilino para OBS.

URI

PUT /v1/cloudimages/{image_id}/upload

Solicitud

• Parámetros de solicitud

  Parámetro	Obligatorio	Tipo	Descripción
  image_url	Sí	String	Especifica la dirección URL del archivo de imagen con el formato de Bucket name:File name. Los archivos de imagen en el bucket pueden estar en formato ZVHD, QCOW2, VHD, RAW, VHDX, QED, VDI, QCOW, ZVHD2, ISO, o VMDK. NOTA: La clase de almacenamiento del bucket de OBS debe ser Standard.

Ejemplo de solicitud

Registro de una imagen (URL del archivo de imagen: bucketname:Centos6.5-disk1.vmdk)

1
2
3
4

PUT https://{Endpoint}/v1/cloudimages/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba86/upload
{
   "image_url": "bucketname:Centos6.5-disk1.vmdk" 
}

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.

  HTTP/1.1 200

  1 2 3

  { "job_id":" b912fb4a4c464b568ecfca1071b21b10" }

Valores devueltos

• Normal

  200

• Anormal