pulumi-vsphere 4.10.0a1710160860__py3-none-any.whl → 4.10.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of pulumi-vsphere might be problematic. Click here for more details.

Files changed (53) hide show
  1. pulumi_vsphere/__init__.py +2 -0
  2. pulumi_vsphere/_inputs.py +96 -230
  3. pulumi_vsphere/compute_cluster.py +700 -1477
  4. pulumi_vsphere/compute_cluster_vm_affinity_rule.py +28 -16
  5. pulumi_vsphere/datacenter.py +26 -12
  6. pulumi_vsphere/datastore_cluster.py +154 -350
  7. pulumi_vsphere/distributed_port_group.py +70 -175
  8. pulumi_vsphere/distributed_virtual_switch.py +308 -805
  9. pulumi_vsphere/file.py +16 -24
  10. pulumi_vsphere/get_compute_cluster.py +0 -4
  11. pulumi_vsphere/get_compute_cluster_host_group.py +8 -10
  12. pulumi_vsphere/get_content_library.py +0 -4
  13. pulumi_vsphere/get_custom_attribute.py +0 -4
  14. pulumi_vsphere/get_datacenter.py +0 -4
  15. pulumi_vsphere/get_datastore.py +27 -7
  16. pulumi_vsphere/get_datastore_cluster.py +0 -4
  17. pulumi_vsphere/get_datastore_stats.py +194 -0
  18. pulumi_vsphere/get_distributed_virtual_switch.py +2 -4
  19. pulumi_vsphere/get_dynamic.py +4 -8
  20. pulumi_vsphere/get_folder.py +0 -4
  21. pulumi_vsphere/get_guest_os_customization.py +0 -4
  22. pulumi_vsphere/get_host.py +0 -4
  23. pulumi_vsphere/get_host_pci_device.py +4 -12
  24. pulumi_vsphere/get_host_thumbprint.py +0 -4
  25. pulumi_vsphere/get_host_vgpu_profile.py +182 -0
  26. pulumi_vsphere/get_license.py +0 -4
  27. pulumi_vsphere/get_network.py +0 -4
  28. pulumi_vsphere/get_policy.py +0 -4
  29. pulumi_vsphere/get_resource_pool.py +2 -10
  30. pulumi_vsphere/get_role.py +0 -4
  31. pulumi_vsphere/get_tag.py +0 -4
  32. pulumi_vsphere/get_tag_category.py +0 -4
  33. pulumi_vsphere/get_vapp_container.py +0 -4
  34. pulumi_vsphere/get_virtual_machine.py +29 -9
  35. pulumi_vsphere/get_vmfs_disks.py +0 -4
  36. pulumi_vsphere/guest_os_customization.py +50 -0
  37. pulumi_vsphere/ha_vm_override.py +189 -378
  38. pulumi_vsphere/host.py +0 -20
  39. pulumi_vsphere/host_port_group.py +12 -24
  40. pulumi_vsphere/host_virtual_switch.py +140 -287
  41. pulumi_vsphere/license.py +0 -32
  42. pulumi_vsphere/outputs.py +167 -230
  43. pulumi_vsphere/resource_pool.py +48 -22
  44. pulumi_vsphere/virtual_disk.py +10 -10
  45. pulumi_vsphere/virtual_machine.py +639 -807
  46. pulumi_vsphere/virtual_machine_snapshot.py +6 -10
  47. pulumi_vsphere/vm_storage_policy.py +72 -84
  48. pulumi_vsphere/vnic.py +8 -20
  49. {pulumi_vsphere-4.10.0a1710160860.dist-info → pulumi_vsphere-4.10.1.dist-info}/METADATA +1 -1
  50. pulumi_vsphere-4.10.1.dist-info/RECORD +82 -0
  51. {pulumi_vsphere-4.10.0a1710160860.dist-info → pulumi_vsphere-4.10.1.dist-info}/WHEEL +1 -1
  52. pulumi_vsphere-4.10.0a1710160860.dist-info/RECORD +0 -80
  53. {pulumi_vsphere-4.10.0a1710160860.dist-info → pulumi_vsphere-4.10.1.dist-info}/top_level.txt +0 -0
@@ -56,6 +56,7 @@ class VirtualMachineArgs:
56
56
  memory_hot_add_enabled: Optional[pulumi.Input[bool]] = None,
57
57
  memory_limit: Optional[pulumi.Input[int]] = None,
58
58
  memory_reservation: Optional[pulumi.Input[int]] = None,
59
+ memory_reservation_locked_to_max: Optional[pulumi.Input[bool]] = None,
59
60
  memory_share_count: Optional[pulumi.Input[int]] = None,
60
61
  memory_share_level: Optional[pulumi.Input[str]] = None,
61
62
  migrate_wait_timeout: Optional[pulumi.Input[int]] = None,
@@ -92,119 +93,93 @@ class VirtualMachineArgs:
92
93
  wait_for_guest_net_timeout: Optional[pulumi.Input[int]] = None):
93
94
  """
94
95
  The set of arguments for constructing a VirtualMachine resource.
95
- :param pulumi.Input[str] resource_pool_id: The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
96
-
97
- > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
98
- :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
99
- :param pulumi.Input[str] annotation: A user-provided description of the virtual machine.
100
- :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence. The default is no delay.
101
- :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
102
- :param pulumi.Input[bool] boot_retry_enabled: If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
103
- :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineCdromArgs']]] cdroms: A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
104
- :param pulumi.Input['VirtualMachineCloneArgs'] clone: When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
105
- :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to the virtual machine while it is powered on.
106
- :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be removed to the virtual machine while it is powered on.
107
- :param pulumi.Input[int] cpu_limit: The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
108
- :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on the virtual machine. Default: `false`.
109
- :param pulumi.Input[int] cpu_reservation: The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
110
- :param pulumi.Input[int] cpu_share_count: The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
111
- :param pulumi.Input[str] cpu_share_level: The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
112
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
113
-
114
- > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
115
- :param pulumi.Input[str] datacenter_id: The datacenter ID. Required only when deploying an OVF/OVA template.
116
- :param pulumi.Input[str] datastore_cluster_id: The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
117
-
118
- > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
119
-
120
- > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
121
-
122
- > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
123
- :param pulumi.Input[str] datastore_id: The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
124
- :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineDiskArgs']]] disks: A specification for a virtual disk device on the virtual machine. See disk options for more information.
125
- :param pulumi.Input[bool] efi_secure_boot_enabled: Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
126
-
127
- > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
128
- :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
129
- :param pulumi.Input[bool] enable_logging: Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
130
- :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
131
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
132
-
133
- > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
134
- :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
135
- :param pulumi.Input[str] firmware: The firmware for the virtual machine. One of `bios` or `efi`.
136
- :param pulumi.Input[str] folder: The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`). For example, `/dc-01/vm/foo`
137
- :param pulumi.Input[bool] force_power_off: If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
138
- :param pulumi.Input[str] guest_id: The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
139
-
140
- [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
141
- :param pulumi.Input[int] hardware_version: The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
142
-
143
- [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
144
- [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
145
- :param pulumi.Input[str] host_system_id: The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
146
- :param pulumi.Input[str] hv_mode: The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
147
- :param pulumi.Input[int] ide_controller_count: The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
148
- :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
149
- :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
150
-
151
- > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
152
- :param pulumi.Input[int] memory: The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
153
- :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to the virtual machine while it is powered on.
154
-
155
- > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
156
-
157
- [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
158
-
159
- > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
160
-
161
- [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
162
- :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
163
- :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
164
- :param pulumi.Input[int] memory_share_count: The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
165
- :param pulumi.Input[str] memory_share_level: The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
166
- :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
167
- :param pulumi.Input[str] name: The name of the virtual machine.
168
- :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
169
- :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineNetworkInterfaceArgs']]] network_interfaces: A specification for a virtual NIC on the virtual machine. See network interface options for more information.
170
- :param pulumi.Input[int] num_cores_per_socket: The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
171
- :param pulumi.Input[int] num_cpus: The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
172
- :param pulumi.Input['VirtualMachineOvfDeployArgs'] ovf_deploy: When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
173
- :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: List of host PCI device IDs in which to create PCI passthroughs.
174
-
175
- > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
96
+ :param pulumi.Input[str] resource_pool_id: The ID of a resource pool to put the virtual machine in.
97
+ :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when guest_id is otherGuest or otherGuest64.
98
+ :param pulumi.Input[str] annotation: User-provided description of the virtual machine.
99
+ :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence.
100
+ :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
101
+ :param pulumi.Input[bool] boot_retry_enabled: If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
102
+ :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineCdromArgs']]] cdroms: A specification for a CDROM device on this virtual machine.
103
+ :param pulumi.Input['VirtualMachineCloneArgs'] clone: A specification for cloning a virtual machine from template.
104
+ :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to this virtual machine while it is running.
105
+ :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be added to this virtual machine while it is running.
106
+ :param pulumi.Input[int] cpu_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
107
+ resources.
108
+ :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on this virtual machine.
109
+ :param pulumi.Input[int] cpu_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
110
+ :param pulumi.Input[int] cpu_share_count: The amount of shares to allocate to cpu for a custom share level.
111
+ :param pulumi.Input[str] cpu_share_level: The allocation level for cpu resources. Can be one of high, low, normal, or custom.
112
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: A list of custom attributes to set on this resource.
113
+ :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VM is to be created.
114
+ :param pulumi.Input[str] datastore_cluster_id: The ID of a datastore cluster to put the virtual machine in.
115
+ :param pulumi.Input[str] datastore_id: The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
116
+ disks that are created without datastores.
117
+ :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineDiskArgs']]] disks: A specification for a virtual disk device on this virtual machine.
118
+ :param pulumi.Input[bool] efi_secure_boot_enabled: When the boot type set in firmware is efi, this enables EFI secure boot.
119
+ :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
120
+ :param pulumi.Input[bool] enable_logging: Enable logging on this virtual machine.
121
+ :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
122
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
123
+ configuration, such as instance metadata, or configuration data for OVF images.
124
+ :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
125
+ :param pulumi.Input[str] firmware: The firmware interface to use on the virtual machine. Can be one of bios or efi.
126
+ :param pulumi.Input[str] folder: The name of the folder to locate the virtual machine in.
127
+ :param pulumi.Input[bool] force_power_off: Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
128
+ :param pulumi.Input[str] guest_id: The guest ID for the operating system.
129
+ :param pulumi.Input[int] hardware_version: The hardware version for the virtual machine.
130
+ :param pulumi.Input[str] host_system_id: The ID of an optional host system to pin the virtual machine to.
131
+ :param pulumi.Input[str] hv_mode: The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
132
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an IP
133
+ :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
134
+ latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
135
+ devices. Can be one of low, normal, medium, or high.
136
+ :param pulumi.Input[int] memory: The size of the virtual machine's memory, in MB.
137
+ :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to this virtual machine while it is running.
138
+ :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
139
+ resources.
140
+ :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
141
+ :param pulumi.Input[bool] memory_reservation_locked_to_max: If set true, memory resource reservation for this virtual machine will always be equal to the virtual machine's memory
142
+ size;increases in memory size will be rejected when a corresponding reservation increase is not possible. This feature
143
+ may only be enabled if it is currently possible to reserve all of the virtual machine's memory.
144
+ :param pulumi.Input[int] memory_share_count: The amount of shares to allocate to memory for a custom share level.
145
+ :param pulumi.Input[str] memory_share_level: The allocation level for memory resources. Can be one of high, low, normal, or custom.
146
+ :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
147
+ :param pulumi.Input[str] name: The name of this virtual machine.
148
+ :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
149
+ :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineNetworkInterfaceArgs']]] network_interfaces: A specification for a virtual NIC on this virtual machine.
150
+ :param pulumi.Input[int] num_cores_per_socket: The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
151
+ must be evenly divisible by this value.
152
+ :param pulumi.Input[int] num_cpus: The number of virtual processors to assign to this virtual machine.
153
+ :param pulumi.Input['VirtualMachineOvfDeployArgs'] ovf_deploy: A specification for deploying a virtual machine from ovf/ova template.
154
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: A list of PCI passthrough devices
176
155
  :param pulumi.Input[int] poweron_timeout: The amount of time, in seconds, that we will be trying to power on a VM
177
156
  :param pulumi.Input[str] replace_trigger: Triggers replacement of resource whenever it changes.
178
-
179
- For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
180
- :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
181
- :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
182
- :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
183
- :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
184
- :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
185
- :param pulumi.Input[int] sata_controller_count: The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
186
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
187
- controllers.
188
- :param pulumi.Input[str] scsi_bus_sharing: The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
189
- :param pulumi.Input[int] scsi_controller_count: The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
190
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
191
- controllers.
192
- :param pulumi.Input[str] scsi_type: The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
193
- :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
194
- :param pulumi.Input[str] storage_policy_id: The UUID of the storage policy to assign to the virtual disk.
195
- :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
196
- :param pulumi.Input[bool] sync_time_with_host: Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `false`.
197
- :param pulumi.Input[bool] sync_time_with_host_periodically: Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
198
- :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
199
-
200
- > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
201
- :param pulumi.Input[str] tools_upgrade_policy: Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
202
- :param pulumi.Input['VirtualMachineVappArgs'] vapp: Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
203
- :param pulumi.Input[bool] vbs_enabled: Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
204
- :param pulumi.Input[bool] vvtd_enabled: Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
205
- :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
206
- :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
207
- :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
157
+ :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
158
+ :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
159
+ :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
160
+ :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
161
+ :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable the run of scripts before guest operating system standby when VMware Tools is installed.
162
+ :param pulumi.Input[str] scsi_bus_sharing: Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
163
+ :param pulumi.Input[str] scsi_type: The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
164
+ :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
165
+ :param pulumi.Input[str] storage_policy_id: The ID of the storage policy to assign to the virtual machine home directory.
166
+ :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
167
+ :param pulumi.Input[bool] sync_time_with_host: Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
168
+ synchronized on startup and resume. Requires VMware Tools to be installed.
169
+ :param pulumi.Input[bool] sync_time_with_host_periodically: Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
170
+ setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
171
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tag IDs to apply to this object.
172
+ :param pulumi.Input[str] tools_upgrade_policy: Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
173
+ :param pulumi.Input['VirtualMachineVappArgs'] vapp: vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
174
+ :param pulumi.Input[bool] vbs_enabled: Flag to specify if Virtualization-based security is enabled for this virtual machine.
175
+ :param pulumi.Input[bool] vvtd_enabled: Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
176
+ I/O Virtualization (AMD-Vi or IOMMU), is enabled.
177
+ :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
178
+ disables the waiter.
179
+ :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
180
+ a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
181
+ :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
182
+ disables the waiter.
208
183
  """
209
184
  pulumi.set(__self__, "resource_pool_id", resource_pool_id)
210
185
  if alternate_guest_name is not None:
@@ -285,6 +260,8 @@ class VirtualMachineArgs:
285
260
  pulumi.set(__self__, "memory_limit", memory_limit)
286
261
  if memory_reservation is not None:
287
262
  pulumi.set(__self__, "memory_reservation", memory_reservation)
263
+ if memory_reservation_locked_to_max is not None:
264
+ pulumi.set(__self__, "memory_reservation_locked_to_max", memory_reservation_locked_to_max)
288
265
  if memory_share_count is not None:
289
266
  pulumi.set(__self__, "memory_share_count", memory_share_count)
290
267
  if memory_share_level is not None:
@@ -358,9 +335,7 @@ class VirtualMachineArgs:
358
335
  @pulumi.getter(name="resourcePoolId")
359
336
  def resource_pool_id(self) -> pulumi.Input[str]:
360
337
  """
361
- The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
362
-
363
- > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
338
+ The ID of a resource pool to put the virtual machine in.
364
339
  """
365
340
  return pulumi.get(self, "resource_pool_id")
366
341
 
@@ -372,7 +347,7 @@ class VirtualMachineArgs:
372
347
  @pulumi.getter(name="alternateGuestName")
373
348
  def alternate_guest_name(self) -> Optional[pulumi.Input[str]]:
374
349
  """
375
- The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
350
+ The guest name for the operating system when guest_id is otherGuest or otherGuest64.
376
351
  """
377
352
  return pulumi.get(self, "alternate_guest_name")
378
353
 
@@ -384,7 +359,7 @@ class VirtualMachineArgs:
384
359
  @pulumi.getter
385
360
  def annotation(self) -> Optional[pulumi.Input[str]]:
386
361
  """
387
- A user-provided description of the virtual machine.
362
+ User-provided description of the virtual machine.
388
363
  """
389
364
  return pulumi.get(self, "annotation")
390
365
 
@@ -396,7 +371,7 @@ class VirtualMachineArgs:
396
371
  @pulumi.getter(name="bootDelay")
397
372
  def boot_delay(self) -> Optional[pulumi.Input[int]]:
398
373
  """
399
- The number of milliseconds to wait before starting the boot sequence. The default is no delay.
374
+ The number of milliseconds to wait before starting the boot sequence.
400
375
  """
401
376
  return pulumi.get(self, "boot_delay")
402
377
 
@@ -408,7 +383,7 @@ class VirtualMachineArgs:
408
383
  @pulumi.getter(name="bootRetryDelay")
409
384
  def boot_retry_delay(self) -> Optional[pulumi.Input[int]]:
410
385
  """
411
- The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
386
+ The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
412
387
  """
413
388
  return pulumi.get(self, "boot_retry_delay")
414
389
 
@@ -420,7 +395,7 @@ class VirtualMachineArgs:
420
395
  @pulumi.getter(name="bootRetryEnabled")
421
396
  def boot_retry_enabled(self) -> Optional[pulumi.Input[bool]]:
422
397
  """
423
- If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
398
+ If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
424
399
  """
425
400
  return pulumi.get(self, "boot_retry_enabled")
426
401
 
@@ -432,7 +407,7 @@ class VirtualMachineArgs:
432
407
  @pulumi.getter
433
408
  def cdroms(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['VirtualMachineCdromArgs']]]]:
434
409
  """
435
- A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
410
+ A specification for a CDROM device on this virtual machine.
436
411
  """
437
412
  return pulumi.get(self, "cdroms")
438
413
 
@@ -444,7 +419,7 @@ class VirtualMachineArgs:
444
419
  @pulumi.getter
445
420
  def clone(self) -> Optional[pulumi.Input['VirtualMachineCloneArgs']]:
446
421
  """
447
- When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
422
+ A specification for cloning a virtual machine from template.
448
423
  """
449
424
  return pulumi.get(self, "clone")
450
425
 
@@ -456,7 +431,7 @@ class VirtualMachineArgs:
456
431
  @pulumi.getter(name="cpuHotAddEnabled")
457
432
  def cpu_hot_add_enabled(self) -> Optional[pulumi.Input[bool]]:
458
433
  """
459
- Allow CPUs to be added to the virtual machine while it is powered on.
434
+ Allow CPUs to be added to this virtual machine while it is running.
460
435
  """
461
436
  return pulumi.get(self, "cpu_hot_add_enabled")
462
437
 
@@ -468,7 +443,7 @@ class VirtualMachineArgs:
468
443
  @pulumi.getter(name="cpuHotRemoveEnabled")
469
444
  def cpu_hot_remove_enabled(self) -> Optional[pulumi.Input[bool]]:
470
445
  """
471
- Allow CPUs to be removed to the virtual machine while it is powered on.
446
+ Allow CPUs to be added to this virtual machine while it is running.
472
447
  """
473
448
  return pulumi.get(self, "cpu_hot_remove_enabled")
474
449
 
@@ -480,7 +455,8 @@ class VirtualMachineArgs:
480
455
  @pulumi.getter(name="cpuLimit")
481
456
  def cpu_limit(self) -> Optional[pulumi.Input[int]]:
482
457
  """
483
- The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
458
+ The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
459
+ resources.
484
460
  """
485
461
  return pulumi.get(self, "cpu_limit")
486
462
 
@@ -492,7 +468,7 @@ class VirtualMachineArgs:
492
468
  @pulumi.getter(name="cpuPerformanceCountersEnabled")
493
469
  def cpu_performance_counters_enabled(self) -> Optional[pulumi.Input[bool]]:
494
470
  """
495
- Enable CPU performance counters on the virtual machine. Default: `false`.
471
+ Enable CPU performance counters on this virtual machine.
496
472
  """
497
473
  return pulumi.get(self, "cpu_performance_counters_enabled")
498
474
 
@@ -504,7 +480,7 @@ class VirtualMachineArgs:
504
480
  @pulumi.getter(name="cpuReservation")
505
481
  def cpu_reservation(self) -> Optional[pulumi.Input[int]]:
506
482
  """
507
- The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
483
+ The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
508
484
  """
509
485
  return pulumi.get(self, "cpu_reservation")
510
486
 
@@ -516,7 +492,7 @@ class VirtualMachineArgs:
516
492
  @pulumi.getter(name="cpuShareCount")
517
493
  def cpu_share_count(self) -> Optional[pulumi.Input[int]]:
518
494
  """
519
- The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
495
+ The amount of shares to allocate to cpu for a custom share level.
520
496
  """
521
497
  return pulumi.get(self, "cpu_share_count")
522
498
 
@@ -528,7 +504,7 @@ class VirtualMachineArgs:
528
504
  @pulumi.getter(name="cpuShareLevel")
529
505
  def cpu_share_level(self) -> Optional[pulumi.Input[str]]:
530
506
  """
531
- The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
507
+ The allocation level for cpu resources. Can be one of high, low, normal, or custom.
532
508
  """
533
509
  return pulumi.get(self, "cpu_share_level")
534
510
 
@@ -540,9 +516,7 @@ class VirtualMachineArgs:
540
516
  @pulumi.getter(name="customAttributes")
541
517
  def custom_attributes(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
542
518
  """
543
- Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
544
-
545
- > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
519
+ A list of custom attributes to set on this resource.
546
520
  """
547
521
  return pulumi.get(self, "custom_attributes")
548
522
 
@@ -554,7 +528,7 @@ class VirtualMachineArgs:
554
528
  @pulumi.getter(name="datacenterId")
555
529
  def datacenter_id(self) -> Optional[pulumi.Input[str]]:
556
530
  """
557
- The datacenter ID. Required only when deploying an OVF/OVA template.
531
+ The ID of the datacenter where the VM is to be created.
558
532
  """
559
533
  return pulumi.get(self, "datacenter_id")
560
534
 
@@ -566,13 +540,7 @@ class VirtualMachineArgs:
566
540
  @pulumi.getter(name="datastoreClusterId")
567
541
  def datastore_cluster_id(self) -> Optional[pulumi.Input[str]]:
568
542
  """
569
- The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
570
-
571
- > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
572
-
573
- > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
574
-
575
- > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
543
+ The ID of a datastore cluster to put the virtual machine in.
576
544
  """
577
545
  return pulumi.get(self, "datastore_cluster_id")
578
546
 
@@ -584,7 +552,8 @@ class VirtualMachineArgs:
584
552
  @pulumi.getter(name="datastoreId")
585
553
  def datastore_id(self) -> Optional[pulumi.Input[str]]:
586
554
  """
587
- The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
555
+ The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
556
+ disks that are created without datastores.
588
557
  """
589
558
  return pulumi.get(self, "datastore_id")
590
559
 
@@ -596,7 +565,7 @@ class VirtualMachineArgs:
596
565
  @pulumi.getter
597
566
  def disks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['VirtualMachineDiskArgs']]]]:
598
567
  """
599
- A specification for a virtual disk device on the virtual machine. See disk options for more information.
568
+ A specification for a virtual disk device on this virtual machine.
600
569
  """
601
570
  return pulumi.get(self, "disks")
602
571
 
@@ -608,9 +577,7 @@ class VirtualMachineArgs:
608
577
  @pulumi.getter(name="efiSecureBootEnabled")
609
578
  def efi_secure_boot_enabled(self) -> Optional[pulumi.Input[bool]]:
610
579
  """
611
- Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
612
-
613
- > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
580
+ When the boot type set in firmware is efi, this enables EFI secure boot.
614
581
  """
615
582
  return pulumi.get(self, "efi_secure_boot_enabled")
616
583
 
@@ -622,7 +589,7 @@ class VirtualMachineArgs:
622
589
  @pulumi.getter(name="enableDiskUuid")
623
590
  def enable_disk_uuid(self) -> Optional[pulumi.Input[bool]]:
624
591
  """
625
- Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
592
+ Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
626
593
  """
627
594
  return pulumi.get(self, "enable_disk_uuid")
628
595
 
@@ -634,7 +601,7 @@ class VirtualMachineArgs:
634
601
  @pulumi.getter(name="enableLogging")
635
602
  def enable_logging(self) -> Optional[pulumi.Input[bool]]:
636
603
  """
637
- Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
604
+ Enable logging on this virtual machine.
638
605
  """
639
606
  return pulumi.get(self, "enable_logging")
640
607
 
@@ -646,7 +613,7 @@ class VirtualMachineArgs:
646
613
  @pulumi.getter(name="eptRviMode")
647
614
  def ept_rvi_mode(self) -> Optional[pulumi.Input[str]]:
648
615
  """
649
- The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
616
+ The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
650
617
  """
651
618
  return pulumi.get(self, "ept_rvi_mode")
652
619
 
@@ -658,9 +625,8 @@ class VirtualMachineArgs:
658
625
  @pulumi.getter(name="extraConfig")
659
626
  def extra_config(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
660
627
  """
661
- Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
662
-
663
- > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
628
+ Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
629
+ configuration, such as instance metadata, or configuration data for OVF images.
664
630
  """
665
631
  return pulumi.get(self, "extra_config")
666
632
 
@@ -672,7 +638,7 @@ class VirtualMachineArgs:
672
638
  @pulumi.getter(name="extraConfigRebootRequired")
673
639
  def extra_config_reboot_required(self) -> Optional[pulumi.Input[bool]]:
674
640
  """
675
- Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
641
+ Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
676
642
  """
677
643
  return pulumi.get(self, "extra_config_reboot_required")
678
644
 
@@ -684,7 +650,7 @@ class VirtualMachineArgs:
684
650
  @pulumi.getter
685
651
  def firmware(self) -> Optional[pulumi.Input[str]]:
686
652
  """
687
- The firmware for the virtual machine. One of `bios` or `efi`.
653
+ The firmware interface to use on the virtual machine. Can be one of bios or efi.
688
654
  """
689
655
  return pulumi.get(self, "firmware")
690
656
 
@@ -696,7 +662,7 @@ class VirtualMachineArgs:
696
662
  @pulumi.getter
697
663
  def folder(self) -> Optional[pulumi.Input[str]]:
698
664
  """
699
- The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`). For example, `/dc-01/vm/foo`
665
+ The name of the folder to locate the virtual machine in.
700
666
  """
701
667
  return pulumi.get(self, "folder")
702
668
 
@@ -708,7 +674,7 @@ class VirtualMachineArgs:
708
674
  @pulumi.getter(name="forcePowerOff")
709
675
  def force_power_off(self) -> Optional[pulumi.Input[bool]]:
710
676
  """
711
- If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
677
+ Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
712
678
  """
713
679
  return pulumi.get(self, "force_power_off")
714
680
 
@@ -720,9 +686,7 @@ class VirtualMachineArgs:
720
686
  @pulumi.getter(name="guestId")
721
687
  def guest_id(self) -> Optional[pulumi.Input[str]]:
722
688
  """
723
- The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
724
-
725
- [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
689
+ The guest ID for the operating system.
726
690
  """
727
691
  return pulumi.get(self, "guest_id")
728
692
 
@@ -734,10 +698,7 @@ class VirtualMachineArgs:
734
698
  @pulumi.getter(name="hardwareVersion")
735
699
  def hardware_version(self) -> Optional[pulumi.Input[int]]:
736
700
  """
737
- The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
738
-
739
- [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
740
- [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
701
+ The hardware version for the virtual machine.
741
702
  """
742
703
  return pulumi.get(self, "hardware_version")
743
704
 
@@ -749,7 +710,7 @@ class VirtualMachineArgs:
749
710
  @pulumi.getter(name="hostSystemId")
750
711
  def host_system_id(self) -> Optional[pulumi.Input[str]]:
751
712
  """
752
- The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
713
+ The ID of an optional host system to pin the virtual machine to.
753
714
  """
754
715
  return pulumi.get(self, "host_system_id")
755
716
 
@@ -761,7 +722,7 @@ class VirtualMachineArgs:
761
722
  @pulumi.getter(name="hvMode")
762
723
  def hv_mode(self) -> Optional[pulumi.Input[str]]:
763
724
  """
764
- The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
725
+ The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
765
726
  """
766
727
  return pulumi.get(self, "hv_mode")
767
728
 
@@ -772,9 +733,6 @@ class VirtualMachineArgs:
772
733
  @property
773
734
  @pulumi.getter(name="ideControllerCount")
774
735
  def ide_controller_count(self) -> Optional[pulumi.Input[int]]:
775
- """
776
- The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
777
- """
778
736
  return pulumi.get(self, "ide_controller_count")
779
737
 
780
738
  @ide_controller_count.setter
@@ -785,7 +743,7 @@ class VirtualMachineArgs:
785
743
  @pulumi.getter(name="ignoredGuestIps")
786
744
  def ignored_guest_ips(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
787
745
  """
788
- List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
746
+ List of IP addresses and CIDR networks to ignore while waiting for an IP
789
747
  """
790
748
  return pulumi.get(self, "ignored_guest_ips")
791
749
 
@@ -797,9 +755,9 @@ class VirtualMachineArgs:
797
755
  @pulumi.getter(name="latencySensitivity")
798
756
  def latency_sensitivity(self) -> Optional[pulumi.Input[str]]:
799
757
  """
800
- Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
801
-
802
- > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
758
+ Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
759
+ latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
760
+ devices. Can be one of low, normal, medium, or high.
803
761
  """
804
762
  return pulumi.get(self, "latency_sensitivity")
805
763
 
@@ -811,7 +769,7 @@ class VirtualMachineArgs:
811
769
  @pulumi.getter
812
770
  def memory(self) -> Optional[pulumi.Input[int]]:
813
771
  """
814
- The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
772
+ The size of the virtual machine's memory, in MB.
815
773
  """
816
774
  return pulumi.get(self, "memory")
817
775
 
@@ -823,15 +781,7 @@ class VirtualMachineArgs:
823
781
  @pulumi.getter(name="memoryHotAddEnabled")
824
782
  def memory_hot_add_enabled(self) -> Optional[pulumi.Input[bool]]:
825
783
  """
826
- Allow memory to be added to the virtual machine while it is powered on.
827
-
828
- > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
829
-
830
- [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
831
-
832
- > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
833
-
834
- [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
784
+ Allow memory to be added to this virtual machine while it is running.
835
785
  """
836
786
  return pulumi.get(self, "memory_hot_add_enabled")
837
787
 
@@ -843,7 +793,8 @@ class VirtualMachineArgs:
843
793
  @pulumi.getter(name="memoryLimit")
844
794
  def memory_limit(self) -> Optional[pulumi.Input[int]]:
845
795
  """
846
- The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
796
+ The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
797
+ resources.
847
798
  """
848
799
  return pulumi.get(self, "memory_limit")
849
800
 
@@ -855,7 +806,7 @@ class VirtualMachineArgs:
855
806
  @pulumi.getter(name="memoryReservation")
856
807
  def memory_reservation(self) -> Optional[pulumi.Input[int]]:
857
808
  """
858
- The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
809
+ The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
859
810
  """
860
811
  return pulumi.get(self, "memory_reservation")
861
812
 
@@ -863,11 +814,25 @@ class VirtualMachineArgs:
863
814
  def memory_reservation(self, value: Optional[pulumi.Input[int]]):
864
815
  pulumi.set(self, "memory_reservation", value)
865
816
 
817
+ @property
818
+ @pulumi.getter(name="memoryReservationLockedToMax")
819
+ def memory_reservation_locked_to_max(self) -> Optional[pulumi.Input[bool]]:
820
+ """
821
+ If set true, memory resource reservation for this virtual machine will always be equal to the virtual machine's memory
822
+ size;increases in memory size will be rejected when a corresponding reservation increase is not possible. This feature
823
+ may only be enabled if it is currently possible to reserve all of the virtual machine's memory.
824
+ """
825
+ return pulumi.get(self, "memory_reservation_locked_to_max")
826
+
827
+ @memory_reservation_locked_to_max.setter
828
+ def memory_reservation_locked_to_max(self, value: Optional[pulumi.Input[bool]]):
829
+ pulumi.set(self, "memory_reservation_locked_to_max", value)
830
+
866
831
  @property
867
832
  @pulumi.getter(name="memoryShareCount")
868
833
  def memory_share_count(self) -> Optional[pulumi.Input[int]]:
869
834
  """
870
- The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
835
+ The amount of shares to allocate to memory for a custom share level.
871
836
  """
872
837
  return pulumi.get(self, "memory_share_count")
873
838
 
@@ -879,7 +844,7 @@ class VirtualMachineArgs:
879
844
  @pulumi.getter(name="memoryShareLevel")
880
845
  def memory_share_level(self) -> Optional[pulumi.Input[str]]:
881
846
  """
882
- The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
847
+ The allocation level for memory resources. Can be one of high, low, normal, or custom.
883
848
  """
884
849
  return pulumi.get(self, "memory_share_level")
885
850
 
@@ -891,7 +856,7 @@ class VirtualMachineArgs:
891
856
  @pulumi.getter(name="migrateWaitTimeout")
892
857
  def migrate_wait_timeout(self) -> Optional[pulumi.Input[int]]:
893
858
  """
894
- The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
859
+ The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
895
860
  """
896
861
  return pulumi.get(self, "migrate_wait_timeout")
897
862
 
@@ -903,7 +868,7 @@ class VirtualMachineArgs:
903
868
  @pulumi.getter
904
869
  def name(self) -> Optional[pulumi.Input[str]]:
905
870
  """
906
- The name of the virtual machine.
871
+ The name of this virtual machine.
907
872
  """
908
873
  return pulumi.get(self, "name")
909
874
 
@@ -915,7 +880,7 @@ class VirtualMachineArgs:
915
880
  @pulumi.getter(name="nestedHvEnabled")
916
881
  def nested_hv_enabled(self) -> Optional[pulumi.Input[bool]]:
917
882
  """
918
- Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
883
+ Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
919
884
  """
920
885
  return pulumi.get(self, "nested_hv_enabled")
921
886
 
@@ -927,7 +892,7 @@ class VirtualMachineArgs:
927
892
  @pulumi.getter(name="networkInterfaces")
928
893
  def network_interfaces(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['VirtualMachineNetworkInterfaceArgs']]]]:
929
894
  """
930
- A specification for a virtual NIC on the virtual machine. See network interface options for more information.
895
+ A specification for a virtual NIC on this virtual machine.
931
896
  """
932
897
  return pulumi.get(self, "network_interfaces")
933
898
 
@@ -939,7 +904,8 @@ class VirtualMachineArgs:
939
904
  @pulumi.getter(name="numCoresPerSocket")
940
905
  def num_cores_per_socket(self) -> Optional[pulumi.Input[int]]:
941
906
  """
942
- The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
907
+ The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
908
+ must be evenly divisible by this value.
943
909
  """
944
910
  return pulumi.get(self, "num_cores_per_socket")
945
911
 
@@ -951,7 +917,7 @@ class VirtualMachineArgs:
951
917
  @pulumi.getter(name="numCpus")
952
918
  def num_cpus(self) -> Optional[pulumi.Input[int]]:
953
919
  """
954
- The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
920
+ The number of virtual processors to assign to this virtual machine.
955
921
  """
956
922
  return pulumi.get(self, "num_cpus")
957
923
 
@@ -963,7 +929,7 @@ class VirtualMachineArgs:
963
929
  @pulumi.getter(name="ovfDeploy")
964
930
  def ovf_deploy(self) -> Optional[pulumi.Input['VirtualMachineOvfDeployArgs']]:
965
931
  """
966
- When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
932
+ A specification for deploying a virtual machine from ovf/ova template.
967
933
  """
968
934
  return pulumi.get(self, "ovf_deploy")
969
935
 
@@ -975,9 +941,7 @@ class VirtualMachineArgs:
975
941
  @pulumi.getter(name="pciDeviceIds")
976
942
  def pci_device_ids(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
977
943
  """
978
- List of host PCI device IDs in which to create PCI passthroughs.
979
-
980
- > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
944
+ A list of PCI passthrough devices
981
945
  """
982
946
  return pulumi.get(self, "pci_device_ids")
983
947
 
@@ -1002,8 +966,6 @@ class VirtualMachineArgs:
1002
966
  def replace_trigger(self) -> Optional[pulumi.Input[str]]:
1003
967
  """
1004
968
  Triggers replacement of resource whenever it changes.
1005
-
1006
- For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
1007
969
  """
1008
970
  return pulumi.get(self, "replace_trigger")
1009
971
 
@@ -1015,7 +977,7 @@ class VirtualMachineArgs:
1015
977
  @pulumi.getter(name="runToolsScriptsAfterPowerOn")
1016
978
  def run_tools_scripts_after_power_on(self) -> Optional[pulumi.Input[bool]]:
1017
979
  """
1018
- Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
980
+ Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
1019
981
  """
1020
982
  return pulumi.get(self, "run_tools_scripts_after_power_on")
1021
983
 
@@ -1027,7 +989,7 @@ class VirtualMachineArgs:
1027
989
  @pulumi.getter(name="runToolsScriptsAfterResume")
1028
990
  def run_tools_scripts_after_resume(self) -> Optional[pulumi.Input[bool]]:
1029
991
  """
1030
- Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
992
+ Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
1031
993
  """
1032
994
  return pulumi.get(self, "run_tools_scripts_after_resume")
1033
995
 
@@ -1039,7 +1001,7 @@ class VirtualMachineArgs:
1039
1001
  @pulumi.getter(name="runToolsScriptsBeforeGuestReboot")
1040
1002
  def run_tools_scripts_before_guest_reboot(self) -> Optional[pulumi.Input[bool]]:
1041
1003
  """
1042
- Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
1004
+ Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
1043
1005
  """
1044
1006
  return pulumi.get(self, "run_tools_scripts_before_guest_reboot")
1045
1007
 
@@ -1051,7 +1013,7 @@ class VirtualMachineArgs:
1051
1013
  @pulumi.getter(name="runToolsScriptsBeforeGuestShutdown")
1052
1014
  def run_tools_scripts_before_guest_shutdown(self) -> Optional[pulumi.Input[bool]]:
1053
1015
  """
1054
- Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
1016
+ Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
1055
1017
  """
1056
1018
  return pulumi.get(self, "run_tools_scripts_before_guest_shutdown")
1057
1019
 
@@ -1063,7 +1025,7 @@ class VirtualMachineArgs:
1063
1025
  @pulumi.getter(name="runToolsScriptsBeforeGuestStandby")
1064
1026
  def run_tools_scripts_before_guest_standby(self) -> Optional[pulumi.Input[bool]]:
1065
1027
  """
1066
- Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
1028
+ Enable the run of scripts before guest operating system standby when VMware Tools is installed.
1067
1029
  """
1068
1030
  return pulumi.get(self, "run_tools_scripts_before_guest_standby")
1069
1031
 
@@ -1074,11 +1036,6 @@ class VirtualMachineArgs:
1074
1036
  @property
1075
1037
  @pulumi.getter(name="sataControllerCount")
1076
1038
  def sata_controller_count(self) -> Optional[pulumi.Input[int]]:
1077
- """
1078
- The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
1079
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
1080
- controllers.
1081
- """
1082
1039
  return pulumi.get(self, "sata_controller_count")
1083
1040
 
1084
1041
  @sata_controller_count.setter
@@ -1089,7 +1046,7 @@ class VirtualMachineArgs:
1089
1046
  @pulumi.getter(name="scsiBusSharing")
1090
1047
  def scsi_bus_sharing(self) -> Optional[pulumi.Input[str]]:
1091
1048
  """
1092
- The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
1049
+ Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
1093
1050
  """
1094
1051
  return pulumi.get(self, "scsi_bus_sharing")
1095
1052
 
@@ -1100,11 +1057,6 @@ class VirtualMachineArgs:
1100
1057
  @property
1101
1058
  @pulumi.getter(name="scsiControllerCount")
1102
1059
  def scsi_controller_count(self) -> Optional[pulumi.Input[int]]:
1103
- """
1104
- The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
1105
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
1106
- controllers.
1107
- """
1108
1060
  return pulumi.get(self, "scsi_controller_count")
1109
1061
 
1110
1062
  @scsi_controller_count.setter
@@ -1115,7 +1067,7 @@ class VirtualMachineArgs:
1115
1067
  @pulumi.getter(name="scsiType")
1116
1068
  def scsi_type(self) -> Optional[pulumi.Input[str]]:
1117
1069
  """
1118
- The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
1070
+ The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
1119
1071
  """
1120
1072
  return pulumi.get(self, "scsi_type")
1121
1073
 
@@ -1127,7 +1079,7 @@ class VirtualMachineArgs:
1127
1079
  @pulumi.getter(name="shutdownWaitTimeout")
1128
1080
  def shutdown_wait_timeout(self) -> Optional[pulumi.Input[int]]:
1129
1081
  """
1130
- The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
1082
+ The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
1131
1083
  """
1132
1084
  return pulumi.get(self, "shutdown_wait_timeout")
1133
1085
 
@@ -1139,7 +1091,7 @@ class VirtualMachineArgs:
1139
1091
  @pulumi.getter(name="storagePolicyId")
1140
1092
  def storage_policy_id(self) -> Optional[pulumi.Input[str]]:
1141
1093
  """
1142
- The UUID of the storage policy to assign to the virtual disk.
1094
+ The ID of the storage policy to assign to the virtual machine home directory.
1143
1095
  """
1144
1096
  return pulumi.get(self, "storage_policy_id")
1145
1097
 
@@ -1151,7 +1103,7 @@ class VirtualMachineArgs:
1151
1103
  @pulumi.getter(name="swapPlacementPolicy")
1152
1104
  def swap_placement_policy(self) -> Optional[pulumi.Input[str]]:
1153
1105
  """
1154
- The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
1106
+ The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
1155
1107
  """
1156
1108
  return pulumi.get(self, "swap_placement_policy")
1157
1109
 
@@ -1163,7 +1115,8 @@ class VirtualMachineArgs:
1163
1115
  @pulumi.getter(name="syncTimeWithHost")
1164
1116
  def sync_time_with_host(self) -> Optional[pulumi.Input[bool]]:
1165
1117
  """
1166
- Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `false`.
1118
+ Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
1119
+ synchronized on startup and resume. Requires VMware Tools to be installed.
1167
1120
  """
1168
1121
  return pulumi.get(self, "sync_time_with_host")
1169
1122
 
@@ -1175,7 +1128,8 @@ class VirtualMachineArgs:
1175
1128
  @pulumi.getter(name="syncTimeWithHostPeriodically")
1176
1129
  def sync_time_with_host_periodically(self) -> Optional[pulumi.Input[bool]]:
1177
1130
  """
1178
- Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
1131
+ Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
1132
+ setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
1179
1133
  """
1180
1134
  return pulumi.get(self, "sync_time_with_host_periodically")
1181
1135
 
@@ -1187,9 +1141,7 @@ class VirtualMachineArgs:
1187
1141
  @pulumi.getter
1188
1142
  def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
1189
1143
  """
1190
- The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
1191
-
1192
- > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
1144
+ A list of tag IDs to apply to this object.
1193
1145
  """
1194
1146
  return pulumi.get(self, "tags")
1195
1147
 
@@ -1201,7 +1153,7 @@ class VirtualMachineArgs:
1201
1153
  @pulumi.getter(name="toolsUpgradePolicy")
1202
1154
  def tools_upgrade_policy(self) -> Optional[pulumi.Input[str]]:
1203
1155
  """
1204
- Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
1156
+ Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
1205
1157
  """
1206
1158
  return pulumi.get(self, "tools_upgrade_policy")
1207
1159
 
@@ -1213,7 +1165,7 @@ class VirtualMachineArgs:
1213
1165
  @pulumi.getter
1214
1166
  def vapp(self) -> Optional[pulumi.Input['VirtualMachineVappArgs']]:
1215
1167
  """
1216
- Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
1168
+ vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
1217
1169
  """
1218
1170
  return pulumi.get(self, "vapp")
1219
1171
 
@@ -1225,7 +1177,7 @@ class VirtualMachineArgs:
1225
1177
  @pulumi.getter(name="vbsEnabled")
1226
1178
  def vbs_enabled(self) -> Optional[pulumi.Input[bool]]:
1227
1179
  """
1228
- Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
1180
+ Flag to specify if Virtualization-based security is enabled for this virtual machine.
1229
1181
  """
1230
1182
  return pulumi.get(self, "vbs_enabled")
1231
1183
 
@@ -1237,7 +1189,8 @@ class VirtualMachineArgs:
1237
1189
  @pulumi.getter(name="vvtdEnabled")
1238
1190
  def vvtd_enabled(self) -> Optional[pulumi.Input[bool]]:
1239
1191
  """
1240
- Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
1192
+ Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
1193
+ I/O Virtualization (AMD-Vi or IOMMU), is enabled.
1241
1194
  """
1242
1195
  return pulumi.get(self, "vvtd_enabled")
1243
1196
 
@@ -1249,7 +1202,8 @@ class VirtualMachineArgs:
1249
1202
  @pulumi.getter(name="waitForGuestIpTimeout")
1250
1203
  def wait_for_guest_ip_timeout(self) -> Optional[pulumi.Input[int]]:
1251
1204
  """
1252
- The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
1205
+ The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
1206
+ disables the waiter.
1253
1207
  """
1254
1208
  return pulumi.get(self, "wait_for_guest_ip_timeout")
1255
1209
 
@@ -1261,7 +1215,8 @@ class VirtualMachineArgs:
1261
1215
  @pulumi.getter(name="waitForGuestNetRoutable")
1262
1216
  def wait_for_guest_net_routable(self) -> Optional[pulumi.Input[bool]]:
1263
1217
  """
1264
- Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
1218
+ Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
1219
+ a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
1265
1220
  """
1266
1221
  return pulumi.get(self, "wait_for_guest_net_routable")
1267
1222
 
@@ -1273,7 +1228,8 @@ class VirtualMachineArgs:
1273
1228
  @pulumi.getter(name="waitForGuestNetTimeout")
1274
1229
  def wait_for_guest_net_timeout(self) -> Optional[pulumi.Input[int]]:
1275
1230
  """
1276
- The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
1231
+ The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
1232
+ disables the waiter.
1277
1233
  """
1278
1234
  return pulumi.get(self, "wait_for_guest_net_timeout")
1279
1235
 
@@ -1328,6 +1284,7 @@ class _VirtualMachineState:
1328
1284
  memory_hot_add_enabled: Optional[pulumi.Input[bool]] = None,
1329
1285
  memory_limit: Optional[pulumi.Input[int]] = None,
1330
1286
  memory_reservation: Optional[pulumi.Input[int]] = None,
1287
+ memory_reservation_locked_to_max: Optional[pulumi.Input[bool]] = None,
1331
1288
  memory_share_count: Optional[pulumi.Input[int]] = None,
1332
1289
  memory_share_level: Optional[pulumi.Input[str]] = None,
1333
1290
  migrate_wait_timeout: Optional[pulumi.Input[int]] = None,
@@ -1372,130 +1329,103 @@ class _VirtualMachineState:
1372
1329
  wait_for_guest_net_timeout: Optional[pulumi.Input[int]] = None):
1373
1330
  """
1374
1331
  Input properties used for looking up and filtering VirtualMachine resources.
1375
- :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
1376
- :param pulumi.Input[str] annotation: A user-provided description of the virtual machine.
1377
- :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence. The default is no delay.
1378
- :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
1379
- :param pulumi.Input[bool] boot_retry_enabled: If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
1380
- :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineCdromArgs']]] cdroms: A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
1332
+ :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when guest_id is otherGuest or otherGuest64.
1333
+ :param pulumi.Input[str] annotation: User-provided description of the virtual machine.
1334
+ :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence.
1335
+ :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
1336
+ :param pulumi.Input[bool] boot_retry_enabled: If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
1337
+ :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineCdromArgs']]] cdroms: A specification for a CDROM device on this virtual machine.
1381
1338
  :param pulumi.Input[str] change_version: A unique identifier for a given version of the last configuration was applied.
1382
- :param pulumi.Input['VirtualMachineCloneArgs'] clone: When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
1383
- :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to the virtual machine while it is powered on.
1384
- :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be removed to the virtual machine while it is powered on.
1385
- :param pulumi.Input[int] cpu_limit: The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
1386
- :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on the virtual machine. Default: `false`.
1387
- :param pulumi.Input[int] cpu_reservation: The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
1388
- :param pulumi.Input[int] cpu_share_count: The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
1389
- :param pulumi.Input[str] cpu_share_level: The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
1390
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
1391
-
1392
- > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
1393
- :param pulumi.Input[str] datacenter_id: The datacenter ID. Required only when deploying an OVF/OVA template.
1394
- :param pulumi.Input[str] datastore_cluster_id: The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
1395
-
1396
- > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
1397
-
1398
- > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
1399
-
1400
- > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
1401
- :param pulumi.Input[str] datastore_id: The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
1339
+ :param pulumi.Input['VirtualMachineCloneArgs'] clone: A specification for cloning a virtual machine from template.
1340
+ :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to this virtual machine while it is running.
1341
+ :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be added to this virtual machine while it is running.
1342
+ :param pulumi.Input[int] cpu_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
1343
+ resources.
1344
+ :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on this virtual machine.
1345
+ :param pulumi.Input[int] cpu_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
1346
+ :param pulumi.Input[int] cpu_share_count: The amount of shares to allocate to cpu for a custom share level.
1347
+ :param pulumi.Input[str] cpu_share_level: The allocation level for cpu resources. Can be one of high, low, normal, or custom.
1348
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: A list of custom attributes to set on this resource.
1349
+ :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VM is to be created.
1350
+ :param pulumi.Input[str] datastore_cluster_id: The ID of a datastore cluster to put the virtual machine in.
1351
+ :param pulumi.Input[str] datastore_id: The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
1352
+ disks that are created without datastores.
1402
1353
  :param pulumi.Input[str] default_ip_address: The IP address selected by the provider to be used with any provisioners configured on this resource. When possible, this is the first IPv4 address that is reachable through the default gateway configured on the machine, then the first reachable IPv6 address, and then the first general discovered address if neither exists. If VMware Tools is not running on the virtual machine, or if the virtual machine is powered off, this value will be blank.
1403
- :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineDiskArgs']]] disks: A specification for a virtual disk device on the virtual machine. See disk options for more information.
1404
- :param pulumi.Input[bool] efi_secure_boot_enabled: Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
1405
-
1406
- > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
1407
- :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
1408
- :param pulumi.Input[bool] enable_logging: Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
1409
- :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
1410
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
1411
-
1412
- > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
1413
- :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
1414
- :param pulumi.Input[str] firmware: The firmware for the virtual machine. One of `bios` or `efi`.
1415
- :param pulumi.Input[str] folder: The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`). For example, `/dc-01/vm/foo`
1416
- :param pulumi.Input[bool] force_power_off: If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
1417
- :param pulumi.Input[str] guest_id: The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
1418
-
1419
- [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
1354
+ :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineDiskArgs']]] disks: A specification for a virtual disk device on this virtual machine.
1355
+ :param pulumi.Input[bool] efi_secure_boot_enabled: When the boot type set in firmware is efi, this enables EFI secure boot.
1356
+ :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
1357
+ :param pulumi.Input[bool] enable_logging: Enable logging on this virtual machine.
1358
+ :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
1359
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
1360
+ configuration, such as instance metadata, or configuration data for OVF images.
1361
+ :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
1362
+ :param pulumi.Input[str] firmware: The firmware interface to use on the virtual machine. Can be one of bios or efi.
1363
+ :param pulumi.Input[str] folder: The name of the folder to locate the virtual machine in.
1364
+ :param pulumi.Input[bool] force_power_off: Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
1365
+ :param pulumi.Input[str] guest_id: The guest ID for the operating system.
1420
1366
  :param pulumi.Input[Sequence[pulumi.Input[str]]] guest_ip_addresses: The current list of IP addresses on this machine, including the value of `default_ip_address`. If VMware Tools is not running on the virtual machine, or if the virtul machine is powered off, this list will be empty.
1421
- :param pulumi.Input[int] hardware_version: The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
1422
-
1423
- [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
1424
- [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
1425
- :param pulumi.Input[str] host_system_id: The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
1426
- :param pulumi.Input[str] hv_mode: The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
1427
- :param pulumi.Input[int] ide_controller_count: The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
1428
- :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
1367
+ :param pulumi.Input[int] hardware_version: The hardware version for the virtual machine.
1368
+ :param pulumi.Input[str] host_system_id: The ID of an optional host system to pin the virtual machine to.
1369
+ :param pulumi.Input[str] hv_mode: The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
1370
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an IP
1429
1371
  :param pulumi.Input[bool] imported: Indicates if the virtual machine resource has been imported, or if the state has been migrated from a previous version of the resource. It influences the behavior of the first post-import apply operation. See the section on importing below.
1430
- :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
1431
-
1432
- > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
1433
- :param pulumi.Input[int] memory: The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
1434
- :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to the virtual machine while it is powered on.
1435
-
1436
- > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
1437
-
1438
- [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
1439
-
1440
- > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
1441
-
1442
- [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
1443
- :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
1444
- :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
1445
- :param pulumi.Input[int] memory_share_count: The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
1446
- :param pulumi.Input[str] memory_share_level: The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
1447
- :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
1372
+ :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
1373
+ latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
1374
+ devices. Can be one of low, normal, medium, or high.
1375
+ :param pulumi.Input[int] memory: The size of the virtual machine's memory, in MB.
1376
+ :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to this virtual machine while it is running.
1377
+ :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
1378
+ resources.
1379
+ :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
1380
+ :param pulumi.Input[bool] memory_reservation_locked_to_max: If set true, memory resource reservation for this virtual machine will always be equal to the virtual machine's memory
1381
+ size;increases in memory size will be rejected when a corresponding reservation increase is not possible. This feature
1382
+ may only be enabled if it is currently possible to reserve all of the virtual machine's memory.
1383
+ :param pulumi.Input[int] memory_share_count: The amount of shares to allocate to memory for a custom share level.
1384
+ :param pulumi.Input[str] memory_share_level: The allocation level for memory resources. Can be one of high, low, normal, or custom.
1385
+ :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
1448
1386
  :param pulumi.Input[str] moid: The managed object reference ID of the created virtual machine.
1449
- :param pulumi.Input[str] name: The name of the virtual machine.
1450
- :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
1451
- :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineNetworkInterfaceArgs']]] network_interfaces: A specification for a virtual NIC on the virtual machine. See network interface options for more information.
1452
- :param pulumi.Input[int] num_cores_per_socket: The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
1453
- :param pulumi.Input[int] num_cpus: The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
1454
- :param pulumi.Input['VirtualMachineOvfDeployArgs'] ovf_deploy: When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
1455
- :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: List of host PCI device IDs in which to create PCI passthroughs.
1456
-
1457
- > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
1387
+ :param pulumi.Input[str] name: The name of this virtual machine.
1388
+ :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
1389
+ :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineNetworkInterfaceArgs']]] network_interfaces: A specification for a virtual NIC on this virtual machine.
1390
+ :param pulumi.Input[int] num_cores_per_socket: The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
1391
+ must be evenly divisible by this value.
1392
+ :param pulumi.Input[int] num_cpus: The number of virtual processors to assign to this virtual machine.
1393
+ :param pulumi.Input['VirtualMachineOvfDeployArgs'] ovf_deploy: A specification for deploying a virtual machine from ovf/ova template.
1394
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: A list of PCI passthrough devices
1458
1395
  :param pulumi.Input[str] power_state: A computed value for the current power state of the virtual machine. One of `on`, `off`, or `suspended`.
1459
1396
  :param pulumi.Input[int] poweron_timeout: The amount of time, in seconds, that we will be trying to power on a VM
1460
- :param pulumi.Input[bool] reboot_required: Value internal to Terraform used to determine if a configuration set change requires a reboot.
1461
1397
  :param pulumi.Input[str] replace_trigger: Triggers replacement of resource whenever it changes.
1462
-
1463
- For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
1464
- :param pulumi.Input[str] resource_pool_id: The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
1465
-
1466
- > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
1467
- :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
1468
- :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
1469
- :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
1470
- :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
1471
- :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
1472
- :param pulumi.Input[int] sata_controller_count: The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
1473
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
1474
- controllers.
1475
- :param pulumi.Input[str] scsi_bus_sharing: The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
1476
- :param pulumi.Input[int] scsi_controller_count: The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
1477
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
1478
- controllers.
1479
- :param pulumi.Input[str] scsi_type: The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
1480
- :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
1481
- :param pulumi.Input[str] storage_policy_id: The UUID of the storage policy to assign to the virtual disk.
1482
- :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
1483
- :param pulumi.Input[bool] sync_time_with_host: Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `false`.
1484
- :param pulumi.Input[bool] sync_time_with_host_periodically: Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
1485
- :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
1486
-
1487
- > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
1488
- :param pulumi.Input[str] tools_upgrade_policy: Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
1489
- :param pulumi.Input[str] uuid: The UUID of the virtual disk VMDK file. This is used to track the virtual disk on the virtual machine.
1490
- :param pulumi.Input['VirtualMachineVappArgs'] vapp: Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
1398
+ :param pulumi.Input[str] resource_pool_id: The ID of a resource pool to put the virtual machine in.
1399
+ :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
1400
+ :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
1401
+ :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
1402
+ :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
1403
+ :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable the run of scripts before guest operating system standby when VMware Tools is installed.
1404
+ :param pulumi.Input[str] scsi_bus_sharing: Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
1405
+ :param pulumi.Input[str] scsi_type: The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
1406
+ :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
1407
+ :param pulumi.Input[str] storage_policy_id: The ID of the storage policy to assign to the virtual machine home directory.
1408
+ :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
1409
+ :param pulumi.Input[bool] sync_time_with_host: Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
1410
+ synchronized on startup and resume. Requires VMware Tools to be installed.
1411
+ :param pulumi.Input[bool] sync_time_with_host_periodically: Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
1412
+ setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
1413
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tag IDs to apply to this object.
1414
+ :param pulumi.Input[str] tools_upgrade_policy: Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
1415
+ :param pulumi.Input[str] uuid: The UUID of the virtual machine. Also exposed as the `id` of the resource.
1416
+ :param pulumi.Input['VirtualMachineVappArgs'] vapp: vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
1491
1417
  :param pulumi.Input[Sequence[pulumi.Input[str]]] vapp_transports: Computed value which is only valid for cloned virtual machines. A list of vApp transport methods supported by the source virtual machine or template.
1492
- :param pulumi.Input[bool] vbs_enabled: Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
1418
+ :param pulumi.Input[bool] vbs_enabled: Flag to specify if Virtualization-based security is enabled for this virtual machine.
1493
1419
  :param pulumi.Input[str] vmware_tools_status: The state of VMware Tools in the guest. This will determine the proper course of action for some device operations.
1494
1420
  :param pulumi.Input[str] vmx_path: The path of the virtual machine configuration file on the datastore in which the virtual machine is placed.
1495
- :param pulumi.Input[bool] vvtd_enabled: Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
1496
- :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
1497
- :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
1498
- :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
1421
+ :param pulumi.Input[bool] vvtd_enabled: Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
1422
+ I/O Virtualization (AMD-Vi or IOMMU), is enabled.
1423
+ :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
1424
+ disables the waiter.
1425
+ :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
1426
+ a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
1427
+ :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
1428
+ disables the waiter.
1499
1429
  """
1500
1430
  if alternate_guest_name is not None:
1501
1431
  pulumi.set(__self__, "alternate_guest_name", alternate_guest_name)
@@ -1583,6 +1513,8 @@ class _VirtualMachineState:
1583
1513
  pulumi.set(__self__, "memory_limit", memory_limit)
1584
1514
  if memory_reservation is not None:
1585
1515
  pulumi.set(__self__, "memory_reservation", memory_reservation)
1516
+ if memory_reservation_locked_to_max is not None:
1517
+ pulumi.set(__self__, "memory_reservation_locked_to_max", memory_reservation_locked_to_max)
1586
1518
  if memory_share_count is not None:
1587
1519
  pulumi.set(__self__, "memory_share_count", memory_share_count)
1588
1520
  if memory_share_level is not None:
@@ -1672,7 +1604,7 @@ class _VirtualMachineState:
1672
1604
  @pulumi.getter(name="alternateGuestName")
1673
1605
  def alternate_guest_name(self) -> Optional[pulumi.Input[str]]:
1674
1606
  """
1675
- The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
1607
+ The guest name for the operating system when guest_id is otherGuest or otherGuest64.
1676
1608
  """
1677
1609
  return pulumi.get(self, "alternate_guest_name")
1678
1610
 
@@ -1684,7 +1616,7 @@ class _VirtualMachineState:
1684
1616
  @pulumi.getter
1685
1617
  def annotation(self) -> Optional[pulumi.Input[str]]:
1686
1618
  """
1687
- A user-provided description of the virtual machine.
1619
+ User-provided description of the virtual machine.
1688
1620
  """
1689
1621
  return pulumi.get(self, "annotation")
1690
1622
 
@@ -1696,7 +1628,7 @@ class _VirtualMachineState:
1696
1628
  @pulumi.getter(name="bootDelay")
1697
1629
  def boot_delay(self) -> Optional[pulumi.Input[int]]:
1698
1630
  """
1699
- The number of milliseconds to wait before starting the boot sequence. The default is no delay.
1631
+ The number of milliseconds to wait before starting the boot sequence.
1700
1632
  """
1701
1633
  return pulumi.get(self, "boot_delay")
1702
1634
 
@@ -1708,7 +1640,7 @@ class _VirtualMachineState:
1708
1640
  @pulumi.getter(name="bootRetryDelay")
1709
1641
  def boot_retry_delay(self) -> Optional[pulumi.Input[int]]:
1710
1642
  """
1711
- The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
1643
+ The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
1712
1644
  """
1713
1645
  return pulumi.get(self, "boot_retry_delay")
1714
1646
 
@@ -1720,7 +1652,7 @@ class _VirtualMachineState:
1720
1652
  @pulumi.getter(name="bootRetryEnabled")
1721
1653
  def boot_retry_enabled(self) -> Optional[pulumi.Input[bool]]:
1722
1654
  """
1723
- If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
1655
+ If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
1724
1656
  """
1725
1657
  return pulumi.get(self, "boot_retry_enabled")
1726
1658
 
@@ -1732,7 +1664,7 @@ class _VirtualMachineState:
1732
1664
  @pulumi.getter
1733
1665
  def cdroms(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['VirtualMachineCdromArgs']]]]:
1734
1666
  """
1735
- A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
1667
+ A specification for a CDROM device on this virtual machine.
1736
1668
  """
1737
1669
  return pulumi.get(self, "cdroms")
1738
1670
 
@@ -1756,7 +1688,7 @@ class _VirtualMachineState:
1756
1688
  @pulumi.getter
1757
1689
  def clone(self) -> Optional[pulumi.Input['VirtualMachineCloneArgs']]:
1758
1690
  """
1759
- When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
1691
+ A specification for cloning a virtual machine from template.
1760
1692
  """
1761
1693
  return pulumi.get(self, "clone")
1762
1694
 
@@ -1768,7 +1700,7 @@ class _VirtualMachineState:
1768
1700
  @pulumi.getter(name="cpuHotAddEnabled")
1769
1701
  def cpu_hot_add_enabled(self) -> Optional[pulumi.Input[bool]]:
1770
1702
  """
1771
- Allow CPUs to be added to the virtual machine while it is powered on.
1703
+ Allow CPUs to be added to this virtual machine while it is running.
1772
1704
  """
1773
1705
  return pulumi.get(self, "cpu_hot_add_enabled")
1774
1706
 
@@ -1780,7 +1712,7 @@ class _VirtualMachineState:
1780
1712
  @pulumi.getter(name="cpuHotRemoveEnabled")
1781
1713
  def cpu_hot_remove_enabled(self) -> Optional[pulumi.Input[bool]]:
1782
1714
  """
1783
- Allow CPUs to be removed to the virtual machine while it is powered on.
1715
+ Allow CPUs to be added to this virtual machine while it is running.
1784
1716
  """
1785
1717
  return pulumi.get(self, "cpu_hot_remove_enabled")
1786
1718
 
@@ -1792,7 +1724,8 @@ class _VirtualMachineState:
1792
1724
  @pulumi.getter(name="cpuLimit")
1793
1725
  def cpu_limit(self) -> Optional[pulumi.Input[int]]:
1794
1726
  """
1795
- The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
1727
+ The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
1728
+ resources.
1796
1729
  """
1797
1730
  return pulumi.get(self, "cpu_limit")
1798
1731
 
@@ -1804,7 +1737,7 @@ class _VirtualMachineState:
1804
1737
  @pulumi.getter(name="cpuPerformanceCountersEnabled")
1805
1738
  def cpu_performance_counters_enabled(self) -> Optional[pulumi.Input[bool]]:
1806
1739
  """
1807
- Enable CPU performance counters on the virtual machine. Default: `false`.
1740
+ Enable CPU performance counters on this virtual machine.
1808
1741
  """
1809
1742
  return pulumi.get(self, "cpu_performance_counters_enabled")
1810
1743
 
@@ -1816,7 +1749,7 @@ class _VirtualMachineState:
1816
1749
  @pulumi.getter(name="cpuReservation")
1817
1750
  def cpu_reservation(self) -> Optional[pulumi.Input[int]]:
1818
1751
  """
1819
- The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
1752
+ The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
1820
1753
  """
1821
1754
  return pulumi.get(self, "cpu_reservation")
1822
1755
 
@@ -1828,7 +1761,7 @@ class _VirtualMachineState:
1828
1761
  @pulumi.getter(name="cpuShareCount")
1829
1762
  def cpu_share_count(self) -> Optional[pulumi.Input[int]]:
1830
1763
  """
1831
- The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
1764
+ The amount of shares to allocate to cpu for a custom share level.
1832
1765
  """
1833
1766
  return pulumi.get(self, "cpu_share_count")
1834
1767
 
@@ -1840,7 +1773,7 @@ class _VirtualMachineState:
1840
1773
  @pulumi.getter(name="cpuShareLevel")
1841
1774
  def cpu_share_level(self) -> Optional[pulumi.Input[str]]:
1842
1775
  """
1843
- The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
1776
+ The allocation level for cpu resources. Can be one of high, low, normal, or custom.
1844
1777
  """
1845
1778
  return pulumi.get(self, "cpu_share_level")
1846
1779
 
@@ -1852,9 +1785,7 @@ class _VirtualMachineState:
1852
1785
  @pulumi.getter(name="customAttributes")
1853
1786
  def custom_attributes(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
1854
1787
  """
1855
- Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
1856
-
1857
- > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
1788
+ A list of custom attributes to set on this resource.
1858
1789
  """
1859
1790
  return pulumi.get(self, "custom_attributes")
1860
1791
 
@@ -1866,7 +1797,7 @@ class _VirtualMachineState:
1866
1797
  @pulumi.getter(name="datacenterId")
1867
1798
  def datacenter_id(self) -> Optional[pulumi.Input[str]]:
1868
1799
  """
1869
- The datacenter ID. Required only when deploying an OVF/OVA template.
1800
+ The ID of the datacenter where the VM is to be created.
1870
1801
  """
1871
1802
  return pulumi.get(self, "datacenter_id")
1872
1803
 
@@ -1878,13 +1809,7 @@ class _VirtualMachineState:
1878
1809
  @pulumi.getter(name="datastoreClusterId")
1879
1810
  def datastore_cluster_id(self) -> Optional[pulumi.Input[str]]:
1880
1811
  """
1881
- The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
1882
-
1883
- > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
1884
-
1885
- > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
1886
-
1887
- > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
1812
+ The ID of a datastore cluster to put the virtual machine in.
1888
1813
  """
1889
1814
  return pulumi.get(self, "datastore_cluster_id")
1890
1815
 
@@ -1896,7 +1821,8 @@ class _VirtualMachineState:
1896
1821
  @pulumi.getter(name="datastoreId")
1897
1822
  def datastore_id(self) -> Optional[pulumi.Input[str]]:
1898
1823
  """
1899
- The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
1824
+ The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
1825
+ disks that are created without datastores.
1900
1826
  """
1901
1827
  return pulumi.get(self, "datastore_id")
1902
1828
 
@@ -1920,7 +1846,7 @@ class _VirtualMachineState:
1920
1846
  @pulumi.getter
1921
1847
  def disks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['VirtualMachineDiskArgs']]]]:
1922
1848
  """
1923
- A specification for a virtual disk device on the virtual machine. See disk options for more information.
1849
+ A specification for a virtual disk device on this virtual machine.
1924
1850
  """
1925
1851
  return pulumi.get(self, "disks")
1926
1852
 
@@ -1932,9 +1858,7 @@ class _VirtualMachineState:
1932
1858
  @pulumi.getter(name="efiSecureBootEnabled")
1933
1859
  def efi_secure_boot_enabled(self) -> Optional[pulumi.Input[bool]]:
1934
1860
  """
1935
- Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
1936
-
1937
- > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
1861
+ When the boot type set in firmware is efi, this enables EFI secure boot.
1938
1862
  """
1939
1863
  return pulumi.get(self, "efi_secure_boot_enabled")
1940
1864
 
@@ -1946,7 +1870,7 @@ class _VirtualMachineState:
1946
1870
  @pulumi.getter(name="enableDiskUuid")
1947
1871
  def enable_disk_uuid(self) -> Optional[pulumi.Input[bool]]:
1948
1872
  """
1949
- Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
1873
+ Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
1950
1874
  """
1951
1875
  return pulumi.get(self, "enable_disk_uuid")
1952
1876
 
@@ -1958,7 +1882,7 @@ class _VirtualMachineState:
1958
1882
  @pulumi.getter(name="enableLogging")
1959
1883
  def enable_logging(self) -> Optional[pulumi.Input[bool]]:
1960
1884
  """
1961
- Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
1885
+ Enable logging on this virtual machine.
1962
1886
  """
1963
1887
  return pulumi.get(self, "enable_logging")
1964
1888
 
@@ -1970,7 +1894,7 @@ class _VirtualMachineState:
1970
1894
  @pulumi.getter(name="eptRviMode")
1971
1895
  def ept_rvi_mode(self) -> Optional[pulumi.Input[str]]:
1972
1896
  """
1973
- The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
1897
+ The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
1974
1898
  """
1975
1899
  return pulumi.get(self, "ept_rvi_mode")
1976
1900
 
@@ -1982,9 +1906,8 @@ class _VirtualMachineState:
1982
1906
  @pulumi.getter(name="extraConfig")
1983
1907
  def extra_config(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
1984
1908
  """
1985
- Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
1986
-
1987
- > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
1909
+ Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
1910
+ configuration, such as instance metadata, or configuration data for OVF images.
1988
1911
  """
1989
1912
  return pulumi.get(self, "extra_config")
1990
1913
 
@@ -1996,7 +1919,7 @@ class _VirtualMachineState:
1996
1919
  @pulumi.getter(name="extraConfigRebootRequired")
1997
1920
  def extra_config_reboot_required(self) -> Optional[pulumi.Input[bool]]:
1998
1921
  """
1999
- Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
1922
+ Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
2000
1923
  """
2001
1924
  return pulumi.get(self, "extra_config_reboot_required")
2002
1925
 
@@ -2008,7 +1931,7 @@ class _VirtualMachineState:
2008
1931
  @pulumi.getter
2009
1932
  def firmware(self) -> Optional[pulumi.Input[str]]:
2010
1933
  """
2011
- The firmware for the virtual machine. One of `bios` or `efi`.
1934
+ The firmware interface to use on the virtual machine. Can be one of bios or efi.
2012
1935
  """
2013
1936
  return pulumi.get(self, "firmware")
2014
1937
 
@@ -2020,7 +1943,7 @@ class _VirtualMachineState:
2020
1943
  @pulumi.getter
2021
1944
  def folder(self) -> Optional[pulumi.Input[str]]:
2022
1945
  """
2023
- The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`). For example, `/dc-01/vm/foo`
1946
+ The name of the folder to locate the virtual machine in.
2024
1947
  """
2025
1948
  return pulumi.get(self, "folder")
2026
1949
 
@@ -2032,7 +1955,7 @@ class _VirtualMachineState:
2032
1955
  @pulumi.getter(name="forcePowerOff")
2033
1956
  def force_power_off(self) -> Optional[pulumi.Input[bool]]:
2034
1957
  """
2035
- If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
1958
+ Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
2036
1959
  """
2037
1960
  return pulumi.get(self, "force_power_off")
2038
1961
 
@@ -2044,9 +1967,7 @@ class _VirtualMachineState:
2044
1967
  @pulumi.getter(name="guestId")
2045
1968
  def guest_id(self) -> Optional[pulumi.Input[str]]:
2046
1969
  """
2047
- The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
2048
-
2049
- [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
1970
+ The guest ID for the operating system.
2050
1971
  """
2051
1972
  return pulumi.get(self, "guest_id")
2052
1973
 
@@ -2070,10 +1991,7 @@ class _VirtualMachineState:
2070
1991
  @pulumi.getter(name="hardwareVersion")
2071
1992
  def hardware_version(self) -> Optional[pulumi.Input[int]]:
2072
1993
  """
2073
- The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
2074
-
2075
- [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
2076
- [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
1994
+ The hardware version for the virtual machine.
2077
1995
  """
2078
1996
  return pulumi.get(self, "hardware_version")
2079
1997
 
@@ -2085,7 +2003,7 @@ class _VirtualMachineState:
2085
2003
  @pulumi.getter(name="hostSystemId")
2086
2004
  def host_system_id(self) -> Optional[pulumi.Input[str]]:
2087
2005
  """
2088
- The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
2006
+ The ID of an optional host system to pin the virtual machine to.
2089
2007
  """
2090
2008
  return pulumi.get(self, "host_system_id")
2091
2009
 
@@ -2097,7 +2015,7 @@ class _VirtualMachineState:
2097
2015
  @pulumi.getter(name="hvMode")
2098
2016
  def hv_mode(self) -> Optional[pulumi.Input[str]]:
2099
2017
  """
2100
- The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
2018
+ The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
2101
2019
  """
2102
2020
  return pulumi.get(self, "hv_mode")
2103
2021
 
@@ -2108,9 +2026,6 @@ class _VirtualMachineState:
2108
2026
  @property
2109
2027
  @pulumi.getter(name="ideControllerCount")
2110
2028
  def ide_controller_count(self) -> Optional[pulumi.Input[int]]:
2111
- """
2112
- The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
2113
- """
2114
2029
  return pulumi.get(self, "ide_controller_count")
2115
2030
 
2116
2031
  @ide_controller_count.setter
@@ -2121,7 +2036,7 @@ class _VirtualMachineState:
2121
2036
  @pulumi.getter(name="ignoredGuestIps")
2122
2037
  def ignored_guest_ips(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
2123
2038
  """
2124
- List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
2039
+ List of IP addresses and CIDR networks to ignore while waiting for an IP
2125
2040
  """
2126
2041
  return pulumi.get(self, "ignored_guest_ips")
2127
2042
 
@@ -2145,9 +2060,9 @@ class _VirtualMachineState:
2145
2060
  @pulumi.getter(name="latencySensitivity")
2146
2061
  def latency_sensitivity(self) -> Optional[pulumi.Input[str]]:
2147
2062
  """
2148
- Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
2149
-
2150
- > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
2063
+ Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
2064
+ latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
2065
+ devices. Can be one of low, normal, medium, or high.
2151
2066
  """
2152
2067
  return pulumi.get(self, "latency_sensitivity")
2153
2068
 
@@ -2159,7 +2074,7 @@ class _VirtualMachineState:
2159
2074
  @pulumi.getter
2160
2075
  def memory(self) -> Optional[pulumi.Input[int]]:
2161
2076
  """
2162
- The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
2077
+ The size of the virtual machine's memory, in MB.
2163
2078
  """
2164
2079
  return pulumi.get(self, "memory")
2165
2080
 
@@ -2171,15 +2086,7 @@ class _VirtualMachineState:
2171
2086
  @pulumi.getter(name="memoryHotAddEnabled")
2172
2087
  def memory_hot_add_enabled(self) -> Optional[pulumi.Input[bool]]:
2173
2088
  """
2174
- Allow memory to be added to the virtual machine while it is powered on.
2175
-
2176
- > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
2177
-
2178
- [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
2179
-
2180
- > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
2181
-
2182
- [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
2089
+ Allow memory to be added to this virtual machine while it is running.
2183
2090
  """
2184
2091
  return pulumi.get(self, "memory_hot_add_enabled")
2185
2092
 
@@ -2191,7 +2098,8 @@ class _VirtualMachineState:
2191
2098
  @pulumi.getter(name="memoryLimit")
2192
2099
  def memory_limit(self) -> Optional[pulumi.Input[int]]:
2193
2100
  """
2194
- The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
2101
+ The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
2102
+ resources.
2195
2103
  """
2196
2104
  return pulumi.get(self, "memory_limit")
2197
2105
 
@@ -2203,7 +2111,7 @@ class _VirtualMachineState:
2203
2111
  @pulumi.getter(name="memoryReservation")
2204
2112
  def memory_reservation(self) -> Optional[pulumi.Input[int]]:
2205
2113
  """
2206
- The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
2114
+ The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
2207
2115
  """
2208
2116
  return pulumi.get(self, "memory_reservation")
2209
2117
 
@@ -2211,11 +2119,25 @@ class _VirtualMachineState:
2211
2119
  def memory_reservation(self, value: Optional[pulumi.Input[int]]):
2212
2120
  pulumi.set(self, "memory_reservation", value)
2213
2121
 
2122
+ @property
2123
+ @pulumi.getter(name="memoryReservationLockedToMax")
2124
+ def memory_reservation_locked_to_max(self) -> Optional[pulumi.Input[bool]]:
2125
+ """
2126
+ If set true, memory resource reservation for this virtual machine will always be equal to the virtual machine's memory
2127
+ size;increases in memory size will be rejected when a corresponding reservation increase is not possible. This feature
2128
+ may only be enabled if it is currently possible to reserve all of the virtual machine's memory.
2129
+ """
2130
+ return pulumi.get(self, "memory_reservation_locked_to_max")
2131
+
2132
+ @memory_reservation_locked_to_max.setter
2133
+ def memory_reservation_locked_to_max(self, value: Optional[pulumi.Input[bool]]):
2134
+ pulumi.set(self, "memory_reservation_locked_to_max", value)
2135
+
2214
2136
  @property
2215
2137
  @pulumi.getter(name="memoryShareCount")
2216
2138
  def memory_share_count(self) -> Optional[pulumi.Input[int]]:
2217
2139
  """
2218
- The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
2140
+ The amount of shares to allocate to memory for a custom share level.
2219
2141
  """
2220
2142
  return pulumi.get(self, "memory_share_count")
2221
2143
 
@@ -2227,7 +2149,7 @@ class _VirtualMachineState:
2227
2149
  @pulumi.getter(name="memoryShareLevel")
2228
2150
  def memory_share_level(self) -> Optional[pulumi.Input[str]]:
2229
2151
  """
2230
- The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
2152
+ The allocation level for memory resources. Can be one of high, low, normal, or custom.
2231
2153
  """
2232
2154
  return pulumi.get(self, "memory_share_level")
2233
2155
 
@@ -2239,7 +2161,7 @@ class _VirtualMachineState:
2239
2161
  @pulumi.getter(name="migrateWaitTimeout")
2240
2162
  def migrate_wait_timeout(self) -> Optional[pulumi.Input[int]]:
2241
2163
  """
2242
- The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
2164
+ The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
2243
2165
  """
2244
2166
  return pulumi.get(self, "migrate_wait_timeout")
2245
2167
 
@@ -2263,7 +2185,7 @@ class _VirtualMachineState:
2263
2185
  @pulumi.getter
2264
2186
  def name(self) -> Optional[pulumi.Input[str]]:
2265
2187
  """
2266
- The name of the virtual machine.
2188
+ The name of this virtual machine.
2267
2189
  """
2268
2190
  return pulumi.get(self, "name")
2269
2191
 
@@ -2275,7 +2197,7 @@ class _VirtualMachineState:
2275
2197
  @pulumi.getter(name="nestedHvEnabled")
2276
2198
  def nested_hv_enabled(self) -> Optional[pulumi.Input[bool]]:
2277
2199
  """
2278
- Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
2200
+ Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
2279
2201
  """
2280
2202
  return pulumi.get(self, "nested_hv_enabled")
2281
2203
 
@@ -2287,7 +2209,7 @@ class _VirtualMachineState:
2287
2209
  @pulumi.getter(name="networkInterfaces")
2288
2210
  def network_interfaces(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['VirtualMachineNetworkInterfaceArgs']]]]:
2289
2211
  """
2290
- A specification for a virtual NIC on the virtual machine. See network interface options for more information.
2212
+ A specification for a virtual NIC on this virtual machine.
2291
2213
  """
2292
2214
  return pulumi.get(self, "network_interfaces")
2293
2215
 
@@ -2299,7 +2221,8 @@ class _VirtualMachineState:
2299
2221
  @pulumi.getter(name="numCoresPerSocket")
2300
2222
  def num_cores_per_socket(self) -> Optional[pulumi.Input[int]]:
2301
2223
  """
2302
- The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
2224
+ The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
2225
+ must be evenly divisible by this value.
2303
2226
  """
2304
2227
  return pulumi.get(self, "num_cores_per_socket")
2305
2228
 
@@ -2311,7 +2234,7 @@ class _VirtualMachineState:
2311
2234
  @pulumi.getter(name="numCpus")
2312
2235
  def num_cpus(self) -> Optional[pulumi.Input[int]]:
2313
2236
  """
2314
- The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
2237
+ The number of virtual processors to assign to this virtual machine.
2315
2238
  """
2316
2239
  return pulumi.get(self, "num_cpus")
2317
2240
 
@@ -2323,7 +2246,7 @@ class _VirtualMachineState:
2323
2246
  @pulumi.getter(name="ovfDeploy")
2324
2247
  def ovf_deploy(self) -> Optional[pulumi.Input['VirtualMachineOvfDeployArgs']]:
2325
2248
  """
2326
- When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
2249
+ A specification for deploying a virtual machine from ovf/ova template.
2327
2250
  """
2328
2251
  return pulumi.get(self, "ovf_deploy")
2329
2252
 
@@ -2335,9 +2258,7 @@ class _VirtualMachineState:
2335
2258
  @pulumi.getter(name="pciDeviceIds")
2336
2259
  def pci_device_ids(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
2337
2260
  """
2338
- List of host PCI device IDs in which to create PCI passthroughs.
2339
-
2340
- > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
2261
+ A list of PCI passthrough devices
2341
2262
  """
2342
2263
  return pulumi.get(self, "pci_device_ids")
2343
2264
 
@@ -2372,9 +2293,6 @@ class _VirtualMachineState:
2372
2293
  @property
2373
2294
  @pulumi.getter(name="rebootRequired")
2374
2295
  def reboot_required(self) -> Optional[pulumi.Input[bool]]:
2375
- """
2376
- Value internal to Terraform used to determine if a configuration set change requires a reboot.
2377
- """
2378
2296
  return pulumi.get(self, "reboot_required")
2379
2297
 
2380
2298
  @reboot_required.setter
@@ -2386,8 +2304,6 @@ class _VirtualMachineState:
2386
2304
  def replace_trigger(self) -> Optional[pulumi.Input[str]]:
2387
2305
  """
2388
2306
  Triggers replacement of resource whenever it changes.
2389
-
2390
- For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
2391
2307
  """
2392
2308
  return pulumi.get(self, "replace_trigger")
2393
2309
 
@@ -2399,9 +2315,7 @@ class _VirtualMachineState:
2399
2315
  @pulumi.getter(name="resourcePoolId")
2400
2316
  def resource_pool_id(self) -> Optional[pulumi.Input[str]]:
2401
2317
  """
2402
- The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
2403
-
2404
- > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
2318
+ The ID of a resource pool to put the virtual machine in.
2405
2319
  """
2406
2320
  return pulumi.get(self, "resource_pool_id")
2407
2321
 
@@ -2413,7 +2327,7 @@ class _VirtualMachineState:
2413
2327
  @pulumi.getter(name="runToolsScriptsAfterPowerOn")
2414
2328
  def run_tools_scripts_after_power_on(self) -> Optional[pulumi.Input[bool]]:
2415
2329
  """
2416
- Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
2330
+ Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
2417
2331
  """
2418
2332
  return pulumi.get(self, "run_tools_scripts_after_power_on")
2419
2333
 
@@ -2425,7 +2339,7 @@ class _VirtualMachineState:
2425
2339
  @pulumi.getter(name="runToolsScriptsAfterResume")
2426
2340
  def run_tools_scripts_after_resume(self) -> Optional[pulumi.Input[bool]]:
2427
2341
  """
2428
- Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
2342
+ Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
2429
2343
  """
2430
2344
  return pulumi.get(self, "run_tools_scripts_after_resume")
2431
2345
 
@@ -2437,7 +2351,7 @@ class _VirtualMachineState:
2437
2351
  @pulumi.getter(name="runToolsScriptsBeforeGuestReboot")
2438
2352
  def run_tools_scripts_before_guest_reboot(self) -> Optional[pulumi.Input[bool]]:
2439
2353
  """
2440
- Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
2354
+ Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
2441
2355
  """
2442
2356
  return pulumi.get(self, "run_tools_scripts_before_guest_reboot")
2443
2357
 
@@ -2449,7 +2363,7 @@ class _VirtualMachineState:
2449
2363
  @pulumi.getter(name="runToolsScriptsBeforeGuestShutdown")
2450
2364
  def run_tools_scripts_before_guest_shutdown(self) -> Optional[pulumi.Input[bool]]:
2451
2365
  """
2452
- Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
2366
+ Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
2453
2367
  """
2454
2368
  return pulumi.get(self, "run_tools_scripts_before_guest_shutdown")
2455
2369
 
@@ -2461,7 +2375,7 @@ class _VirtualMachineState:
2461
2375
  @pulumi.getter(name="runToolsScriptsBeforeGuestStandby")
2462
2376
  def run_tools_scripts_before_guest_standby(self) -> Optional[pulumi.Input[bool]]:
2463
2377
  """
2464
- Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
2378
+ Enable the run of scripts before guest operating system standby when VMware Tools is installed.
2465
2379
  """
2466
2380
  return pulumi.get(self, "run_tools_scripts_before_guest_standby")
2467
2381
 
@@ -2472,11 +2386,6 @@ class _VirtualMachineState:
2472
2386
  @property
2473
2387
  @pulumi.getter(name="sataControllerCount")
2474
2388
  def sata_controller_count(self) -> Optional[pulumi.Input[int]]:
2475
- """
2476
- The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
2477
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
2478
- controllers.
2479
- """
2480
2389
  return pulumi.get(self, "sata_controller_count")
2481
2390
 
2482
2391
  @sata_controller_count.setter
@@ -2487,7 +2396,7 @@ class _VirtualMachineState:
2487
2396
  @pulumi.getter(name="scsiBusSharing")
2488
2397
  def scsi_bus_sharing(self) -> Optional[pulumi.Input[str]]:
2489
2398
  """
2490
- The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
2399
+ Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
2491
2400
  """
2492
2401
  return pulumi.get(self, "scsi_bus_sharing")
2493
2402
 
@@ -2498,11 +2407,6 @@ class _VirtualMachineState:
2498
2407
  @property
2499
2408
  @pulumi.getter(name="scsiControllerCount")
2500
2409
  def scsi_controller_count(self) -> Optional[pulumi.Input[int]]:
2501
- """
2502
- The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
2503
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
2504
- controllers.
2505
- """
2506
2410
  return pulumi.get(self, "scsi_controller_count")
2507
2411
 
2508
2412
  @scsi_controller_count.setter
@@ -2513,7 +2417,7 @@ class _VirtualMachineState:
2513
2417
  @pulumi.getter(name="scsiType")
2514
2418
  def scsi_type(self) -> Optional[pulumi.Input[str]]:
2515
2419
  """
2516
- The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
2420
+ The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
2517
2421
  """
2518
2422
  return pulumi.get(self, "scsi_type")
2519
2423
 
@@ -2525,7 +2429,7 @@ class _VirtualMachineState:
2525
2429
  @pulumi.getter(name="shutdownWaitTimeout")
2526
2430
  def shutdown_wait_timeout(self) -> Optional[pulumi.Input[int]]:
2527
2431
  """
2528
- The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
2432
+ The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
2529
2433
  """
2530
2434
  return pulumi.get(self, "shutdown_wait_timeout")
2531
2435
 
@@ -2537,7 +2441,7 @@ class _VirtualMachineState:
2537
2441
  @pulumi.getter(name="storagePolicyId")
2538
2442
  def storage_policy_id(self) -> Optional[pulumi.Input[str]]:
2539
2443
  """
2540
- The UUID of the storage policy to assign to the virtual disk.
2444
+ The ID of the storage policy to assign to the virtual machine home directory.
2541
2445
  """
2542
2446
  return pulumi.get(self, "storage_policy_id")
2543
2447
 
@@ -2549,7 +2453,7 @@ class _VirtualMachineState:
2549
2453
  @pulumi.getter(name="swapPlacementPolicy")
2550
2454
  def swap_placement_policy(self) -> Optional[pulumi.Input[str]]:
2551
2455
  """
2552
- The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
2456
+ The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
2553
2457
  """
2554
2458
  return pulumi.get(self, "swap_placement_policy")
2555
2459
 
@@ -2561,7 +2465,8 @@ class _VirtualMachineState:
2561
2465
  @pulumi.getter(name="syncTimeWithHost")
2562
2466
  def sync_time_with_host(self) -> Optional[pulumi.Input[bool]]:
2563
2467
  """
2564
- Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `false`.
2468
+ Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
2469
+ synchronized on startup and resume. Requires VMware Tools to be installed.
2565
2470
  """
2566
2471
  return pulumi.get(self, "sync_time_with_host")
2567
2472
 
@@ -2573,7 +2478,8 @@ class _VirtualMachineState:
2573
2478
  @pulumi.getter(name="syncTimeWithHostPeriodically")
2574
2479
  def sync_time_with_host_periodically(self) -> Optional[pulumi.Input[bool]]:
2575
2480
  """
2576
- Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
2481
+ Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
2482
+ setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
2577
2483
  """
2578
2484
  return pulumi.get(self, "sync_time_with_host_periodically")
2579
2485
 
@@ -2585,9 +2491,7 @@ class _VirtualMachineState:
2585
2491
  @pulumi.getter
2586
2492
  def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
2587
2493
  """
2588
- The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
2589
-
2590
- > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
2494
+ A list of tag IDs to apply to this object.
2591
2495
  """
2592
2496
  return pulumi.get(self, "tags")
2593
2497
 
@@ -2599,7 +2503,7 @@ class _VirtualMachineState:
2599
2503
  @pulumi.getter(name="toolsUpgradePolicy")
2600
2504
  def tools_upgrade_policy(self) -> Optional[pulumi.Input[str]]:
2601
2505
  """
2602
- Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
2506
+ Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
2603
2507
  """
2604
2508
  return pulumi.get(self, "tools_upgrade_policy")
2605
2509
 
@@ -2611,7 +2515,7 @@ class _VirtualMachineState:
2611
2515
  @pulumi.getter
2612
2516
  def uuid(self) -> Optional[pulumi.Input[str]]:
2613
2517
  """
2614
- The UUID of the virtual disk VMDK file. This is used to track the virtual disk on the virtual machine.
2518
+ The UUID of the virtual machine. Also exposed as the `id` of the resource.
2615
2519
  """
2616
2520
  return pulumi.get(self, "uuid")
2617
2521
 
@@ -2623,7 +2527,7 @@ class _VirtualMachineState:
2623
2527
  @pulumi.getter
2624
2528
  def vapp(self) -> Optional[pulumi.Input['VirtualMachineVappArgs']]:
2625
2529
  """
2626
- Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
2530
+ vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
2627
2531
  """
2628
2532
  return pulumi.get(self, "vapp")
2629
2533
 
@@ -2647,7 +2551,7 @@ class _VirtualMachineState:
2647
2551
  @pulumi.getter(name="vbsEnabled")
2648
2552
  def vbs_enabled(self) -> Optional[pulumi.Input[bool]]:
2649
2553
  """
2650
- Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
2554
+ Flag to specify if Virtualization-based security is enabled for this virtual machine.
2651
2555
  """
2652
2556
  return pulumi.get(self, "vbs_enabled")
2653
2557
 
@@ -2683,7 +2587,8 @@ class _VirtualMachineState:
2683
2587
  @pulumi.getter(name="vvtdEnabled")
2684
2588
  def vvtd_enabled(self) -> Optional[pulumi.Input[bool]]:
2685
2589
  """
2686
- Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
2590
+ Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
2591
+ I/O Virtualization (AMD-Vi or IOMMU), is enabled.
2687
2592
  """
2688
2593
  return pulumi.get(self, "vvtd_enabled")
2689
2594
 
@@ -2695,7 +2600,8 @@ class _VirtualMachineState:
2695
2600
  @pulumi.getter(name="waitForGuestIpTimeout")
2696
2601
  def wait_for_guest_ip_timeout(self) -> Optional[pulumi.Input[int]]:
2697
2602
  """
2698
- The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
2603
+ The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
2604
+ disables the waiter.
2699
2605
  """
2700
2606
  return pulumi.get(self, "wait_for_guest_ip_timeout")
2701
2607
 
@@ -2707,7 +2613,8 @@ class _VirtualMachineState:
2707
2613
  @pulumi.getter(name="waitForGuestNetRoutable")
2708
2614
  def wait_for_guest_net_routable(self) -> Optional[pulumi.Input[bool]]:
2709
2615
  """
2710
- Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
2616
+ Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
2617
+ a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
2711
2618
  """
2712
2619
  return pulumi.get(self, "wait_for_guest_net_routable")
2713
2620
 
@@ -2719,7 +2626,8 @@ class _VirtualMachineState:
2719
2626
  @pulumi.getter(name="waitForGuestNetTimeout")
2720
2627
  def wait_for_guest_net_timeout(self) -> Optional[pulumi.Input[int]]:
2721
2628
  """
2722
- The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
2629
+ The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
2630
+ disables the waiter.
2723
2631
  """
2724
2632
  return pulumi.get(self, "wait_for_guest_net_timeout")
2725
2633
 
@@ -2772,6 +2680,7 @@ class VirtualMachine(pulumi.CustomResource):
2772
2680
  memory_hot_add_enabled: Optional[pulumi.Input[bool]] = None,
2773
2681
  memory_limit: Optional[pulumi.Input[int]] = None,
2774
2682
  memory_reservation: Optional[pulumi.Input[int]] = None,
2683
+ memory_reservation_locked_to_max: Optional[pulumi.Input[bool]] = None,
2775
2684
  memory_share_count: Optional[pulumi.Input[int]] = None,
2776
2685
  memory_share_level: Optional[pulumi.Input[str]] = None,
2777
2686
  migrate_wait_timeout: Optional[pulumi.Input[int]] = None,
@@ -2812,119 +2721,93 @@ class VirtualMachine(pulumi.CustomResource):
2812
2721
  Create a VirtualMachine resource with the given unique name, props, and options.
2813
2722
  :param str resource_name: The name of the resource.
2814
2723
  :param pulumi.ResourceOptions opts: Options for the resource.
2815
- :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
2816
- :param pulumi.Input[str] annotation: A user-provided description of the virtual machine.
2817
- :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence. The default is no delay.
2818
- :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
2819
- :param pulumi.Input[bool] boot_retry_enabled: If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
2820
- :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineCdromArgs']]]] cdroms: A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
2821
- :param pulumi.Input[pulumi.InputType['VirtualMachineCloneArgs']] clone: When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
2822
- :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to the virtual machine while it is powered on.
2823
- :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be removed to the virtual machine while it is powered on.
2824
- :param pulumi.Input[int] cpu_limit: The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
2825
- :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on the virtual machine. Default: `false`.
2826
- :param pulumi.Input[int] cpu_reservation: The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
2827
- :param pulumi.Input[int] cpu_share_count: The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
2828
- :param pulumi.Input[str] cpu_share_level: The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
2829
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
2830
-
2831
- > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
2832
- :param pulumi.Input[str] datacenter_id: The datacenter ID. Required only when deploying an OVF/OVA template.
2833
- :param pulumi.Input[str] datastore_cluster_id: The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
2834
-
2835
- > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
2836
-
2837
- > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
2838
-
2839
- > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
2840
- :param pulumi.Input[str] datastore_id: The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
2841
- :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineDiskArgs']]]] disks: A specification for a virtual disk device on the virtual machine. See disk options for more information.
2842
- :param pulumi.Input[bool] efi_secure_boot_enabled: Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
2843
-
2844
- > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
2845
- :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
2846
- :param pulumi.Input[bool] enable_logging: Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
2847
- :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
2848
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
2849
-
2850
- > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
2851
- :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
2852
- :param pulumi.Input[str] firmware: The firmware for the virtual machine. One of `bios` or `efi`.
2853
- :param pulumi.Input[str] folder: The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`). For example, `/dc-01/vm/foo`
2854
- :param pulumi.Input[bool] force_power_off: If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
2855
- :param pulumi.Input[str] guest_id: The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
2856
-
2857
- [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
2858
- :param pulumi.Input[int] hardware_version: The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
2859
-
2860
- [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
2861
- [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
2862
- :param pulumi.Input[str] host_system_id: The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
2863
- :param pulumi.Input[str] hv_mode: The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
2864
- :param pulumi.Input[int] ide_controller_count: The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
2865
- :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
2866
- :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
2867
-
2868
- > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
2869
- :param pulumi.Input[int] memory: The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
2870
- :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to the virtual machine while it is powered on.
2871
-
2872
- > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
2873
-
2874
- [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
2875
-
2876
- > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
2877
-
2878
- [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
2879
- :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
2880
- :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
2881
- :param pulumi.Input[int] memory_share_count: The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
2882
- :param pulumi.Input[str] memory_share_level: The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
2883
- :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
2884
- :param pulumi.Input[str] name: The name of the virtual machine.
2885
- :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
2886
- :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineNetworkInterfaceArgs']]]] network_interfaces: A specification for a virtual NIC on the virtual machine. See network interface options for more information.
2887
- :param pulumi.Input[int] num_cores_per_socket: The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
2888
- :param pulumi.Input[int] num_cpus: The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
2889
- :param pulumi.Input[pulumi.InputType['VirtualMachineOvfDeployArgs']] ovf_deploy: When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
2890
- :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: List of host PCI device IDs in which to create PCI passthroughs.
2891
-
2892
- > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
2724
+ :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when guest_id is otherGuest or otherGuest64.
2725
+ :param pulumi.Input[str] annotation: User-provided description of the virtual machine.
2726
+ :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence.
2727
+ :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
2728
+ :param pulumi.Input[bool] boot_retry_enabled: If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
2729
+ :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineCdromArgs']]]] cdroms: A specification for a CDROM device on this virtual machine.
2730
+ :param pulumi.Input[pulumi.InputType['VirtualMachineCloneArgs']] clone: A specification for cloning a virtual machine from template.
2731
+ :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to this virtual machine while it is running.
2732
+ :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be added to this virtual machine while it is running.
2733
+ :param pulumi.Input[int] cpu_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
2734
+ resources.
2735
+ :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on this virtual machine.
2736
+ :param pulumi.Input[int] cpu_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
2737
+ :param pulumi.Input[int] cpu_share_count: The amount of shares to allocate to cpu for a custom share level.
2738
+ :param pulumi.Input[str] cpu_share_level: The allocation level for cpu resources. Can be one of high, low, normal, or custom.
2739
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: A list of custom attributes to set on this resource.
2740
+ :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VM is to be created.
2741
+ :param pulumi.Input[str] datastore_cluster_id: The ID of a datastore cluster to put the virtual machine in.
2742
+ :param pulumi.Input[str] datastore_id: The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
2743
+ disks that are created without datastores.
2744
+ :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineDiskArgs']]]] disks: A specification for a virtual disk device on this virtual machine.
2745
+ :param pulumi.Input[bool] efi_secure_boot_enabled: When the boot type set in firmware is efi, this enables EFI secure boot.
2746
+ :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
2747
+ :param pulumi.Input[bool] enable_logging: Enable logging on this virtual machine.
2748
+ :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
2749
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
2750
+ configuration, such as instance metadata, or configuration data for OVF images.
2751
+ :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
2752
+ :param pulumi.Input[str] firmware: The firmware interface to use on the virtual machine. Can be one of bios or efi.
2753
+ :param pulumi.Input[str] folder: The name of the folder to locate the virtual machine in.
2754
+ :param pulumi.Input[bool] force_power_off: Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
2755
+ :param pulumi.Input[str] guest_id: The guest ID for the operating system.
2756
+ :param pulumi.Input[int] hardware_version: The hardware version for the virtual machine.
2757
+ :param pulumi.Input[str] host_system_id: The ID of an optional host system to pin the virtual machine to.
2758
+ :param pulumi.Input[str] hv_mode: The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
2759
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an IP
2760
+ :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
2761
+ latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
2762
+ devices. Can be one of low, normal, medium, or high.
2763
+ :param pulumi.Input[int] memory: The size of the virtual machine's memory, in MB.
2764
+ :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to this virtual machine while it is running.
2765
+ :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
2766
+ resources.
2767
+ :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
2768
+ :param pulumi.Input[bool] memory_reservation_locked_to_max: If set true, memory resource reservation for this virtual machine will always be equal to the virtual machine's memory
2769
+ size;increases in memory size will be rejected when a corresponding reservation increase is not possible. This feature
2770
+ may only be enabled if it is currently possible to reserve all of the virtual machine's memory.
2771
+ :param pulumi.Input[int] memory_share_count: The amount of shares to allocate to memory for a custom share level.
2772
+ :param pulumi.Input[str] memory_share_level: The allocation level for memory resources. Can be one of high, low, normal, or custom.
2773
+ :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
2774
+ :param pulumi.Input[str] name: The name of this virtual machine.
2775
+ :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
2776
+ :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineNetworkInterfaceArgs']]]] network_interfaces: A specification for a virtual NIC on this virtual machine.
2777
+ :param pulumi.Input[int] num_cores_per_socket: The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
2778
+ must be evenly divisible by this value.
2779
+ :param pulumi.Input[int] num_cpus: The number of virtual processors to assign to this virtual machine.
2780
+ :param pulumi.Input[pulumi.InputType['VirtualMachineOvfDeployArgs']] ovf_deploy: A specification for deploying a virtual machine from ovf/ova template.
2781
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: A list of PCI passthrough devices
2893
2782
  :param pulumi.Input[int] poweron_timeout: The amount of time, in seconds, that we will be trying to power on a VM
2894
2783
  :param pulumi.Input[str] replace_trigger: Triggers replacement of resource whenever it changes.
2895
-
2896
- For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
2897
- :param pulumi.Input[str] resource_pool_id: The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
2898
-
2899
- > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
2900
- :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
2901
- :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
2902
- :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
2903
- :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
2904
- :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
2905
- :param pulumi.Input[int] sata_controller_count: The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
2906
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
2907
- controllers.
2908
- :param pulumi.Input[str] scsi_bus_sharing: The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
2909
- :param pulumi.Input[int] scsi_controller_count: The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
2910
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
2911
- controllers.
2912
- :param pulumi.Input[str] scsi_type: The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
2913
- :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
2914
- :param pulumi.Input[str] storage_policy_id: The UUID of the storage policy to assign to the virtual disk.
2915
- :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
2916
- :param pulumi.Input[bool] sync_time_with_host: Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `false`.
2917
- :param pulumi.Input[bool] sync_time_with_host_periodically: Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
2918
- :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
2919
-
2920
- > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
2921
- :param pulumi.Input[str] tools_upgrade_policy: Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
2922
- :param pulumi.Input[pulumi.InputType['VirtualMachineVappArgs']] vapp: Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
2923
- :param pulumi.Input[bool] vbs_enabled: Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
2924
- :param pulumi.Input[bool] vvtd_enabled: Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
2925
- :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
2926
- :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
2927
- :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
2784
+ :param pulumi.Input[str] resource_pool_id: The ID of a resource pool to put the virtual machine in.
2785
+ :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
2786
+ :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
2787
+ :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
2788
+ :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
2789
+ :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable the run of scripts before guest operating system standby when VMware Tools is installed.
2790
+ :param pulumi.Input[str] scsi_bus_sharing: Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
2791
+ :param pulumi.Input[str] scsi_type: The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
2792
+ :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
2793
+ :param pulumi.Input[str] storage_policy_id: The ID of the storage policy to assign to the virtual machine home directory.
2794
+ :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
2795
+ :param pulumi.Input[bool] sync_time_with_host: Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
2796
+ synchronized on startup and resume. Requires VMware Tools to be installed.
2797
+ :param pulumi.Input[bool] sync_time_with_host_periodically: Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
2798
+ setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
2799
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tag IDs to apply to this object.
2800
+ :param pulumi.Input[str] tools_upgrade_policy: Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
2801
+ :param pulumi.Input[pulumi.InputType['VirtualMachineVappArgs']] vapp: vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
2802
+ :param pulumi.Input[bool] vbs_enabled: Flag to specify if Virtualization-based security is enabled for this virtual machine.
2803
+ :param pulumi.Input[bool] vvtd_enabled: Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
2804
+ I/O Virtualization (AMD-Vi or IOMMU), is enabled.
2805
+ :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
2806
+ disables the waiter.
2807
+ :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
2808
+ a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
2809
+ :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
2810
+ disables the waiter.
2928
2811
  """
2929
2812
  ...
2930
2813
  @overload
@@ -2988,6 +2871,7 @@ class VirtualMachine(pulumi.CustomResource):
2988
2871
  memory_hot_add_enabled: Optional[pulumi.Input[bool]] = None,
2989
2872
  memory_limit: Optional[pulumi.Input[int]] = None,
2990
2873
  memory_reservation: Optional[pulumi.Input[int]] = None,
2874
+ memory_reservation_locked_to_max: Optional[pulumi.Input[bool]] = None,
2991
2875
  memory_share_count: Optional[pulumi.Input[int]] = None,
2992
2876
  memory_share_level: Optional[pulumi.Input[str]] = None,
2993
2877
  migrate_wait_timeout: Optional[pulumi.Input[int]] = None,
@@ -3071,6 +2955,7 @@ class VirtualMachine(pulumi.CustomResource):
3071
2955
  __props__.__dict__["memory_hot_add_enabled"] = memory_hot_add_enabled
3072
2956
  __props__.__dict__["memory_limit"] = memory_limit
3073
2957
  __props__.__dict__["memory_reservation"] = memory_reservation
2958
+ __props__.__dict__["memory_reservation_locked_to_max"] = memory_reservation_locked_to_max
3074
2959
  __props__.__dict__["memory_share_count"] = memory_share_count
3075
2960
  __props__.__dict__["memory_share_level"] = memory_share_level
3076
2961
  __props__.__dict__["migrate_wait_timeout"] = migrate_wait_timeout
@@ -3172,6 +3057,7 @@ class VirtualMachine(pulumi.CustomResource):
3172
3057
  memory_hot_add_enabled: Optional[pulumi.Input[bool]] = None,
3173
3058
  memory_limit: Optional[pulumi.Input[int]] = None,
3174
3059
  memory_reservation: Optional[pulumi.Input[int]] = None,
3060
+ memory_reservation_locked_to_max: Optional[pulumi.Input[bool]] = None,
3175
3061
  memory_share_count: Optional[pulumi.Input[int]] = None,
3176
3062
  memory_share_level: Optional[pulumi.Input[str]] = None,
3177
3063
  migrate_wait_timeout: Optional[pulumi.Input[int]] = None,
@@ -3221,130 +3107,103 @@ class VirtualMachine(pulumi.CustomResource):
3221
3107
  :param str resource_name: The unique name of the resulting resource.
3222
3108
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
3223
3109
  :param pulumi.ResourceOptions opts: Options for the resource.
3224
- :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
3225
- :param pulumi.Input[str] annotation: A user-provided description of the virtual machine.
3226
- :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence. The default is no delay.
3227
- :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
3228
- :param pulumi.Input[bool] boot_retry_enabled: If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
3229
- :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineCdromArgs']]]] cdroms: A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
3110
+ :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when guest_id is otherGuest or otherGuest64.
3111
+ :param pulumi.Input[str] annotation: User-provided description of the virtual machine.
3112
+ :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence.
3113
+ :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
3114
+ :param pulumi.Input[bool] boot_retry_enabled: If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
3115
+ :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineCdromArgs']]]] cdroms: A specification for a CDROM device on this virtual machine.
3230
3116
  :param pulumi.Input[str] change_version: A unique identifier for a given version of the last configuration was applied.
3231
- :param pulumi.Input[pulumi.InputType['VirtualMachineCloneArgs']] clone: When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
3232
- :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to the virtual machine while it is powered on.
3233
- :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be removed to the virtual machine while it is powered on.
3234
- :param pulumi.Input[int] cpu_limit: The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
3235
- :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on the virtual machine. Default: `false`.
3236
- :param pulumi.Input[int] cpu_reservation: The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
3237
- :param pulumi.Input[int] cpu_share_count: The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
3238
- :param pulumi.Input[str] cpu_share_level: The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
3239
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
3240
-
3241
- > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
3242
- :param pulumi.Input[str] datacenter_id: The datacenter ID. Required only when deploying an OVF/OVA template.
3243
- :param pulumi.Input[str] datastore_cluster_id: The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
3244
-
3245
- > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
3246
-
3247
- > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
3248
-
3249
- > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
3250
- :param pulumi.Input[str] datastore_id: The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
3117
+ :param pulumi.Input[pulumi.InputType['VirtualMachineCloneArgs']] clone: A specification for cloning a virtual machine from template.
3118
+ :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to this virtual machine while it is running.
3119
+ :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be added to this virtual machine while it is running.
3120
+ :param pulumi.Input[int] cpu_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
3121
+ resources.
3122
+ :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on this virtual machine.
3123
+ :param pulumi.Input[int] cpu_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
3124
+ :param pulumi.Input[int] cpu_share_count: The amount of shares to allocate to cpu for a custom share level.
3125
+ :param pulumi.Input[str] cpu_share_level: The allocation level for cpu resources. Can be one of high, low, normal, or custom.
3126
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: A list of custom attributes to set on this resource.
3127
+ :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VM is to be created.
3128
+ :param pulumi.Input[str] datastore_cluster_id: The ID of a datastore cluster to put the virtual machine in.
3129
+ :param pulumi.Input[str] datastore_id: The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
3130
+ disks that are created without datastores.
3251
3131
  :param pulumi.Input[str] default_ip_address: The IP address selected by the provider to be used with any provisioners configured on this resource. When possible, this is the first IPv4 address that is reachable through the default gateway configured on the machine, then the first reachable IPv6 address, and then the first general discovered address if neither exists. If VMware Tools is not running on the virtual machine, or if the virtual machine is powered off, this value will be blank.
3252
- :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineDiskArgs']]]] disks: A specification for a virtual disk device on the virtual machine. See disk options for more information.
3253
- :param pulumi.Input[bool] efi_secure_boot_enabled: Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
3254
-
3255
- > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
3256
- :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
3257
- :param pulumi.Input[bool] enable_logging: Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
3258
- :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
3259
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
3260
-
3261
- > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
3262
- :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
3263
- :param pulumi.Input[str] firmware: The firmware for the virtual machine. One of `bios` or `efi`.
3264
- :param pulumi.Input[str] folder: The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`). For example, `/dc-01/vm/foo`
3265
- :param pulumi.Input[bool] force_power_off: If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
3266
- :param pulumi.Input[str] guest_id: The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
3267
-
3268
- [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
3132
+ :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineDiskArgs']]]] disks: A specification for a virtual disk device on this virtual machine.
3133
+ :param pulumi.Input[bool] efi_secure_boot_enabled: When the boot type set in firmware is efi, this enables EFI secure boot.
3134
+ :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
3135
+ :param pulumi.Input[bool] enable_logging: Enable logging on this virtual machine.
3136
+ :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
3137
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
3138
+ configuration, such as instance metadata, or configuration data for OVF images.
3139
+ :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
3140
+ :param pulumi.Input[str] firmware: The firmware interface to use on the virtual machine. Can be one of bios or efi.
3141
+ :param pulumi.Input[str] folder: The name of the folder to locate the virtual machine in.
3142
+ :param pulumi.Input[bool] force_power_off: Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
3143
+ :param pulumi.Input[str] guest_id: The guest ID for the operating system.
3269
3144
  :param pulumi.Input[Sequence[pulumi.Input[str]]] guest_ip_addresses: The current list of IP addresses on this machine, including the value of `default_ip_address`. If VMware Tools is not running on the virtual machine, or if the virtul machine is powered off, this list will be empty.
3270
- :param pulumi.Input[int] hardware_version: The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
3271
-
3272
- [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
3273
- [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
3274
- :param pulumi.Input[str] host_system_id: The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
3275
- :param pulumi.Input[str] hv_mode: The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
3276
- :param pulumi.Input[int] ide_controller_count: The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
3277
- :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
3145
+ :param pulumi.Input[int] hardware_version: The hardware version for the virtual machine.
3146
+ :param pulumi.Input[str] host_system_id: The ID of an optional host system to pin the virtual machine to.
3147
+ :param pulumi.Input[str] hv_mode: The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
3148
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an IP
3278
3149
  :param pulumi.Input[bool] imported: Indicates if the virtual machine resource has been imported, or if the state has been migrated from a previous version of the resource. It influences the behavior of the first post-import apply operation. See the section on importing below.
3279
- :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
3280
-
3281
- > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
3282
- :param pulumi.Input[int] memory: The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
3283
- :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to the virtual machine while it is powered on.
3284
-
3285
- > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
3286
-
3287
- [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
3288
-
3289
- > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
3290
-
3291
- [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
3292
- :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
3293
- :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
3294
- :param pulumi.Input[int] memory_share_count: The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
3295
- :param pulumi.Input[str] memory_share_level: The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
3296
- :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
3150
+ :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
3151
+ latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
3152
+ devices. Can be one of low, normal, medium, or high.
3153
+ :param pulumi.Input[int] memory: The size of the virtual machine's memory, in MB.
3154
+ :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to this virtual machine while it is running.
3155
+ :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
3156
+ resources.
3157
+ :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
3158
+ :param pulumi.Input[bool] memory_reservation_locked_to_max: If set true, memory resource reservation for this virtual machine will always be equal to the virtual machine's memory
3159
+ size;increases in memory size will be rejected when a corresponding reservation increase is not possible. This feature
3160
+ may only be enabled if it is currently possible to reserve all of the virtual machine's memory.
3161
+ :param pulumi.Input[int] memory_share_count: The amount of shares to allocate to memory for a custom share level.
3162
+ :param pulumi.Input[str] memory_share_level: The allocation level for memory resources. Can be one of high, low, normal, or custom.
3163
+ :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
3297
3164
  :param pulumi.Input[str] moid: The managed object reference ID of the created virtual machine.
3298
- :param pulumi.Input[str] name: The name of the virtual machine.
3299
- :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
3300
- :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineNetworkInterfaceArgs']]]] network_interfaces: A specification for a virtual NIC on the virtual machine. See network interface options for more information.
3301
- :param pulumi.Input[int] num_cores_per_socket: The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
3302
- :param pulumi.Input[int] num_cpus: The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
3303
- :param pulumi.Input[pulumi.InputType['VirtualMachineOvfDeployArgs']] ovf_deploy: When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
3304
- :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: List of host PCI device IDs in which to create PCI passthroughs.
3305
-
3306
- > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
3165
+ :param pulumi.Input[str] name: The name of this virtual machine.
3166
+ :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
3167
+ :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineNetworkInterfaceArgs']]]] network_interfaces: A specification for a virtual NIC on this virtual machine.
3168
+ :param pulumi.Input[int] num_cores_per_socket: The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
3169
+ must be evenly divisible by this value.
3170
+ :param pulumi.Input[int] num_cpus: The number of virtual processors to assign to this virtual machine.
3171
+ :param pulumi.Input[pulumi.InputType['VirtualMachineOvfDeployArgs']] ovf_deploy: A specification for deploying a virtual machine from ovf/ova template.
3172
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: A list of PCI passthrough devices
3307
3173
  :param pulumi.Input[str] power_state: A computed value for the current power state of the virtual machine. One of `on`, `off`, or `suspended`.
3308
3174
  :param pulumi.Input[int] poweron_timeout: The amount of time, in seconds, that we will be trying to power on a VM
3309
- :param pulumi.Input[bool] reboot_required: Value internal to Terraform used to determine if a configuration set change requires a reboot.
3310
3175
  :param pulumi.Input[str] replace_trigger: Triggers replacement of resource whenever it changes.
3311
-
3312
- For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
3313
- :param pulumi.Input[str] resource_pool_id: The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
3314
-
3315
- > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
3316
- :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
3317
- :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
3318
- :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
3319
- :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
3320
- :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
3321
- :param pulumi.Input[int] sata_controller_count: The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
3322
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
3323
- controllers.
3324
- :param pulumi.Input[str] scsi_bus_sharing: The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
3325
- :param pulumi.Input[int] scsi_controller_count: The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
3326
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
3327
- controllers.
3328
- :param pulumi.Input[str] scsi_type: The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
3329
- :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
3330
- :param pulumi.Input[str] storage_policy_id: The UUID of the storage policy to assign to the virtual disk.
3331
- :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
3332
- :param pulumi.Input[bool] sync_time_with_host: Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `false`.
3333
- :param pulumi.Input[bool] sync_time_with_host_periodically: Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
3334
- :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
3335
-
3336
- > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
3337
- :param pulumi.Input[str] tools_upgrade_policy: Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
3338
- :param pulumi.Input[str] uuid: The UUID of the virtual disk VMDK file. This is used to track the virtual disk on the virtual machine.
3339
- :param pulumi.Input[pulumi.InputType['VirtualMachineVappArgs']] vapp: Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
3176
+ :param pulumi.Input[str] resource_pool_id: The ID of a resource pool to put the virtual machine in.
3177
+ :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
3178
+ :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
3179
+ :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
3180
+ :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
3181
+ :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable the run of scripts before guest operating system standby when VMware Tools is installed.
3182
+ :param pulumi.Input[str] scsi_bus_sharing: Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
3183
+ :param pulumi.Input[str] scsi_type: The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
3184
+ :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
3185
+ :param pulumi.Input[str] storage_policy_id: The ID of the storage policy to assign to the virtual machine home directory.
3186
+ :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
3187
+ :param pulumi.Input[bool] sync_time_with_host: Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
3188
+ synchronized on startup and resume. Requires VMware Tools to be installed.
3189
+ :param pulumi.Input[bool] sync_time_with_host_periodically: Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
3190
+ setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
3191
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tag IDs to apply to this object.
3192
+ :param pulumi.Input[str] tools_upgrade_policy: Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
3193
+ :param pulumi.Input[str] uuid: The UUID of the virtual machine. Also exposed as the `id` of the resource.
3194
+ :param pulumi.Input[pulumi.InputType['VirtualMachineVappArgs']] vapp: vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
3340
3195
  :param pulumi.Input[Sequence[pulumi.Input[str]]] vapp_transports: Computed value which is only valid for cloned virtual machines. A list of vApp transport methods supported by the source virtual machine or template.
3341
- :param pulumi.Input[bool] vbs_enabled: Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
3196
+ :param pulumi.Input[bool] vbs_enabled: Flag to specify if Virtualization-based security is enabled for this virtual machine.
3342
3197
  :param pulumi.Input[str] vmware_tools_status: The state of VMware Tools in the guest. This will determine the proper course of action for some device operations.
3343
3198
  :param pulumi.Input[str] vmx_path: The path of the virtual machine configuration file on the datastore in which the virtual machine is placed.
3344
- :param pulumi.Input[bool] vvtd_enabled: Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
3345
- :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
3346
- :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
3347
- :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
3199
+ :param pulumi.Input[bool] vvtd_enabled: Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
3200
+ I/O Virtualization (AMD-Vi or IOMMU), is enabled.
3201
+ :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
3202
+ disables the waiter.
3203
+ :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
3204
+ a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
3205
+ :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
3206
+ disables the waiter.
3348
3207
  """
3349
3208
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
3350
3209
 
@@ -3393,6 +3252,7 @@ class VirtualMachine(pulumi.CustomResource):
3393
3252
  __props__.__dict__["memory_hot_add_enabled"] = memory_hot_add_enabled
3394
3253
  __props__.__dict__["memory_limit"] = memory_limit
3395
3254
  __props__.__dict__["memory_reservation"] = memory_reservation
3255
+ __props__.__dict__["memory_reservation_locked_to_max"] = memory_reservation_locked_to_max
3396
3256
  __props__.__dict__["memory_share_count"] = memory_share_count
3397
3257
  __props__.__dict__["memory_share_level"] = memory_share_level
3398
3258
  __props__.__dict__["migrate_wait_timeout"] = migrate_wait_timeout
@@ -3441,7 +3301,7 @@ class VirtualMachine(pulumi.CustomResource):
3441
3301
  @pulumi.getter(name="alternateGuestName")
3442
3302
  def alternate_guest_name(self) -> pulumi.Output[Optional[str]]:
3443
3303
  """
3444
- The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
3304
+ The guest name for the operating system when guest_id is otherGuest or otherGuest64.
3445
3305
  """
3446
3306
  return pulumi.get(self, "alternate_guest_name")
3447
3307
 
@@ -3449,7 +3309,7 @@ class VirtualMachine(pulumi.CustomResource):
3449
3309
  @pulumi.getter
3450
3310
  def annotation(self) -> pulumi.Output[str]:
3451
3311
  """
3452
- A user-provided description of the virtual machine.
3312
+ User-provided description of the virtual machine.
3453
3313
  """
3454
3314
  return pulumi.get(self, "annotation")
3455
3315
 
@@ -3457,7 +3317,7 @@ class VirtualMachine(pulumi.CustomResource):
3457
3317
  @pulumi.getter(name="bootDelay")
3458
3318
  def boot_delay(self) -> pulumi.Output[Optional[int]]:
3459
3319
  """
3460
- The number of milliseconds to wait before starting the boot sequence. The default is no delay.
3320
+ The number of milliseconds to wait before starting the boot sequence.
3461
3321
  """
3462
3322
  return pulumi.get(self, "boot_delay")
3463
3323
 
@@ -3465,7 +3325,7 @@ class VirtualMachine(pulumi.CustomResource):
3465
3325
  @pulumi.getter(name="bootRetryDelay")
3466
3326
  def boot_retry_delay(self) -> pulumi.Output[Optional[int]]:
3467
3327
  """
3468
- The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
3328
+ The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
3469
3329
  """
3470
3330
  return pulumi.get(self, "boot_retry_delay")
3471
3331
 
@@ -3473,7 +3333,7 @@ class VirtualMachine(pulumi.CustomResource):
3473
3333
  @pulumi.getter(name="bootRetryEnabled")
3474
3334
  def boot_retry_enabled(self) -> pulumi.Output[Optional[bool]]:
3475
3335
  """
3476
- If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
3336
+ If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
3477
3337
  """
3478
3338
  return pulumi.get(self, "boot_retry_enabled")
3479
3339
 
@@ -3481,7 +3341,7 @@ class VirtualMachine(pulumi.CustomResource):
3481
3341
  @pulumi.getter
3482
3342
  def cdroms(self) -> pulumi.Output[Optional[Sequence['outputs.VirtualMachineCdrom']]]:
3483
3343
  """
3484
- A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
3344
+ A specification for a CDROM device on this virtual machine.
3485
3345
  """
3486
3346
  return pulumi.get(self, "cdroms")
3487
3347
 
@@ -3497,7 +3357,7 @@ class VirtualMachine(pulumi.CustomResource):
3497
3357
  @pulumi.getter
3498
3358
  def clone(self) -> pulumi.Output[Optional['outputs.VirtualMachineClone']]:
3499
3359
  """
3500
- When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
3360
+ A specification for cloning a virtual machine from template.
3501
3361
  """
3502
3362
  return pulumi.get(self, "clone")
3503
3363
 
@@ -3505,7 +3365,7 @@ class VirtualMachine(pulumi.CustomResource):
3505
3365
  @pulumi.getter(name="cpuHotAddEnabled")
3506
3366
  def cpu_hot_add_enabled(self) -> pulumi.Output[Optional[bool]]:
3507
3367
  """
3508
- Allow CPUs to be added to the virtual machine while it is powered on.
3368
+ Allow CPUs to be added to this virtual machine while it is running.
3509
3369
  """
3510
3370
  return pulumi.get(self, "cpu_hot_add_enabled")
3511
3371
 
@@ -3513,7 +3373,7 @@ class VirtualMachine(pulumi.CustomResource):
3513
3373
  @pulumi.getter(name="cpuHotRemoveEnabled")
3514
3374
  def cpu_hot_remove_enabled(self) -> pulumi.Output[Optional[bool]]:
3515
3375
  """
3516
- Allow CPUs to be removed to the virtual machine while it is powered on.
3376
+ Allow CPUs to be added to this virtual machine while it is running.
3517
3377
  """
3518
3378
  return pulumi.get(self, "cpu_hot_remove_enabled")
3519
3379
 
@@ -3521,7 +3381,8 @@ class VirtualMachine(pulumi.CustomResource):
3521
3381
  @pulumi.getter(name="cpuLimit")
3522
3382
  def cpu_limit(self) -> pulumi.Output[Optional[int]]:
3523
3383
  """
3524
- The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
3384
+ The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
3385
+ resources.
3525
3386
  """
3526
3387
  return pulumi.get(self, "cpu_limit")
3527
3388
 
@@ -3529,7 +3390,7 @@ class VirtualMachine(pulumi.CustomResource):
3529
3390
  @pulumi.getter(name="cpuPerformanceCountersEnabled")
3530
3391
  def cpu_performance_counters_enabled(self) -> pulumi.Output[Optional[bool]]:
3531
3392
  """
3532
- Enable CPU performance counters on the virtual machine. Default: `false`.
3393
+ Enable CPU performance counters on this virtual machine.
3533
3394
  """
3534
3395
  return pulumi.get(self, "cpu_performance_counters_enabled")
3535
3396
 
@@ -3537,7 +3398,7 @@ class VirtualMachine(pulumi.CustomResource):
3537
3398
  @pulumi.getter(name="cpuReservation")
3538
3399
  def cpu_reservation(self) -> pulumi.Output[Optional[int]]:
3539
3400
  """
3540
- The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
3401
+ The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
3541
3402
  """
3542
3403
  return pulumi.get(self, "cpu_reservation")
3543
3404
 
@@ -3545,7 +3406,7 @@ class VirtualMachine(pulumi.CustomResource):
3545
3406
  @pulumi.getter(name="cpuShareCount")
3546
3407
  def cpu_share_count(self) -> pulumi.Output[int]:
3547
3408
  """
3548
- The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
3409
+ The amount of shares to allocate to cpu for a custom share level.
3549
3410
  """
3550
3411
  return pulumi.get(self, "cpu_share_count")
3551
3412
 
@@ -3553,7 +3414,7 @@ class VirtualMachine(pulumi.CustomResource):
3553
3414
  @pulumi.getter(name="cpuShareLevel")
3554
3415
  def cpu_share_level(self) -> pulumi.Output[Optional[str]]:
3555
3416
  """
3556
- The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
3417
+ The allocation level for cpu resources. Can be one of high, low, normal, or custom.
3557
3418
  """
3558
3419
  return pulumi.get(self, "cpu_share_level")
3559
3420
 
@@ -3561,9 +3422,7 @@ class VirtualMachine(pulumi.CustomResource):
3561
3422
  @pulumi.getter(name="customAttributes")
3562
3423
  def custom_attributes(self) -> pulumi.Output[Optional[Mapping[str, str]]]:
3563
3424
  """
3564
- Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
3565
-
3566
- > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
3425
+ A list of custom attributes to set on this resource.
3567
3426
  """
3568
3427
  return pulumi.get(self, "custom_attributes")
3569
3428
 
@@ -3571,7 +3430,7 @@ class VirtualMachine(pulumi.CustomResource):
3571
3430
  @pulumi.getter(name="datacenterId")
3572
3431
  def datacenter_id(self) -> pulumi.Output[Optional[str]]:
3573
3432
  """
3574
- The datacenter ID. Required only when deploying an OVF/OVA template.
3433
+ The ID of the datacenter where the VM is to be created.
3575
3434
  """
3576
3435
  return pulumi.get(self, "datacenter_id")
3577
3436
 
@@ -3579,13 +3438,7 @@ class VirtualMachine(pulumi.CustomResource):
3579
3438
  @pulumi.getter(name="datastoreClusterId")
3580
3439
  def datastore_cluster_id(self) -> pulumi.Output[Optional[str]]:
3581
3440
  """
3582
- The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
3583
-
3584
- > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
3585
-
3586
- > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
3587
-
3588
- > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
3441
+ The ID of a datastore cluster to put the virtual machine in.
3589
3442
  """
3590
3443
  return pulumi.get(self, "datastore_cluster_id")
3591
3444
 
@@ -3593,7 +3446,8 @@ class VirtualMachine(pulumi.CustomResource):
3593
3446
  @pulumi.getter(name="datastoreId")
3594
3447
  def datastore_id(self) -> pulumi.Output[str]:
3595
3448
  """
3596
- The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
3449
+ The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
3450
+ disks that are created without datastores.
3597
3451
  """
3598
3452
  return pulumi.get(self, "datastore_id")
3599
3453
 
@@ -3609,7 +3463,7 @@ class VirtualMachine(pulumi.CustomResource):
3609
3463
  @pulumi.getter
3610
3464
  def disks(self) -> pulumi.Output[Sequence['outputs.VirtualMachineDisk']]:
3611
3465
  """
3612
- A specification for a virtual disk device on the virtual machine. See disk options for more information.
3466
+ A specification for a virtual disk device on this virtual machine.
3613
3467
  """
3614
3468
  return pulumi.get(self, "disks")
3615
3469
 
@@ -3617,9 +3471,7 @@ class VirtualMachine(pulumi.CustomResource):
3617
3471
  @pulumi.getter(name="efiSecureBootEnabled")
3618
3472
  def efi_secure_boot_enabled(self) -> pulumi.Output[Optional[bool]]:
3619
3473
  """
3620
- Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
3621
-
3622
- > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
3474
+ When the boot type set in firmware is efi, this enables EFI secure boot.
3623
3475
  """
3624
3476
  return pulumi.get(self, "efi_secure_boot_enabled")
3625
3477
 
@@ -3627,7 +3479,7 @@ class VirtualMachine(pulumi.CustomResource):
3627
3479
  @pulumi.getter(name="enableDiskUuid")
3628
3480
  def enable_disk_uuid(self) -> pulumi.Output[Optional[bool]]:
3629
3481
  """
3630
- Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
3482
+ Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
3631
3483
  """
3632
3484
  return pulumi.get(self, "enable_disk_uuid")
3633
3485
 
@@ -3635,7 +3487,7 @@ class VirtualMachine(pulumi.CustomResource):
3635
3487
  @pulumi.getter(name="enableLogging")
3636
3488
  def enable_logging(self) -> pulumi.Output[Optional[bool]]:
3637
3489
  """
3638
- Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
3490
+ Enable logging on this virtual machine.
3639
3491
  """
3640
3492
  return pulumi.get(self, "enable_logging")
3641
3493
 
@@ -3643,7 +3495,7 @@ class VirtualMachine(pulumi.CustomResource):
3643
3495
  @pulumi.getter(name="eptRviMode")
3644
3496
  def ept_rvi_mode(self) -> pulumi.Output[Optional[str]]:
3645
3497
  """
3646
- The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
3498
+ The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
3647
3499
  """
3648
3500
  return pulumi.get(self, "ept_rvi_mode")
3649
3501
 
@@ -3651,9 +3503,8 @@ class VirtualMachine(pulumi.CustomResource):
3651
3503
  @pulumi.getter(name="extraConfig")
3652
3504
  def extra_config(self) -> pulumi.Output[Optional[Mapping[str, str]]]:
3653
3505
  """
3654
- Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
3655
-
3656
- > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
3506
+ Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
3507
+ configuration, such as instance metadata, or configuration data for OVF images.
3657
3508
  """
3658
3509
  return pulumi.get(self, "extra_config")
3659
3510
 
@@ -3661,7 +3512,7 @@ class VirtualMachine(pulumi.CustomResource):
3661
3512
  @pulumi.getter(name="extraConfigRebootRequired")
3662
3513
  def extra_config_reboot_required(self) -> pulumi.Output[Optional[bool]]:
3663
3514
  """
3664
- Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
3515
+ Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
3665
3516
  """
3666
3517
  return pulumi.get(self, "extra_config_reboot_required")
3667
3518
 
@@ -3669,7 +3520,7 @@ class VirtualMachine(pulumi.CustomResource):
3669
3520
  @pulumi.getter
3670
3521
  def firmware(self) -> pulumi.Output[Optional[str]]:
3671
3522
  """
3672
- The firmware for the virtual machine. One of `bios` or `efi`.
3523
+ The firmware interface to use on the virtual machine. Can be one of bios or efi.
3673
3524
  """
3674
3525
  return pulumi.get(self, "firmware")
3675
3526
 
@@ -3677,7 +3528,7 @@ class VirtualMachine(pulumi.CustomResource):
3677
3528
  @pulumi.getter
3678
3529
  def folder(self) -> pulumi.Output[Optional[str]]:
3679
3530
  """
3680
- The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`). For example, `/dc-01/vm/foo`
3531
+ The name of the folder to locate the virtual machine in.
3681
3532
  """
3682
3533
  return pulumi.get(self, "folder")
3683
3534
 
@@ -3685,7 +3536,7 @@ class VirtualMachine(pulumi.CustomResource):
3685
3536
  @pulumi.getter(name="forcePowerOff")
3686
3537
  def force_power_off(self) -> pulumi.Output[Optional[bool]]:
3687
3538
  """
3688
- If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
3539
+ Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
3689
3540
  """
3690
3541
  return pulumi.get(self, "force_power_off")
3691
3542
 
@@ -3693,9 +3544,7 @@ class VirtualMachine(pulumi.CustomResource):
3693
3544
  @pulumi.getter(name="guestId")
3694
3545
  def guest_id(self) -> pulumi.Output[str]:
3695
3546
  """
3696
- The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
3697
-
3698
- [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
3547
+ The guest ID for the operating system.
3699
3548
  """
3700
3549
  return pulumi.get(self, "guest_id")
3701
3550
 
@@ -3711,10 +3560,7 @@ class VirtualMachine(pulumi.CustomResource):
3711
3560
  @pulumi.getter(name="hardwareVersion")
3712
3561
  def hardware_version(self) -> pulumi.Output[int]:
3713
3562
  """
3714
- The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
3715
-
3716
- [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
3717
- [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
3563
+ The hardware version for the virtual machine.
3718
3564
  """
3719
3565
  return pulumi.get(self, "hardware_version")
3720
3566
 
@@ -3722,7 +3568,7 @@ class VirtualMachine(pulumi.CustomResource):
3722
3568
  @pulumi.getter(name="hostSystemId")
3723
3569
  def host_system_id(self) -> pulumi.Output[str]:
3724
3570
  """
3725
- The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
3571
+ The ID of an optional host system to pin the virtual machine to.
3726
3572
  """
3727
3573
  return pulumi.get(self, "host_system_id")
3728
3574
 
@@ -3730,23 +3576,20 @@ class VirtualMachine(pulumi.CustomResource):
3730
3576
  @pulumi.getter(name="hvMode")
3731
3577
  def hv_mode(self) -> pulumi.Output[Optional[str]]:
3732
3578
  """
3733
- The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
3579
+ The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
3734
3580
  """
3735
3581
  return pulumi.get(self, "hv_mode")
3736
3582
 
3737
3583
  @property
3738
3584
  @pulumi.getter(name="ideControllerCount")
3739
3585
  def ide_controller_count(self) -> pulumi.Output[Optional[int]]:
3740
- """
3741
- The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
3742
- """
3743
3586
  return pulumi.get(self, "ide_controller_count")
3744
3587
 
3745
3588
  @property
3746
3589
  @pulumi.getter(name="ignoredGuestIps")
3747
3590
  def ignored_guest_ips(self) -> pulumi.Output[Optional[Sequence[str]]]:
3748
3591
  """
3749
- List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
3592
+ List of IP addresses and CIDR networks to ignore while waiting for an IP
3750
3593
  """
3751
3594
  return pulumi.get(self, "ignored_guest_ips")
3752
3595
 
@@ -3762,9 +3605,9 @@ class VirtualMachine(pulumi.CustomResource):
3762
3605
  @pulumi.getter(name="latencySensitivity")
3763
3606
  def latency_sensitivity(self) -> pulumi.Output[Optional[str]]:
3764
3607
  """
3765
- Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
3766
-
3767
- > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
3608
+ Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
3609
+ latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
3610
+ devices. Can be one of low, normal, medium, or high.
3768
3611
  """
3769
3612
  return pulumi.get(self, "latency_sensitivity")
3770
3613
 
@@ -3772,7 +3615,7 @@ class VirtualMachine(pulumi.CustomResource):
3772
3615
  @pulumi.getter
3773
3616
  def memory(self) -> pulumi.Output[Optional[int]]:
3774
3617
  """
3775
- The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
3618
+ The size of the virtual machine's memory, in MB.
3776
3619
  """
3777
3620
  return pulumi.get(self, "memory")
3778
3621
 
@@ -3780,15 +3623,7 @@ class VirtualMachine(pulumi.CustomResource):
3780
3623
  @pulumi.getter(name="memoryHotAddEnabled")
3781
3624
  def memory_hot_add_enabled(self) -> pulumi.Output[Optional[bool]]:
3782
3625
  """
3783
- Allow memory to be added to the virtual machine while it is powered on.
3784
-
3785
- > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
3786
-
3787
- [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
3788
-
3789
- > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
3790
-
3791
- [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
3626
+ Allow memory to be added to this virtual machine while it is running.
3792
3627
  """
3793
3628
  return pulumi.get(self, "memory_hot_add_enabled")
3794
3629
 
@@ -3796,7 +3631,8 @@ class VirtualMachine(pulumi.CustomResource):
3796
3631
  @pulumi.getter(name="memoryLimit")
3797
3632
  def memory_limit(self) -> pulumi.Output[Optional[int]]:
3798
3633
  """
3799
- The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
3634
+ The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
3635
+ resources.
3800
3636
  """
3801
3637
  return pulumi.get(self, "memory_limit")
3802
3638
 
@@ -3804,15 +3640,25 @@ class VirtualMachine(pulumi.CustomResource):
3804
3640
  @pulumi.getter(name="memoryReservation")
3805
3641
  def memory_reservation(self) -> pulumi.Output[Optional[int]]:
3806
3642
  """
3807
- The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
3643
+ The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
3808
3644
  """
3809
3645
  return pulumi.get(self, "memory_reservation")
3810
3646
 
3647
+ @property
3648
+ @pulumi.getter(name="memoryReservationLockedToMax")
3649
+ def memory_reservation_locked_to_max(self) -> pulumi.Output[Optional[bool]]:
3650
+ """
3651
+ If set true, memory resource reservation for this virtual machine will always be equal to the virtual machine's memory
3652
+ size;increases in memory size will be rejected when a corresponding reservation increase is not possible. This feature
3653
+ may only be enabled if it is currently possible to reserve all of the virtual machine's memory.
3654
+ """
3655
+ return pulumi.get(self, "memory_reservation_locked_to_max")
3656
+
3811
3657
  @property
3812
3658
  @pulumi.getter(name="memoryShareCount")
3813
3659
  def memory_share_count(self) -> pulumi.Output[int]:
3814
3660
  """
3815
- The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
3661
+ The amount of shares to allocate to memory for a custom share level.
3816
3662
  """
3817
3663
  return pulumi.get(self, "memory_share_count")
3818
3664
 
@@ -3820,7 +3666,7 @@ class VirtualMachine(pulumi.CustomResource):
3820
3666
  @pulumi.getter(name="memoryShareLevel")
3821
3667
  def memory_share_level(self) -> pulumi.Output[Optional[str]]:
3822
3668
  """
3823
- The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
3669
+ The allocation level for memory resources. Can be one of high, low, normal, or custom.
3824
3670
  """
3825
3671
  return pulumi.get(self, "memory_share_level")
3826
3672
 
@@ -3828,7 +3674,7 @@ class VirtualMachine(pulumi.CustomResource):
3828
3674
  @pulumi.getter(name="migrateWaitTimeout")
3829
3675
  def migrate_wait_timeout(self) -> pulumi.Output[Optional[int]]:
3830
3676
  """
3831
- The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
3677
+ The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
3832
3678
  """
3833
3679
  return pulumi.get(self, "migrate_wait_timeout")
3834
3680
 
@@ -3844,7 +3690,7 @@ class VirtualMachine(pulumi.CustomResource):
3844
3690
  @pulumi.getter
3845
3691
  def name(self) -> pulumi.Output[str]:
3846
3692
  """
3847
- The name of the virtual machine.
3693
+ The name of this virtual machine.
3848
3694
  """
3849
3695
  return pulumi.get(self, "name")
3850
3696
 
@@ -3852,7 +3698,7 @@ class VirtualMachine(pulumi.CustomResource):
3852
3698
  @pulumi.getter(name="nestedHvEnabled")
3853
3699
  def nested_hv_enabled(self) -> pulumi.Output[Optional[bool]]:
3854
3700
  """
3855
- Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
3701
+ Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
3856
3702
  """
3857
3703
  return pulumi.get(self, "nested_hv_enabled")
3858
3704
 
@@ -3860,7 +3706,7 @@ class VirtualMachine(pulumi.CustomResource):
3860
3706
  @pulumi.getter(name="networkInterfaces")
3861
3707
  def network_interfaces(self) -> pulumi.Output[Optional[Sequence['outputs.VirtualMachineNetworkInterface']]]:
3862
3708
  """
3863
- A specification for a virtual NIC on the virtual machine. See network interface options for more information.
3709
+ A specification for a virtual NIC on this virtual machine.
3864
3710
  """
3865
3711
  return pulumi.get(self, "network_interfaces")
3866
3712
 
@@ -3868,7 +3714,8 @@ class VirtualMachine(pulumi.CustomResource):
3868
3714
  @pulumi.getter(name="numCoresPerSocket")
3869
3715
  def num_cores_per_socket(self) -> pulumi.Output[Optional[int]]:
3870
3716
  """
3871
- The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
3717
+ The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
3718
+ must be evenly divisible by this value.
3872
3719
  """
3873
3720
  return pulumi.get(self, "num_cores_per_socket")
3874
3721
 
@@ -3876,7 +3723,7 @@ class VirtualMachine(pulumi.CustomResource):
3876
3723
  @pulumi.getter(name="numCpus")
3877
3724
  def num_cpus(self) -> pulumi.Output[Optional[int]]:
3878
3725
  """
3879
- The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
3726
+ The number of virtual processors to assign to this virtual machine.
3880
3727
  """
3881
3728
  return pulumi.get(self, "num_cpus")
3882
3729
 
@@ -3884,7 +3731,7 @@ class VirtualMachine(pulumi.CustomResource):
3884
3731
  @pulumi.getter(name="ovfDeploy")
3885
3732
  def ovf_deploy(self) -> pulumi.Output[Optional['outputs.VirtualMachineOvfDeploy']]:
3886
3733
  """
3887
- When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
3734
+ A specification for deploying a virtual machine from ovf/ova template.
3888
3735
  """
3889
3736
  return pulumi.get(self, "ovf_deploy")
3890
3737
 
@@ -3892,9 +3739,7 @@ class VirtualMachine(pulumi.CustomResource):
3892
3739
  @pulumi.getter(name="pciDeviceIds")
3893
3740
  def pci_device_ids(self) -> pulumi.Output[Optional[Sequence[str]]]:
3894
3741
  """
3895
- List of host PCI device IDs in which to create PCI passthroughs.
3896
-
3897
- > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
3742
+ A list of PCI passthrough devices
3898
3743
  """
3899
3744
  return pulumi.get(self, "pci_device_ids")
3900
3745
 
@@ -3917,9 +3762,6 @@ class VirtualMachine(pulumi.CustomResource):
3917
3762
  @property
3918
3763
  @pulumi.getter(name="rebootRequired")
3919
3764
  def reboot_required(self) -> pulumi.Output[bool]:
3920
- """
3921
- Value internal to Terraform used to determine if a configuration set change requires a reboot.
3922
- """
3923
3765
  return pulumi.get(self, "reboot_required")
3924
3766
 
3925
3767
  @property
@@ -3927,8 +3769,6 @@ class VirtualMachine(pulumi.CustomResource):
3927
3769
  def replace_trigger(self) -> pulumi.Output[Optional[str]]:
3928
3770
  """
3929
3771
  Triggers replacement of resource whenever it changes.
3930
-
3931
- For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
3932
3772
  """
3933
3773
  return pulumi.get(self, "replace_trigger")
3934
3774
 
@@ -3936,9 +3776,7 @@ class VirtualMachine(pulumi.CustomResource):
3936
3776
  @pulumi.getter(name="resourcePoolId")
3937
3777
  def resource_pool_id(self) -> pulumi.Output[str]:
3938
3778
  """
3939
- The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
3940
-
3941
- > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
3779
+ The ID of a resource pool to put the virtual machine in.
3942
3780
  """
3943
3781
  return pulumi.get(self, "resource_pool_id")
3944
3782
 
@@ -3946,7 +3784,7 @@ class VirtualMachine(pulumi.CustomResource):
3946
3784
  @pulumi.getter(name="runToolsScriptsAfterPowerOn")
3947
3785
  def run_tools_scripts_after_power_on(self) -> pulumi.Output[Optional[bool]]:
3948
3786
  """
3949
- Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
3787
+ Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
3950
3788
  """
3951
3789
  return pulumi.get(self, "run_tools_scripts_after_power_on")
3952
3790
 
@@ -3954,7 +3792,7 @@ class VirtualMachine(pulumi.CustomResource):
3954
3792
  @pulumi.getter(name="runToolsScriptsAfterResume")
3955
3793
  def run_tools_scripts_after_resume(self) -> pulumi.Output[Optional[bool]]:
3956
3794
  """
3957
- Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
3795
+ Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
3958
3796
  """
3959
3797
  return pulumi.get(self, "run_tools_scripts_after_resume")
3960
3798
 
@@ -3962,7 +3800,7 @@ class VirtualMachine(pulumi.CustomResource):
3962
3800
  @pulumi.getter(name="runToolsScriptsBeforeGuestReboot")
3963
3801
  def run_tools_scripts_before_guest_reboot(self) -> pulumi.Output[Optional[bool]]:
3964
3802
  """
3965
- Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
3803
+ Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
3966
3804
  """
3967
3805
  return pulumi.get(self, "run_tools_scripts_before_guest_reboot")
3968
3806
 
@@ -3970,7 +3808,7 @@ class VirtualMachine(pulumi.CustomResource):
3970
3808
  @pulumi.getter(name="runToolsScriptsBeforeGuestShutdown")
3971
3809
  def run_tools_scripts_before_guest_shutdown(self) -> pulumi.Output[Optional[bool]]:
3972
3810
  """
3973
- Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
3811
+ Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
3974
3812
  """
3975
3813
  return pulumi.get(self, "run_tools_scripts_before_guest_shutdown")
3976
3814
 
@@ -3978,43 +3816,33 @@ class VirtualMachine(pulumi.CustomResource):
3978
3816
  @pulumi.getter(name="runToolsScriptsBeforeGuestStandby")
3979
3817
  def run_tools_scripts_before_guest_standby(self) -> pulumi.Output[Optional[bool]]:
3980
3818
  """
3981
- Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
3819
+ Enable the run of scripts before guest operating system standby when VMware Tools is installed.
3982
3820
  """
3983
3821
  return pulumi.get(self, "run_tools_scripts_before_guest_standby")
3984
3822
 
3985
3823
  @property
3986
3824
  @pulumi.getter(name="sataControllerCount")
3987
3825
  def sata_controller_count(self) -> pulumi.Output[Optional[int]]:
3988
- """
3989
- The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
3990
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
3991
- controllers.
3992
- """
3993
3826
  return pulumi.get(self, "sata_controller_count")
3994
3827
 
3995
3828
  @property
3996
3829
  @pulumi.getter(name="scsiBusSharing")
3997
3830
  def scsi_bus_sharing(self) -> pulumi.Output[Optional[str]]:
3998
3831
  """
3999
- The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
3832
+ Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
4000
3833
  """
4001
3834
  return pulumi.get(self, "scsi_bus_sharing")
4002
3835
 
4003
3836
  @property
4004
3837
  @pulumi.getter(name="scsiControllerCount")
4005
3838
  def scsi_controller_count(self) -> pulumi.Output[Optional[int]]:
4006
- """
4007
- The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
4008
- you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
4009
- controllers.
4010
- """
4011
3839
  return pulumi.get(self, "scsi_controller_count")
4012
3840
 
4013
3841
  @property
4014
3842
  @pulumi.getter(name="scsiType")
4015
3843
  def scsi_type(self) -> pulumi.Output[Optional[str]]:
4016
3844
  """
4017
- The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
3845
+ The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
4018
3846
  """
4019
3847
  return pulumi.get(self, "scsi_type")
4020
3848
 
@@ -4022,7 +3850,7 @@ class VirtualMachine(pulumi.CustomResource):
4022
3850
  @pulumi.getter(name="shutdownWaitTimeout")
4023
3851
  def shutdown_wait_timeout(self) -> pulumi.Output[Optional[int]]:
4024
3852
  """
4025
- The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
3853
+ The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
4026
3854
  """
4027
3855
  return pulumi.get(self, "shutdown_wait_timeout")
4028
3856
 
@@ -4030,7 +3858,7 @@ class VirtualMachine(pulumi.CustomResource):
4030
3858
  @pulumi.getter(name="storagePolicyId")
4031
3859
  def storage_policy_id(self) -> pulumi.Output[str]:
4032
3860
  """
4033
- The UUID of the storage policy to assign to the virtual disk.
3861
+ The ID of the storage policy to assign to the virtual machine home directory.
4034
3862
  """
4035
3863
  return pulumi.get(self, "storage_policy_id")
4036
3864
 
@@ -4038,7 +3866,7 @@ class VirtualMachine(pulumi.CustomResource):
4038
3866
  @pulumi.getter(name="swapPlacementPolicy")
4039
3867
  def swap_placement_policy(self) -> pulumi.Output[Optional[str]]:
4040
3868
  """
4041
- The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
3869
+ The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
4042
3870
  """
4043
3871
  return pulumi.get(self, "swap_placement_policy")
4044
3872
 
@@ -4046,7 +3874,8 @@ class VirtualMachine(pulumi.CustomResource):
4046
3874
  @pulumi.getter(name="syncTimeWithHost")
4047
3875
  def sync_time_with_host(self) -> pulumi.Output[Optional[bool]]:
4048
3876
  """
4049
- Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `false`.
3877
+ Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
3878
+ synchronized on startup and resume. Requires VMware Tools to be installed.
4050
3879
  """
4051
3880
  return pulumi.get(self, "sync_time_with_host")
4052
3881
 
@@ -4054,7 +3883,8 @@ class VirtualMachine(pulumi.CustomResource):
4054
3883
  @pulumi.getter(name="syncTimeWithHostPeriodically")
4055
3884
  def sync_time_with_host_periodically(self) -> pulumi.Output[Optional[bool]]:
4056
3885
  """
4057
- Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
3886
+ Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
3887
+ setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
4058
3888
  """
4059
3889
  return pulumi.get(self, "sync_time_with_host_periodically")
4060
3890
 
@@ -4062,9 +3892,7 @@ class VirtualMachine(pulumi.CustomResource):
4062
3892
  @pulumi.getter
4063
3893
  def tags(self) -> pulumi.Output[Optional[Sequence[str]]]:
4064
3894
  """
4065
- The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
4066
-
4067
- > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
3895
+ A list of tag IDs to apply to this object.
4068
3896
  """
4069
3897
  return pulumi.get(self, "tags")
4070
3898
 
@@ -4072,7 +3900,7 @@ class VirtualMachine(pulumi.CustomResource):
4072
3900
  @pulumi.getter(name="toolsUpgradePolicy")
4073
3901
  def tools_upgrade_policy(self) -> pulumi.Output[Optional[str]]:
4074
3902
  """
4075
- Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
3903
+ Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
4076
3904
  """
4077
3905
  return pulumi.get(self, "tools_upgrade_policy")
4078
3906
 
@@ -4080,7 +3908,7 @@ class VirtualMachine(pulumi.CustomResource):
4080
3908
  @pulumi.getter
4081
3909
  def uuid(self) -> pulumi.Output[str]:
4082
3910
  """
4083
- The UUID of the virtual disk VMDK file. This is used to track the virtual disk on the virtual machine.
3911
+ The UUID of the virtual machine. Also exposed as the `id` of the resource.
4084
3912
  """
4085
3913
  return pulumi.get(self, "uuid")
4086
3914
 
@@ -4088,7 +3916,7 @@ class VirtualMachine(pulumi.CustomResource):
4088
3916
  @pulumi.getter
4089
3917
  def vapp(self) -> pulumi.Output[Optional['outputs.VirtualMachineVapp']]:
4090
3918
  """
4091
- Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
3919
+ vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
4092
3920
  """
4093
3921
  return pulumi.get(self, "vapp")
4094
3922
 
@@ -4104,7 +3932,7 @@ class VirtualMachine(pulumi.CustomResource):
4104
3932
  @pulumi.getter(name="vbsEnabled")
4105
3933
  def vbs_enabled(self) -> pulumi.Output[Optional[bool]]:
4106
3934
  """
4107
- Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
3935
+ Flag to specify if Virtualization-based security is enabled for this virtual machine.
4108
3936
  """
4109
3937
  return pulumi.get(self, "vbs_enabled")
4110
3938
 
@@ -4128,7 +3956,8 @@ class VirtualMachine(pulumi.CustomResource):
4128
3956
  @pulumi.getter(name="vvtdEnabled")
4129
3957
  def vvtd_enabled(self) -> pulumi.Output[Optional[bool]]:
4130
3958
  """
4131
- Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
3959
+ Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
3960
+ I/O Virtualization (AMD-Vi or IOMMU), is enabled.
4132
3961
  """
4133
3962
  return pulumi.get(self, "vvtd_enabled")
4134
3963
 
@@ -4136,7 +3965,8 @@ class VirtualMachine(pulumi.CustomResource):
4136
3965
  @pulumi.getter(name="waitForGuestIpTimeout")
4137
3966
  def wait_for_guest_ip_timeout(self) -> pulumi.Output[Optional[int]]:
4138
3967
  """
4139
- The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
3968
+ The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
3969
+ disables the waiter.
4140
3970
  """
4141
3971
  return pulumi.get(self, "wait_for_guest_ip_timeout")
4142
3972
 
@@ -4144,7 +3974,8 @@ class VirtualMachine(pulumi.CustomResource):
4144
3974
  @pulumi.getter(name="waitForGuestNetRoutable")
4145
3975
  def wait_for_guest_net_routable(self) -> pulumi.Output[Optional[bool]]:
4146
3976
  """
4147
- Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
3977
+ Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
3978
+ a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
4148
3979
  """
4149
3980
  return pulumi.get(self, "wait_for_guest_net_routable")
4150
3981
 
@@ -4152,7 +3983,8 @@ class VirtualMachine(pulumi.CustomResource):
4152
3983
  @pulumi.getter(name="waitForGuestNetTimeout")
4153
3984
  def wait_for_guest_net_timeout(self) -> pulumi.Output[Optional[int]]:
4154
3985
  """
4155
- The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
3986
+ The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
3987
+ disables the waiter.
4156
3988
  """
4157
3989
  return pulumi.get(self, "wait_for_guest_net_timeout")
4158
3990