Sign in

v52

latestOpenAPI 3.0.3GNU Affero General Public License v3.0 (AGPL-3.0)raw.githubusercontent.com2026-08-0113040156.8 KB
Machine Image

Create a new version of a machine image from a stopped VM

post/project/{project_id}/location/{location}/machine-image/{machine_image_reference}/version/{version}

Request body

vmstring required

UBID of the source VM

destroy_sourceboolean

Destroy the source VM after capture

Response

A machine image version

idstring required

ID of the machine image version

versionstring required

Version label

state'creating' | 'ready' | 'destroying' | 'failed' nullable required

Lifecycle state, or null if no metal record exists

actual_size_mibinteger nullable

Actual size of the image in MiB

archive_size_mibinteger nullable

Size of the archived image in MiB

created_atstring date-time required

Creation timestamp

latestboolean required

True if this is the machine image's currently-published latest version

Example response

{
  "id": "mvn30gjk1d1e2jj34v9x0dq4rp",
  "version": "v1.0"
}