FarmAutomatedSettingsInfoV4
FarmAutomatedSettingsInfoV4
Applicable To: Automated farms.
Settings for Automated farm.
JSON Example
{
"customization_settings": {
"ad_container_rdn": "CN=Computers",
"ad_site_name": "Default-First-Site-Name",
"cloneprep_customization_settings": {
"post_synchronization_script_name": "cloneprep_postsync_script",
"post_synchronization_script_parameters": "p1 p2 p3",
"power_off_script_name": "cloneprep_poweroff_script",
"power_off_script_parameters": "p1 p2 p3",
"priming_computer_account": "a219420d-4799-4517-8f78-39c74c7c4efc"
},
"customization_type": "CLONE_PREP",
"instant_clone_domain_account_id": "6f85b3a5-e7d0-4ad6-a1e3-37168dd1ed51",
"reuse_pre_existing_accounts": false,
"sysprep_customization_spec_id": "a219420d-4799-4517-8f78-39c74c7c4efc"
},
"enable_provisioning": true,
"image_source": "VIRTUAL_CENTER",
"max_session_type": "LIMITED",
"max_sessions": 50,
"min_ready_vms": 0,
"nics": [
{
"network_interface_card_id": "c9896e51-48a2-4d82-ae9e-a0246981b473",
"network_interface_card_name": "Network adapter 1",
"network_label_assignment_specs": [
{
"enabled": true,
"max_label": 1,
"max_label_type": "LIMITED",
"network_label_name": "vm-network"
}
]
}
],
"operating_system": "WINDOWS_SERVER_2016",
"operating_system_architecture": "BIT_64",
"pattern_naming_settings": {
"max_number_of_rds_servers": 5,
"naming_pattern": "vm-{n}-sales"
},
"provisioning_settings": {
"base_snapshot_id": "snapshot-1",
"compute_profile_num_cores_per_socket": 1,
"compute_profile_num_cpus": 4,
"compute_profile_ram_mb": 4096,
"datacenter_id": "datacenter-1",
"host_or_cluster_id": "domain-s425",
"im_stream_id": "6f85b3a5-e7d0-4ad6-a1e3-37168dd1ed51",
"im_tag_id": "3d45b3a5-e7d0-4ad6-a1e3-37168dd1ed51",
"parent_vm_id": "vm-2",
"resource_pool_id": "resgroup-1",
"vm_folder_id": "group-v1"
},
"provisioning_status_data": {
"instant_clone_current_image_state": "READY",
"instant_clone_operation": "INITIAL_PUBLISH",
"instant_clone_operation_time": 1587081283000,
"instant_clone_pending_im_stream_id": "c9896e51-48a2-4d82-ae9e-a0246981b473",
"instant_clone_pending_im_tag_id": "e9896e51-48a2-4d82-ae9e-a0246981b484",
"instant_clone_pending_image_error": "Could not authenticate with domain administrator credentials",
"instant_clone_pending_image_parent_vm_id": "vm-1",
"instant_clone_pending_image_progress": 10,
"instant_clone_pending_image_snapshot_id": "snapshot-1",
"instant_clone_pending_image_state": "FAILED",
"instant_clone_scheduled_maintenance_data": {
"immediate_maintenance_scheduled": true,
"logoff_policy": "WAIT_FOR_LOGOFF",
"next_scheduled_time": 1237081283000,
"recurring_maintenance_settings": {
"maintenance_period": "WEEKLY",
"maintenance_period_frequency": 10,
"start_index": 1,
"start_time": "10:00"
},
"stop_on_first_error": true
},
"last_provisioning_error": "Initial publish failed: Could not authenticate with domain administrator credentials",
"last_provisioning_error_time": 1587081283000,
"pending_compute_profile_num_cores_per_socket": 1,
"pending_compute_profile_num_cpus": 4,
"pending_compute_profile_ram_mb": 4096
},
"stop_provisioning_on_error": true,
"storage_settings": {
"datastores": [
{
"datastore_id": "datastore-1",
"storage_overcommit": "CONSERVATIVE"
}
],
"replica_disk_datastore_id": "datastore-1",
"use_separate_datastores_replica_and_os_disks": false,
"use_view_storage_accelerator": false,
"use_vsan": false
},
"transparent_page_sharing_scope": "VM",
"vcenter_id": "f148f3e8-db0e-4abb-9c33-7e5205ccd360"
}boolean
enable_provisioning
Optional
Indicates whether to enable provisioning immediately.
Supported Filters: 'Equals'. This property can be used for sorting.
string
image_source
Optional
Source of image used in the farm.
Supported Filters: 'Equals'. This property can be used for sorting.
- IMAGE_CATALOG: Image was created in image catalog.
- VIRTUAL_CENTER: Image was created in virtual center.
Possible values are : IMAGE_CATALOG, VIRTUAL_CENTER,
string
max_session_type
Optional
RDS Server type for max sessions.
- UNLIMITED: The RDS Server has an unlimited number of sessions.
- LIMITED: The RDS Server has a limited number of sessions.
Possible values are : UNLIMITED, LIMITED,
integer As int32 As int32
max_sessions
Optional
Maximum number of sessions allowed for RDS Server. This is set when max_session_type is LIMITED.
integer As int32 As int32
min_ready_vms
Optional
Minimum number of ready (provisioned) RDS Servers during Instant clone maintenance operations. Use this setting to perform machine maintenance operations in a rolling fashion. Increasing this count may decrease the concurrency for Instant clone maintenance operations for the automated farm. This property can be used for sorting.
array of FarmNetworkInterfaceCardSettingsInfo
nics
Optional
Network interface card settings for RDS Servers provisioned for this farm. A NIC may appear at most once in these settings and must be present on this RDS Server's parent's snapshot. Not all NICs need be configured. Any that are not will use default settings.
string
operating_system
Optional
The guest operating system.
- LINUX_SERVER_OTHER: Linux Server (other)
- UNKNOWN: Unknown
- WINDOWS_SERVER_2003: Windows Server 2003
- WINDOWS_SERVER_2008: Windows Server 2008
- WINDOWS_SERVER_2008_R2: Windows Server 2008 R2
- WINDOWS_SERVER_2012: Windows Server 2012
- WINDOWS_SERVER_2012_R2: Windows Server 2012 R2
- WINDOWS_SERVER_2016_OR_ABOVE: Windows Server 2016 or above
Possible values are : LINUX_SERVER_OTHER, UNKNOWN, WINDOWS_SERVER_2003, WINDOWS_SERVER_2008, WINDOWS_SERVER_2008_R2, WINDOWS_SERVER_2012, WINDOWS_SERVER_2012_R2, WINDOWS_SERVER_2016_OR_ABOVE,
string
operating_system_architecture
Optional
The guest operating system architecture.
- UNKNOWN: Operating System cannot be determined.
- BIT_32: 32 bit Operating System Architecture.
- BIT_64: 64 bit Operating System Architecture.
Possible values are : UNKNOWN, BIT_32, BIT_64,
boolean
stop_provisioning_on_error
Optional
Indicates whether provisioning on all VMs stops on error. This property can be used for sorting.
string
transparent_page_sharing_scope
Optional
Transparent page sharing scope for the farm. This property can be used for sorting.
- FARM: Inter-VM page sharing among VMs belonging to the same automated farm is permitted.
- GLOBAL: Inter-VM page sharing among all VMs on the same host is permitted.
- POD: Inter-VM page sharing among VMs belonging to the same Pod is permitted.
- VM: Inter-VM page sharing is not permitted.
Possible values are : FARM, GLOBAL, POD, VM,
string
vcenter_id
Optional
ID of the virtual center server.
Supported Filters: 'Equals'.