[{"label":"Latest (V1)","version":"latest"}]
horizon-cloud-nextgen

TemplateTOV2

Searchable fields are “id”,“activeDirectoryId”,“diskEncryption.enabled”,“edgeDeploymentId”,“imageReference.streamId”,“imageReference.versionId”,“imageReference.markerId”,“name”,“parentId”,“protocols”,“providerInstanceId”,“templateType”,“uagDeploymentId”


Properties

string
activeDirectoryId Optional

ID of the Active Directory configuration that will be used when creating VMs in this template. This defines the domain to which VMs will be joined, and the account used to do so.


agentCustomization Optional

map of string
applicationProperties Optional

Application properties to be added when template is created.


boolean
clientAccessLicenseApplicable Optional

clientAccessLicenseApplicable is set to true if customer has RDS CAL for Server images. Ref : https://docs.microsoft.com/en-us/azure/virtual-desktop/overview


string
computerAccountOU Optional

Pool VMs will join this OU if specified else they will be part of the default OU of the AD domain


string as date-time
createdAt Optional

Template create timestamp.


boolean
deleting Optional

True when a DELETE call for a template has been made to admin, but the template has not yet finished deleting.


string
description Optional

An arbitrary description for this template.


string
desktopAdminCredentialId Optional

Credential ID that points to desktop admin credentials needed during VM provisioning.


string
desktopAdminUsername Optional

The initial admin username for all new VMs created from this template. Only available in ’expanded’ templates.


diskEncryption Optional

integer as int32
diskSizeInGB Optional

Specifies the size of os disk in gigabytes


edgeDeployment Optional

Searchable fields are “id”, “name”, “providerLabel”, “providerInstanceId”, “status”


string
edgeDeploymentId Optional

ID of the ’edgeDeployment’ for the template. Though this attribute can be inferred from the provider instance, it is referenced here for the purpose of easy lookup.


HDC
hdc Optional

string
id Optional

Template ID.


string
imageId Optional

ID of the gold pattern (image) from which all VMs in the template will be created. This is obtained from the Image Service.


imageReference Optional

infrastructure Optional

All other provider resources that should be used when creating VMs for this template. The keys in this map and the interpretation of the values depend on the provider type.


boolean
licenseProvided Optional

Represents if the Windows License Type was acknowledged and provided by the user


string
location Optional

location


integer as int32
maxQuiescingServers Optional

Max number of desktops which can quiesced when the template is undergoing normal maintenance.


string
name Optional

Template name.


networks Optional

List of network resources that will be used when creating VMs for this template. The meaning of ’network resource’ will depend on the provider type. For example, in Azure, this will be a list of subnets.


string
orgId Optional

Org ID that owns this template.


string
parentId Optional

Parent template ID, if this template is an expansion.


powerPolicy Optional

Power policy Spec


array of string
protocols Optional

List of protocols to be allowed for client connections to desktops in this template. Allowable values are ‘BLAST’, ‘PCOIP’ and ‘RDP’.

Possible values are: BLASTPCOIPRDP


providerInstance Optional

Searchable Fields are “id”, “name”, “providerLabel”, “edgeDeploymentId”, “infraTwinSyncStatus”


string
providerInstanceId Optional

ID of the provider instance to used when creating VMs for this template. This will define, for example, the subscription and region of the VMs for Azure templates.


string
providerLabel Optional

The type of the provider template belongs to


reportedStatus Optional

map of string
resourceTags Optional

Tags to be added to resources when they are created as part of this template.


integer as int32
sessionsPerVm Optional

Max number of desktops sessions allowed per VM. For Windows desktop VMs, this value must be 1. For MULTI_SESSION, it can be any value greater than 0.


sparePolicy Optional

Spare capacity policy


string
syncStatus Optional

Synchronization status of the template.

Possible values are: SYNC_COMPLETESYNC_CREATE_ERRORSYNC_CREATE_PENDINGSYNC_DELETE_ERRORSYNC_DELETE_PENDINGSYNC_RETRY_PROVISIONING_ERRORSYNC_RETRY_PROVISIONING_PENDINGSYNC_UPDATE_ERRORSYNC_UPDATE_PENDING


string
templateConnectivityStatus Optional

Defines whether this template is ‘offline’ or ‘online’. When offline, no VM lifecycle operations will be performed for this template, and no client connections will be allowed.

Possible values are: OFFLINEONLINE


string
templateType Optional

Template type. ‘DEDICATED’ creates single-session Windows 10 VMs that are assigned to and owned by specific users. ‘FLOATING’ creates single-session Windows 10 VMs that are shared. ‘MULTI_SESSION’ creates multi-session Windows Server VMs and multi-session Windows 10 VMs.

Possible values are: APP_CAPTURE_STUDIODEDICATEDELASTIC_GPUFLOATINGMULTI_SESSIONRDSHSTUDIOWVD


integer as int32
transientLoadThresholdSecs Optional

Time spacing (in seconds) between consecutive session placement on a MULTI-SESSIONtemplate VM. This property will be used to load balance session slots among theMULTI-SESSION template VMs. This value should be between 0 to 300


uagDeployment Optional

Searchable fields are “id”, “name”, “type”, “providerInstanceId”, “providerLabel”, “status”


string
uagDeploymentId Optional

ID of the ‘uagDeployment’ for the template. This defines the UAG cluster that will be used to connect clients to desktops.


string as date-time
updatedAt Optional

Template update timestamp.


string
vmLicenseType Optional

The type of Windows licenses that the creating organization posesses and wishes to use for all VMs created as part of this template.

Possible values are: NONEWINDOWS_CLIENTWINDOWS_SERVER


string
vmNamePattern Optional

Pattern used as prefix for VMs created for this template.

JSON Example

{
    "description": "My floating desktop template",
    "location": "US",
    "maxQuiescingServers": 10,
    "name": "My floating desktop template",
    "providerLabel": "AZURE|VSPHERE",
    "transientLoadThresholdSecs": 10
}

Feedback

Was this page helpful?