Skip to content

Data Object - DesktopPatternNamingSettings

Java Class

com.omnissa.vdi.vlsi.binding.vdi.resources.Desktop.PatternNamingSettings

Property of

DesktopVirtualMachineNamingSettings, DesktopVirtualMachineNamingSpec

Since

Horizon View 6.0

Data Object Description

Settings related to specification of VMs with a naming pattern.

Data Object Properties

Name Type Description
namingPattern xsd:string Virtual machines will be named according to the specified naming pattern. By default, view manager appends a unique number to the specified pattern to provide a unique name for each virtual machine. To place this unique number elsewhere in the pattern, use '{n}'. (For example: vm-{n}-sales.) The unique number can also be made a fixed length. (For example: vm-{n:fixed=3}-sales will name VMs from vm-001-sales to vm-999-sales).
Machine names are constrained to a maximum size of 15 characters including the unique number. Therefore, care must be taken when choosing a pattern. If the maximum desktop size is 9 machines, the pattern must be at most 14 characters. For 99 machines, 13 characters, for 999 machines, 12 characters. For 9999 machines, 11 characters. If using a fixed size token, use a maximum of 14 characters for "n=1", 13 characters for "n=2", 12 characters for "n=3", and 11 characters for "n=4".
If {n} is specified with no size, a size of 2 is automatically used and if no {} is specified, {n=2} is automatically appended to the end of the pattern. 5
maxNumberOfMachines xsd:int Maximum number of machines in the desktop. 3 2
numberOfSpareMachines xsd:int Number of spare powered on machines. 3 2
provisioningTime xsd:string Determines when machines are provisioned. 6
* This property will be one of:
ValueDescription
ON_DEMANDProvision machines on demand.
UP_FRONTProvision all machines up-front.
minNumberOfMachines xsd:int The minimum number of machines to have provisioned if on demand provisioning is selected. 4 1 7 8

  1. This property need not be set. 

  2. This property has a minimum value of 1. 

  3. This property has a default value of 1. 

  4. This property has a default value of 0. 

  5. This property must contain only alphanumerics and dashes. It must contain at least one alpha character. It may also optionally contain a numeric placement token {n} or {n:fixed=#}. If the pattern does not specify the numeric placement token, the maximum length is 14 characters. 

  6. This property has a default value of 'UP_FRONT'. 

  7. This property has a minimum value of 0. 

  8. This property is required if provisioningTime is set to 'ON_DEMAND'.