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
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.
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
createImage |
Sí |
Object |
Especifica la imagen creada con ECS. Para más detalles, consulte Tabla 3. |
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. |
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