API Reference

Validate VM settings for a host pool

post
https://api.controlup.com/daas-iq/v1/cloud/host-pools//vm-settings/validation

Checks a VM settings payload and echoes it back enriched with resolved lookup details, without saving anything.
Send a body to test settings before committing them; omit the body to re-validate what is already stored.
A dry run only — use the save operation to persist.

Path Params
uuid
required

Host pool identifier

Body Params

Optional VM settings payload to validate; when omitted, validates persisted settings

Full request payload for creating or replacing VM settings for a host pool.

uuid | null

Optional cloud subscription ID for new VM, NIC, and disk deployment.

string
required
length between 1 and 64

Region code (e.g. eastus) where new session-host VMs are deployed.

string
required
length between 1 and 90
^[-\w.()]{0,89}[-\w()]$

Name of the resource group for newly deployed Compute resources (e.g. rg-avd-prod).

string
required
length ≥ 1

Template used for newly created session host VM names. An optional trailing
[#], [##], or [###] token enables zero-padded numbering.

string
required
length between 1 and 64

Primary VM size used for provisioning.

string | null

Optional fallback VM size used when the primary size is unavailable.

availabilityZones
array of strings
required

Requested availability zones for session host deployment.

availabilityZones*
string
enum
required

Image source selection for host pool VM settings.

Allowed:
string | null

Full ARM resource ID of the gallery image definition when Gallery is selected.

string | null

Full ARM resource ID of the gallery image version when Gallery is selected.

string | null

Full ARM resource ID of the source VM when Existing VM is selected.

string
required
length between 1 and 64

OS disk storage account type.

int64
required
≥ 1

Requested OS disk size in bytes.

string
enum
required

Security profile for Azure VMs.

Allowed:
boolean
required

Indicates whether Secure Boot is requested.

boolean
required

Indicates whether virtual TPM is requested.

boolean
required

Indicates whether integrity monitoring is requested.

string
required
length between 1 and 2048

Full ARM resource ID of the selected existing virtual network.

string
required
length between 1 and 2048

Full ARM resource ID of the selected subnet.

string
enum
required

Network security group preset for host pool VM settings.

Allowed:
boolean
required

Indicates whether public inbound ports are requested.

string
enum
required

Directory join strategy for session host VMs.

Allowed:
string | null

Active Directory domain for AD join scenarios.

string | null

Domain join user principal name for AD join scenarios.

string | null

Organizational unit path for AD join scenarios.

string
required
length between 1 and 256

Local administrator username configured on session hosts.

string | null

Optional FSLogix profile storage UNC path.

boolean
required

Indicates whether Intune enrollment is enabled.

tags
object | null

Up to 40 customer tags applied to created session host resources.
System tags are added separately during deployment or scaling.

appCatalogDeployGroupIds
array of uuids
required

App Catalog Deploy Group IDs this host pool resolves apps from at session-host provisioning.

appCatalogDeployGroupIds*
string | null

Optional local administrator password to set or update.

string | null

Optional domain join password used when AD join is selected.

Responses

204

No VM settings are configured for the specified host pool when request payload is omitted

Updated 3 months ago

Did this page help you?
Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?