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

  1. No se puede utilizar un ECS en el estado de error para crear una imagen.
  2. 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.
  3. 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.
  4. La imagen creada con un ECS no se puede utilizar para crear discos de datos.
  5. 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

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

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

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

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

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

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"
        }
    }
}

Ejemplo de la respuesta

No hay