Images are backups of your Instances. One image will contain all the volumes of your Instance and can be used to restore your Instance and its data. You can also use it to create a series of Instances with a predefined configuration. To copy not all but only one specified volume of an Instance, you can use the snapshot feature instead.
List Instance images
List all existing Instance images.
path Parameters
zoneThe zone you want to target
query Parameters
organizationper_pagepagenamepublicarchprojecttagsList Instance images › Responses
List of images.
Create an Instance image
Create an Instance image from the specified snapshot ID.
path Parameters
zoneThe zone you want to target
Create an Instance image › Request Body
root_volumeUUID of the snapshot.
archArchitecture of the image.
nameName of the image.
Additional volumes of the image.
projectProject ID of the image.
tagsTags of the image.
publicTrue to create a public image.
organizationOrganization ID of the image.
Create an Instance image › Responses
Update image
Replace all image properties with an image message.
path Parameters
zoneThe zone you want to target
idUpdate image › Request Body
namearchcreation_date(RFC 3339 format)
modification_date(RFC 3339 format)
from_serverorganizationpublicstateprojecttagsUpdate image › Responses
Get an Instance image
Get details of an image with the specified ID.
path Parameters
zoneThe zone you want to target
image_idUUID of the image you want to get.
Get an Instance image › Responses
Delete an Instance image
Delete the image with the specified ID.
path Parameters
zoneThe zone you want to target
image_idUUID of the image you want to delete.
Delete an Instance image › Responses
Update image
Update the properties of an image.
path Parameters
zoneThe zone you want to target
image_idUUID of the image. (UUID format)
Update image › Request Body
nameName of the image.
archArchitecture of the image.
Additional snapshots of the image, with extra_volumeKey being the position of the snapshot in the image.
tagsTags of the image.
publicTrue to set the image as public.