Promote existing VM as Master Image

post

https://api.controlup.com/daas-iq/v1/cloud/master-images/promote

Creates a new Master Image by registering an existing Azure VM.
Creates a corresponding Image Definition in the specified Azure Compute Gallery.
The VM must be Gen 2 (Trusted Launch) and not already imported.

Body Params

The promote request containing VM resource ID and metadata

Request to promote (import) an existing Azure VM as a managed Master Image.
Azure-derived fields (region, generation) are resolved server-side from the VM resource ID.

subscriptionId

uuid

required

Internal subscription ID that contains the VM.

vmResourceId

string

required

length ≥ 1

Full Azure ARM resource ID of the VM to import.

galleryResourceId

string | null

Optional ARM resource ID of an existing Azure Compute Gallery.

name

string

required

length between 1 and 128

User-provided name for the Image Library.

description

string | null

Optional description.

osFamily

string

enum

required

osVersion

string

required

length between 1 and 20

OS version/build string (e.g., "23H2", "22H2", "LTSC").

publisher

string | null

Optional Image Definition publisher override. Defaults to "ControlUp".

offer

string | null

Optional Image Definition offer override. Defaults to slugified OsFamily (e.g., "windows-11-multisession").

sku

string | null

Optional Image Definition SKU override. Defaults to slugified Name.

Responses

500

Internal server error.

201Successfully created the Master Image.

400Bad request. Invalid request parameters, VM is Gen 1, or VM already imported.

401Unauthorized. User is not authenticated.

403Forbidden. User does not have manage settings permissions.

404Not found. The specified subscription does not exist.