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

Patch By ID

Description

Patch a single template

Request

Request

URL

URL


patch
https://cloud.vmwarehorizon.com/admin/v2/templates/{id}
Copy

Path Parameters

Path Parameters

string
id Required

Template ID


Query Parameters

Query Parameters

string
org_id Optional

Filter by orgId: non-super users can only query for their own orgIds


Request Body

Request Body

TemplatePatchTO of mimetype application/json Required

templatePatch

{
    "computerAccountOU": "CN=Computers",
    "description": "My floating desktop template",
    "maxQuiescingServers": 10,
    "name": "My floating desktop template"
}
agentCustomization Optional

map of string
applicationProperties Optional

Application properties to be added when template is created.


string
computerAccountOU Optional

The VMs of this template will be part of this Organization Unit in the AD


string
description Optional

An arbitrary description for this template.


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.


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.


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


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
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
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

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns TemplateTOV2 of type */*

Successfully patched template

{
    "description": "My floating desktop template",
    "location": "US",
    "maxQuiescingServers": 10,
    "name": "My floating desktop template"
}
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

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.


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_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: DEDICATEDFLOATINGMULTI_SESSIONRDSHSTUDIOWVD


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.

Errors

Errors

400

Bad request


401

Unauthorized


403

Forbidden


404

Template not found


409

Concurrent template update error


500

Failed to patch template

Code Samples

Code Samples

cURL Command

curl -X PATCH -H "Content-Type: application/json" -d '{"computerAccountOU":"CN=Computers","description":"My floating desktop template","maxQuiescingServers":10,"name":"My floating desktop template"}' https://cloud.vmwarehorizon.com/admin/v2/templates/{id}
Vendor Extensions

Vendor Extensions

This operation contains the following vendor extensions defined in the spec:
x-codegen-request-body-name: templatePatch


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

Was this page helpful?