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> Elastic Cloud Server> Referencia de la API> API de OpenStack Nova> Gestión de estado> Creación de una imagen mediante un ECS

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

Creación de una imagen mediante un ECS

Función

Esta API se utiliza para crear una imagen usando un ECS. Después de la creación, puede utilizar esta imagen para crear los ECS.

Las imágenes creadas con un ECS se almacenan en los nodos de almacenamiento como instantáneas.

Esta API es una API nativa de OpenStack que no es aplicable a las imágenes en la plataforma de la nube pública.

Para crear una imagen de disco del sistema o una imagen de disco de datos, utilice la API de IMS (POST /v2/cloudimages/action). Para obtener más información, consulta "Creación de una imagen" en Referencia de la API de Image Management Service.
Para crear una imagen completa de ECS, utilice la API de IMS (POST /v1/cloudimages/wholeimages/action). Para obtener más información, consulte "Creación de una imagen ECS completa" en Referencia de la API de Image Management Service.

Restricciones

No se puede utilizar un ECS en el estado de error para crear una imagen.
Si una imagen creada con un ECS se utiliza para crear un nuevo ECS, el nuevo ECS debe estar ubicado en el mismo AZ que el ECS original.
Después de eliminar una imagen creada con un ECS, las instantáneas asociadas no se eliminarán automáticamente (esta función es implementada por OpenStack nativos). Debe eliminar manualmente dichas instantáneas.
La imagen creada con un ECS no se puede utilizar para crear discos de datos.
Las imágenes creadas usando la API descrita en esta sección (URI: POST /v2/{project_id}/servers/{server_id}/action or POST /v2.1/{project_id}/servers/{server_id}/action) no se puede exportar a bucket de OBS. Si estas imágenes deben exportarse, utilice la API de IMS (POST /v2/cloudimages/action). Para obtener más información, consulta "Creación de una imagen" en Referencia de la API de Image Management Service.

URI

POST /v2.1/{project_id}/servers/{server_id}/action

Tabla 1 describe los parámetros en el URI.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Descripción
project_id	Sí	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto.
server_id	Sí	Especifica el ID de ECS.

Solicitud

Tabla 2 describe los parámetros de solicitud.

**Tabla 2** Parámetros de solicitud
Parámetro	Obligatorio	Tipo	Descripción
createImage	Sí	Object	Especifica la imagen creada con ECS. Para más detalles, consulte Tabla 3.

**Tabla 3** Descripción del campo **createImage**
Parámetro	Obligatorio	Tipo	Descripción
name	Sí	String	Especifica el nombre de la imagen con una longitud mayor que 0 bytes y menor que 243 bytes.
metadata	No	Object	Especifica el atributo image con una longitud mayor que 0 bytes y menor que 255 bytes.

Respuesta

Parámetro	Obligatorio	Tipo	Descripción
Location	Sí	String	Especifica la dirección URL local de la imagen, que se devuelve en el encabezado de la solicitud. Este parámetro no es compatible con la microversión 2.44 y posteriores.
image_id	Sí	String	Especifica el UUID de la imagen. Este parámetro está soportado en la microversión 2.45 y posteriores.

Parámetro

Obligatorio

Tipo

Descripción

Location

Sí

String

Especifica la dirección URL local de la imagen, que se devuelve en el encabezado de la solicitud.

Este parámetro no es compatible con la microversión 2.44 y posteriores.

image_id

Sí

String

Especifica el UUID de la imagen.

Este parámetro está soportado en la microversión 2.45 y posteriores.

Ejemplo de la solicitud

POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/action

{
   "createImage" : {
        "name" : "new-image-name",
        "metadata": {
            "ImageType": "Gold",
            "ImageVersion": "2.0"
        }
    }
}