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 IMS/ Imagen/ Importación rápida de un archivo de imagen

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

Ver PDF

Importación rápida de un archivo de imagen

Función

Esta API se utiliza para crear rápidamente una imagen privada a partir de un archivo de imagen externo de gran tamaño que se ha subido al bucket OBS. Actualmente, solo se admiten archivos de imagen ZVHD2 y RAW, y el tamaño de un archivo de imagen no puede superar 1 TB.

La función de creación rápida de imágenes solo está disponible para archivos de imagen en formato RAW o ZVHD2. Para otros formatos de archivos de imagen que son menores a 128 GB, se recomienda importar estos archivos con el método común.

La API es asincrónica. Si se invoca correctamente, el sistema de servicio en la nube recibe la solicitud. Sin embargo, debe usar la API de consulta de trabajo asincrónica para consultar el estado de creación de imágenes. Para obtener más información, véase Consulta del estado de un trabajo asincrónico.

Huawei Cloud dejó de proporcionar imágenes de Windows. Esta API ya no se utilizará para importar imágenes de Windows rápidamente.

Restricciones

Antes de importar archivos de imagen, asegúrese de que el formato de archivo es RAW o ZVHD2 y se ha hecho lo siguiente:

Se han optimizado los archivos de imagen RAW y se han generado archivos de bitmap.
Los archivos de imagen ZVHD2 se han optimizado según sea necesario.

Para obtener detalles sobre cómo convertir el formato de archivo de imagen y generar un archivo de bitmap, consulte Importación rápida de un archivo de imagen.

URI

POST /v2/cloudimages/quickimport/action

Solicitud

Parámetros en el cuerpo de la solicitud cuando se utiliza un archivo de imagen para crear una imagen de disco del sistema

Parámetro	Obligatorio	Tipo	Descripción
name	Sí	String	Especifica el nombre de la imagen. Para una descripción detallada, consulte Atributos de imagen.
description	No	String	Proporciona información adicional sobre la imagen. Para una descripción detallada, consulte Atributos de imagen. El valor contiene un máximo de 1024 caracteres y consta solo de letras y dígitos. No se permiten retornos de carro ni corchetes angulares (< >). Este parámetro se deja en blanco por defecto.
os_version	Sí	String	Especifica la versión del sistema operativo. Este parámetro es válido si se utiliza un archivo de imagen externo cargado en el bucket de OBS para crear una imagen. Para su valor, consulte Valores de parámetros relacionados.
license_type	No	String	Especifica el tipo de licencia del sistema operativo. El valor puede ser: platform: licencia proporcionada por Huawei Cloud byol: Traiga su propia licencia Actualmente, este parámetro solo está disponible para Windows.
image_url	Sí	String	Especifica la dirección URL del archivo de imagen externo en el bucket de OBS. Este parámetro es obligatorio si se utiliza un archivo de imagen externo en el bucket de OBS para crear una imagen. El formato es OBS bucket name:Image file name. NOTA: La clase de almacenamiento del bucket de OBS debe ser Standard.
min_disk	Sí	Integer	Especifica el tamaño mínimo (GB) del disco del sistema. Este parámetro es obligatorio si se utiliza un archivo de imagen externo en el bucket de OBS para crear una imagen. El valor oscila entre 1 y 1024 y debe ser mayor que el tamaño del archivo de imagen seleccionado.
tags	No	Array of strings	Enumera las etiquetas de imagen. Este parámetro se deja en blanco por defecto. Establezca tags o image_tags.
image_tags	No	Array of objects	Enumera las etiquetas de imagen. Este parámetro se deja en blanco por defecto. Establezca tags o image_tags.
type	No	String	Especifica el tipo de imagen. El valor del parámetro es ECS/BMS para las imágenes de disco del sistema. El valor predeterminado es ECS.
enterprise_project_id	No	String	Especifica el proyecto empresarial al que pertenece la imagen. Si el valor es 0 o se deja en blanco, la imagen pertenece al proyecto empresarial predeterminado. Si el valor es un UUID, la imagen pertenece al proyecto empresarial correspondiente al UUID. Para obtener más información sobre proyectos empresariales y cómo obtener los ID de proyectos empresariales, consulte Centro empresarial.
architecture	No	String	Especifica el tipo de arquitectura de imagen. Los valores disponibles incluyen: x86 arm El valor predeterminado es x86. NOTA: Si la arquitectura de imagen es ARM, el modo de arranque se cambia automáticamente a UEFI.

Descripción de parámetros cuando se utiliza un archivo de imagen cargado en el bucket OBS para crear una imagen

Parámetro	Obligatorio	Tipo	Descripción
name	Sí	String	Especifica el nombre de la imagen. Para una descripción detallada, consulte Atributos de imagen.
description	No	String	Proporciona información adicional sobre la imagen. Consulte Atributos de imagen para obtener una descripción detallada. El valor contiene un máximo de 1024 caracteres y consta solo de letras y dígitos. No se permiten retornos de carro ni corchetes angulares (< >). Este parámetro se deja en blanco por defecto.
os_type	No	String	Especifica la versión del sistema operativo. Cuando se crea una imagen de disco de datos, el valor puede ser Linux o Windows. El valor predeterminado es Linux.
image_url	Sí	String	Especifica la dirección URL del archivo de imagen externo en el bucket de OBS. Este parámetro es obligatorio si se utiliza un archivo de imagen externo en el bucket de OBS para crear una imagen. El formato es OBS bucket name:Image file name. NOTA: La clase de almacenamiento del bucket de OBS debe ser Standard.
min_disk	Sí	Integer	Especifica el tamaño mínimo del disco del sistema en la unidad de GB. Este parámetro es obligatorio si se utiliza un archivo de imagen externo en el bucket de OBS para crear una imagen. El valor oscila entre 1 y 1024.
tags	No	Array of strings	Enumera las etiquetas de imagen. Este parámetro se deja en blanco por defecto. Establezca tags o image_tags.
image_tags	No	Array of objects	Enumera las etiquetas de imagen. Este parámetro se deja en blanco por defecto. Establezca tags o image_tags.
type	Sí	String	Especifica el tipo de imagen. El valor del parámetro es DataImage para las imágenes de disco de datos.
enterprise_project_id	No	String	Especifica el proyecto empresarial al que pertenece la imagen. Si el valor es 0 o se deja en blanco, la imagen pertenece al proyecto empresarial predeterminado. Si el valor es un UUID, la imagen pertenece al proyecto empresarial correspondiente al UUID. Para obtener más información sobre proyectos empresariales y cómo obtener los ID de proyectos empresariales, consulte Centro empresarial.

Ejemplo de solicitud

Creación de una imagen de disco del sistema con el parámetro tags mediante un archivo en un bucket de OBS (dirección del archivo en el bucket: ims-image:centos70.zvhd2)

      
           POST https://{Endpoint}/v2/cloudimages/quickimport/action
{  
    "name": "ims_test_file",  
   "description": "Create an image using a file in the OBS bucket.", 
    "image_url": "ims-image:centos70.zvhd2",  
    "os_version": "CentOS 7.0 64bit",  
    "min_disk": 40,  
    "type": "ECS", 
    "tags":
        [
            "aaa.111",    
            "bbb.333",    
            "ccc.444"    
        ]
}

Creación de una imagen de disco del sistema con el parámetro image_tags mediante un archivo en un bucket de OBS (dirección del archivo en el bucket: ims-image:centos70.zvhd2)

      
           POST https://{Endpoint}/v2/cloudimages/quickimport/action
{  
    "name": "ims_test_file",  
   "description": "Create an image using a file in the OBS bucket.", 
    "image_url": "ims-image:centos70.zvhd2",  
    "os_version": "CentOS 7.0 64bit",  
    "min_disk": 40,  
    "type": "ECS", 
    "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}]  
}

Creación de una imagen de disco de datos con el parámetro tags mediante un archivo en un bucket de OBS (dirección del archivo en el bucket: ims-image:centos70.zvhd2)

      
           POST https://{Endpoint}/v2/cloudimages/quickimport/action
{  
    "name": "ims_test_file",  
   "description": "Create an image using a file in the OBS bucket.", 
    "image_url": "ims-image:centos70.zvhd2",  
    "os_type": "Linux",  
    "min_disk": 40,  
    "type": "DataImage",  
    "tags": [    
        "aaa.111",    
        "bbb.333",    
        "ccc.444"    
    ]
}

Creación de una imagen de disco de datos con el parámetro image_tags mediante un archivo en un bucket de OBS (dirección del archivo en el bucket: ims-image:centos70.zvhd2)

      
           POST https://{Endpoint}/v2/cloudimages/quickimport/action
{  
    "name": "ims_test_file",  
   "description": "Create an image using a file in the OBS bucket.", 
    "image_url": "ims-image:centos70.zvhd2",  
    "os_type": "Linux",  
    "min_disk": 40,  
    "type": "DataImage",
    "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}]
}

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.

STATUS CODE 200

      
           {
     "job_id": "8a12fc664fb4daa3014fb4e581380005"
}

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.
500 Internal Server Error	Error interno del servicio.
503 Service Unavailable	El servicio no está disponible.