Publish Master Image version

post

https://api.controlup.com/daas-iq/v1/cloud/master-images/{masterImageId}/publish

Dispatches a background job that clones the Master VM into a temporary publish VM,
runs AVD Agent Update and optional SXS Stack Update, runs sysprep, captures an ACG Image Version,
then cleans up the temporary publish VM. The Master VM must be in Ready status and stopped (deallocated).

Path Params

masterImageId

uuid

required

The Master Image identifier

Body Params

Publish parameters (version, target regions, SXS toggle)

Request DTO for publishing a Master Image (sysprep + capture to ACG).

version

string

required

length ≥ 1

^\d+\.\d+\.\d+$

Semantic version for the new image version (e.g., "1.0.0").
Must follow major.minor.patch format.

updateAvdAgent

boolean

Defaults to true

Whether to run the AVD Agent Update script before sysprep.
When true, stops AVD services, clears registry keys, and removes blocking AppX packages.
Defaults to true when omitted.

runSxsStackUpdate

boolean

Defaults to false

Whether to run the SXS Stack Update script before sysprep.
Defaults to false when omitted.

targetRegions

array of strings

required

length ≥ 1

Target Azure regions for image version replication.
At least one region must be specified.

targetRegions*

Responses

202Publish job dispatched successfully.

400Bad request. Master Image is not in Ready status, not stopped, missing ACG definition, insufficient vCPU quota for the publish builder VM, or invalid target regions.

401Unauthorized. User is not authenticated.

402Payment required. No active license for the organization.

403Forbidden. User does not have manage settings permissions.

404Not found. The specified Master Image does not exist.

500Internal server error.

503Service unavailable. License status could not be verified. Try again later.