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.

En esta página

Mostrar todo

Centro de ayuda/ Image Management Service/ Referencia de la API/ Las API de IMS/ Imagen/ Registro de una imagen

Registro de una imagen

Actualización más reciente 2025-02-26 GMT+08:00

Ver PDF

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:

Subir el archivo de imagen a un bucket de OBS. Para obtener más información, consulte Carga de un archivo o carpeta.
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).
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.
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.

NOTA:

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

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. El registro 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, el archivo de imagen se registra correctamente. Para obtener más información, véase Consulta de detalles de imagen (API de OpenStack nativo).

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.

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)

    
       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.

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

      
         {
   "job_id":" b912fb4a4c464b568ecfca1071b21b10"
}

Valores devueltos

Normal
200
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.

Tema principal: Imagen

Tema anterior: Creación de una imagen completa de ECS

Tema siguiente: Exportación de una imagen

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar