PyPI - pulumi-vsphere - Versions diffs - 4.10.0a1710245029__py3-none-any.whl → 4.13.0a1736849827__py3-none-any.whl - Mend

pulumi-vsphere 4.10.0a1710245029py3-none-any.whl → 4.13.0a1736849827py3-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.

Files changed (85) hide show

pulumi_vsphere/__init__.py +28 -0
pulumi_vsphere/_inputs.py +1816 -277
pulumi_vsphere/_utilities.py +41 -5
pulumi_vsphere/compute_cluster.py +937 -1488
pulumi_vsphere/compute_cluster_host_group.py +67 -2
pulumi_vsphere/compute_cluster_vm_affinity_rule.py +69 -34
pulumi_vsphere/compute_cluster_vm_anti_affinity_rule.py +41 -2
pulumi_vsphere/compute_cluster_vm_dependency_rule.py +205 -2
pulumi_vsphere/compute_cluster_vm_group.py +198 -2
pulumi_vsphere/compute_cluster_vm_host_rule.py +73 -2
pulumi_vsphere/config/__init__.pyi +5 -0
pulumi_vsphere/config/vars.py +5 -0
pulumi_vsphere/content_library.py +113 -12
pulumi_vsphere/content_library_item.py +143 -2
pulumi_vsphere/custom_attribute.py +77 -2
pulumi_vsphere/datacenter.py +48 -40
pulumi_vsphere/datastore_cluster.py +217 -366
pulumi_vsphere/datastore_cluster_vm_anti_affinity_rule.py +159 -2
pulumi_vsphere/distributed_port_group.py +416 -189
pulumi_vsphere/distributed_virtual_switch.py +571 -830
pulumi_vsphere/dpm_host_override.py +63 -2
pulumi_vsphere/drs_vm_override.py +67 -2
pulumi_vsphere/entity_permissions.py +64 -38
pulumi_vsphere/file.py +21 -24
pulumi_vsphere/folder.py +148 -30
pulumi_vsphere/get_compute_cluster.py +16 -9
pulumi_vsphere/get_compute_cluster_host_group.py +36 -25
pulumi_vsphere/get_content_library.py +23 -15
pulumi_vsphere/get_content_library_item.py +29 -13
pulumi_vsphere/get_custom_attribute.py +14 -9
pulumi_vsphere/get_datacenter.py +30 -12
pulumi_vsphere/get_datastore.py +29 -21
pulumi_vsphere/get_datastore_cluster.py +31 -10
pulumi_vsphere/get_datastore_stats.py +63 -57
pulumi_vsphere/get_distributed_virtual_switch.py +18 -9
pulumi_vsphere/get_dynamic.py +35 -25
pulumi_vsphere/get_folder.py +23 -11
pulumi_vsphere/get_guest_os_customization.py +26 -52
pulumi_vsphere/get_host.py +16 -9
pulumi_vsphere/get_host_base_images.py +104 -0
pulumi_vsphere/get_host_pci_device.py +28 -19
pulumi_vsphere/get_host_thumbprint.py +41 -25
pulumi_vsphere/get_host_vgpu_profile.py +20 -15
pulumi_vsphere/get_license.py +20 -10
pulumi_vsphere/get_network.py +80 -24
pulumi_vsphere/get_ovf_vm_template.py +56 -5
pulumi_vsphere/get_policy.py +13 -9
pulumi_vsphere/get_resource_pool.py +29 -23
pulumi_vsphere/get_role.py +23 -13
pulumi_vsphere/get_tag.py +16 -9
pulumi_vsphere/get_tag_category.py +16 -9
pulumi_vsphere/get_vapp_container.py +15 -9
pulumi_vsphere/get_virtual_machine.py +205 -48
pulumi_vsphere/get_vmfs_disks.py +18 -9
pulumi_vsphere/guest_os_customization.py +60 -5
pulumi_vsphere/ha_vm_override.py +352 -380
pulumi_vsphere/host.py +244 -64
pulumi_vsphere/host_port_group.py +27 -24
pulumi_vsphere/host_virtual_switch.py +209 -289
pulumi_vsphere/license.py +5 -32
pulumi_vsphere/nas_datastore.py +74 -9
pulumi_vsphere/offline_software_depot.py +185 -0
pulumi_vsphere/outputs.py +717 -270
pulumi_vsphere/provider.py +7 -6
pulumi_vsphere/pulumi-plugin.json +2 -1
pulumi_vsphere/resource_pool.py +168 -411
pulumi_vsphere/role.py +33 -2
pulumi_vsphere/storage_drs_vm_override.py +133 -2
pulumi_vsphere/supervisor.py +967 -0
pulumi_vsphere/tag.py +159 -2
pulumi_vsphere/tag_category.py +83 -2
pulumi_vsphere/vapp_container.py +163 -2
pulumi_vsphere/vapp_entity.py +147 -2
pulumi_vsphere/virtual_disk.py +123 -36
pulumi_vsphere/virtual_machine.py +698 -829
pulumi_vsphere/virtual_machine_class.py +447 -0
pulumi_vsphere/virtual_machine_snapshot.py +13 -12
pulumi_vsphere/vm_storage_policy.py +120 -127
pulumi_vsphere/vmfs_datastore.py +271 -2
pulumi_vsphere/vnic.py +104 -105
{pulumi_vsphere-4.10.0a1710245029.dist-info → pulumi_vsphere-4.13.0a1736849827.dist-info}/METADATA +7 -6
pulumi_vsphere-4.13.0a1736849827.dist-info/RECORD +86 -0
{pulumi_vsphere-4.10.0a1710245029.dist-info → pulumi_vsphere-4.13.0a1736849827.dist-info}/WHEEL +1 -1
pulumi_vsphere-4.10.0a1710245029.dist-info/RECORD +0 -82
{pulumi_vsphere-4.10.0a1710245029.dist-info → pulumi_vsphere-4.13.0a1736849827.dist-info}/top_level.txt +0 -0

pulumi_vsphere/ha_vm_override.py CHANGED Viewed

@@ -4,9 +4,14 @@
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 __all__ = ['HaVmOverrideArgs', 'HaVmOverride']
@@ -31,60 +36,33 @@ class HaVmOverrideArgs:
                  ha_vm_restart_timeout: Optional[pulumi.Input[int]] = None):
         """
         The set of arguments for constructing a HaVmOverride resource.
-        :param pulumi.Input[str] compute_cluster_id: The managed object reference
-               ID of the cluster to put the override in.  Forces a new
-               resource if changed.
-        :param pulumi.Input[str] virtual_machine_id: The UUID of the virtual machine to create
-               the override for.  Forces a new resource if changed.
-        :param pulumi.Input[str] ha_datastore_apd_recovery_action: Controls the action to take
-               on this virtual machine if an APD status on an affected datastore clears in
-               the middle of an APD event. Can be one of `useClusterDefault`, `none` or
-               `reset`.  Default: `useClusterDefault`.
-        :param pulumi.Input[str] ha_datastore_apd_response: Controls the action to take on this
-               virtual machine when the cluster has detected loss to all paths to a relevant
-               datastore. Can be one of `clusterDefault`, `disabled`, `warning`,
-               `restartConservative`, or `restartAggressive`.  Default: `clusterDefault`.
-        :param pulumi.Input[int] ha_datastore_apd_response_delay: Controls the delay in seconds
-               to wait after an APD timeout event to execute the response action defined in
-               `ha_datastore_apd_response`. Use `-1` to use
-               the cluster default. Default: `-1`.
-        :param pulumi.Input[str] ha_datastore_pdl_response: Controls the action to take on this
-               virtual machine when the cluster has detected a permanent device loss to a
-               relevant datastore. Can be one of `clusterDefault`, `disabled`, `warning`, or
-               `restartAggressive`. Default: `clusterDefault`.
-        :param pulumi.Input[str] ha_host_isolation_response: The action to take on this virtual
-               machine when a host has detected that it has been isolated from the rest of
-               the cluster. Can be one of `clusterIsolationResponse`, `none`, `powerOff`, or
-               `shutdown`. Default: `clusterIsolationResponse`.
-        :param pulumi.Input[int] ha_vm_failure_interval: If a heartbeat from this virtual
-               machine is not received within this configured interval, the virtual machine
-               is marked as failed. The value is in seconds. Default: `30`.
-        :param pulumi.Input[int] ha_vm_maximum_failure_window: The length of the reset window in
-               which `ha_vm_maximum_resets` can operate. When this
-               window expires, no more resets are attempted regardless of the setting
-               configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
-               unlimited reset time is allotted. The value is specified in seconds. Default:
-               `-1` (no window).
-        :param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will
-               perform to this virtual machine when responding to a failure event. Default:
-               `3`
-        :param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after
-               powering on this virtual machine before monitoring for heartbeats. Default:
-               `120` (2 minutes).
-        :param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use
-               when HA is enabled in the cluster. Can be one of `vmMonitoringDisabled`,
-               `vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
-        :param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or
-               not the cluster's default settings or the VM override settings specified in
-               this resource are used for virtual machine monitoring. The default is `true`
-               (use cluster defaults) - set to `false` to have overrides take effect.
-        :param pulumi.Input[str] ha_vm_restart_priority: The restart priority for the virtual
-               machine when vSphere detects a host failure. Can be one of
-               `clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
-               Default: `clusterRestartPriority`.
-        :param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that
-               vSphere HA will wait for this virtual machine to be ready. Use `-1` to
-               specify the cluster default.  Default: `-1`.
+        :param pulumi.Input[str] compute_cluster_id: The managed object ID of the cluster.
+        :param pulumi.Input[str] virtual_machine_id: The managed object ID of the virtual machine.
+        :param pulumi.Input[str] ha_datastore_apd_recovery_action: Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
+               APD event. Can be one of useClusterDefault, none or reset.
+        :param pulumi.Input[str] ha_datastore_apd_response: Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
+               datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
+        :param pulumi.Input[int] ha_datastore_apd_response_delay: Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
+               ha_datastore_apd_response. Specify -1 to use the cluster setting.
+        :param pulumi.Input[str] ha_datastore_pdl_response: Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
+               datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
+        :param pulumi.Input[str] ha_host_isolation_response: The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
+               clusterIsolationResponse, none, powerOff, or shutdown.
+        :param pulumi.Input[int] ha_vm_failure_interval: If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
+               as failed. The value is in seconds.
+        :param pulumi.Input[int] ha_vm_maximum_failure_window: The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
+               attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
+               time is allotted.
+        :param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
+        :param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
+        :param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
+               vmMonitoringOnly, or vmAndAppMonitoring.
+        :param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
+               for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
+        :param pulumi.Input[str] ha_vm_restart_priority: The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
+               lowest, low, medium, high, or highest.
+        :param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
+               default.
         """
         pulumi.set(__self__, "compute_cluster_id", compute_cluster_id)
         pulumi.set(__self__, "virtual_machine_id", virtual_machine_id)
@@ -119,9 +97,7 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="computeClusterId")
     def compute_cluster_id(self) -> pulumi.Input[str]:
         """
-        The managed object reference
-        ID of the cluster to put the override in.  Forces a new
-        resource if changed.
+        The managed object ID of the cluster.
         """
         return pulumi.get(self, "compute_cluster_id")
@@ -133,8 +109,7 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="virtualMachineId")
     def virtual_machine_id(self) -> pulumi.Input[str]:
         """
-        The UUID of the virtual machine to create
-        the override for.  Forces a new resource if changed.
+        The managed object ID of the virtual machine.
         """
         return pulumi.get(self, "virtual_machine_id")
@@ -146,10 +121,8 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="haDatastoreApdRecoveryAction")
     def ha_datastore_apd_recovery_action(self) -> Optional[pulumi.Input[str]]:
         """
-        Controls the action to take
-        on this virtual machine if an APD status on an affected datastore clears in
-        the middle of an APD event. Can be one of `useClusterDefault`, `none` or
-        `reset`.  Default: `useClusterDefault`.
+        Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
+        APD event. Can be one of useClusterDefault, none or reset.
         """
         return pulumi.get(self, "ha_datastore_apd_recovery_action")
@@ -161,10 +134,8 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="haDatastoreApdResponse")
     def ha_datastore_apd_response(self) -> Optional[pulumi.Input[str]]:
         """
-        Controls the action to take on this
-        virtual machine when the cluster has detected loss to all paths to a relevant
-        datastore. Can be one of `clusterDefault`, `disabled`, `warning`,
-        `restartConservative`, or `restartAggressive`.  Default: `clusterDefault`.
+        Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
+        datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
         """
         return pulumi.get(self, "ha_datastore_apd_response")
@@ -176,10 +147,8 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="haDatastoreApdResponseDelay")
     def ha_datastore_apd_response_delay(self) -> Optional[pulumi.Input[int]]:
         """
-        Controls the delay in seconds
-        to wait after an APD timeout event to execute the response action defined in
-        `ha_datastore_apd_response`. Use `-1` to use
-        the cluster default. Default: `-1`.
+        Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
+        ha_datastore_apd_response. Specify -1 to use the cluster setting.
         """
         return pulumi.get(self, "ha_datastore_apd_response_delay")
@@ -191,10 +160,8 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="haDatastorePdlResponse")
     def ha_datastore_pdl_response(self) -> Optional[pulumi.Input[str]]:
         """
-        Controls the action to take on this
-        virtual machine when the cluster has detected a permanent device loss to a
-        relevant datastore. Can be one of `clusterDefault`, `disabled`, `warning`, or
-        `restartAggressive`. Default: `clusterDefault`.
+        Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
+        datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
         """
         return pulumi.get(self, "ha_datastore_pdl_response")
@@ -206,10 +173,8 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="haHostIsolationResponse")
     def ha_host_isolation_response(self) -> Optional[pulumi.Input[str]]:
         """
-        The action to take on this virtual
-        machine when a host has detected that it has been isolated from the rest of
-        the cluster. Can be one of `clusterIsolationResponse`, `none`, `powerOff`, or
-        `shutdown`. Default: `clusterIsolationResponse`.
+        The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
+        clusterIsolationResponse, none, powerOff, or shutdown.
         """
         return pulumi.get(self, "ha_host_isolation_response")
@@ -221,9 +186,8 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="haVmFailureInterval")
     def ha_vm_failure_interval(self) -> Optional[pulumi.Input[int]]:
         """
-        If a heartbeat from this virtual
-        machine is not received within this configured interval, the virtual machine
-        is marked as failed. The value is in seconds. Default: `30`.
+        If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
+        as failed. The value is in seconds.
         """
         return pulumi.get(self, "ha_vm_failure_interval")
@@ -235,12 +199,9 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="haVmMaximumFailureWindow")
     def ha_vm_maximum_failure_window(self) -> Optional[pulumi.Input[int]]:
         """
-        The length of the reset window in
-        which `ha_vm_maximum_resets` can operate. When this
-        window expires, no more resets are attempted regardless of the setting
-        configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
-        unlimited reset time is allotted. The value is specified in seconds. Default:
-        `-1` (no window).
+        The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
+        attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
+        time is allotted.
         """
         return pulumi.get(self, "ha_vm_maximum_failure_window")
@@ -252,9 +213,7 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="haVmMaximumResets")
     def ha_vm_maximum_resets(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum number of resets that HA will
-        perform to this virtual machine when responding to a failure event. Default:
-        `3`
+        The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
         """
         return pulumi.get(self, "ha_vm_maximum_resets")
@@ -266,9 +225,7 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="haVmMinimumUptime")
     def ha_vm_minimum_uptime(self) -> Optional[pulumi.Input[int]]:
         """
-        The time, in seconds, that HA waits after
-        powering on this virtual machine before monitoring for heartbeats. Default:
-        `120` (2 minutes).
+        The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
         """
         return pulumi.get(self, "ha_vm_minimum_uptime")
@@ -280,9 +237,8 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="haVmMonitoring")
     def ha_vm_monitoring(self) -> Optional[pulumi.Input[str]]:
         """
-        The type of virtual machine monitoring to use
-        when HA is enabled in the cluster. Can be one of `vmMonitoringDisabled`,
-        `vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
+        The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
+        vmMonitoringOnly, or vmAndAppMonitoring.
         """
         return pulumi.get(self, "ha_vm_monitoring")
@@ -294,10 +250,8 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="haVmMonitoringUseClusterDefaults")
     def ha_vm_monitoring_use_cluster_defaults(self) -> Optional[pulumi.Input[bool]]:
         """
-        Determines whether or
-        not the cluster's default settings or the VM override settings specified in
-        this resource are used for virtual machine monitoring. The default is `true`
-        (use cluster defaults) - set to `false` to have overrides take effect.
+        Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
+        for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
         """
         return pulumi.get(self, "ha_vm_monitoring_use_cluster_defaults")
@@ -309,10 +263,8 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="haVmRestartPriority")
     def ha_vm_restart_priority(self) -> Optional[pulumi.Input[str]]:
         """
-        The restart priority for the virtual
-        machine when vSphere detects a host failure. Can be one of
-        `clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
-        Default: `clusterRestartPriority`.
+        The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
+        lowest, low, medium, high, or highest.
         """
         return pulumi.get(self, "ha_vm_restart_priority")
@@ -324,9 +276,8 @@ class HaVmOverrideArgs:
     @pulumi.getter(name="haVmRestartTimeout")
     def ha_vm_restart_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum time, in seconds, that
-        vSphere HA will wait for this virtual machine to be ready. Use `-1` to
-        specify the cluster default.  Default: `-1`.
+        The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
+        default.
         """
         return pulumi.get(self, "ha_vm_restart_timeout")
@@ -355,60 +306,33 @@ class _HaVmOverrideState:
                  virtual_machine_id: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering HaVmOverride resources.
-        :param pulumi.Input[str] compute_cluster_id: The managed object reference
-               ID of the cluster to put the override in.  Forces a new
-               resource if changed.
-        :param pulumi.Input[str] ha_datastore_apd_recovery_action: Controls the action to take
-               on this virtual machine if an APD status on an affected datastore clears in
-               the middle of an APD event. Can be one of `useClusterDefault`, `none` or
-               `reset`.  Default: `useClusterDefault`.
-        :param pulumi.Input[str] ha_datastore_apd_response: Controls the action to take on this
-               virtual machine when the cluster has detected loss to all paths to a relevant
-               datastore. Can be one of `clusterDefault`, `disabled`, `warning`,
-               `restartConservative`, or `restartAggressive`.  Default: `clusterDefault`.
-        :param pulumi.Input[int] ha_datastore_apd_response_delay: Controls the delay in seconds
-               to wait after an APD timeout event to execute the response action defined in
-               `ha_datastore_apd_response`. Use `-1` to use
-               the cluster default. Default: `-1`.
-        :param pulumi.Input[str] ha_datastore_pdl_response: Controls the action to take on this
-               virtual machine when the cluster has detected a permanent device loss to a
-               relevant datastore. Can be one of `clusterDefault`, `disabled`, `warning`, or
-               `restartAggressive`. Default: `clusterDefault`.
-        :param pulumi.Input[str] ha_host_isolation_response: The action to take on this virtual
-               machine when a host has detected that it has been isolated from the rest of
-               the cluster. Can be one of `clusterIsolationResponse`, `none`, `powerOff`, or
-               `shutdown`. Default: `clusterIsolationResponse`.
-        :param pulumi.Input[int] ha_vm_failure_interval: If a heartbeat from this virtual
-               machine is not received within this configured interval, the virtual machine
-               is marked as failed. The value is in seconds. Default: `30`.
-        :param pulumi.Input[int] ha_vm_maximum_failure_window: The length of the reset window in
-               which `ha_vm_maximum_resets` can operate. When this
-               window expires, no more resets are attempted regardless of the setting
-               configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
-               unlimited reset time is allotted. The value is specified in seconds. Default:
-               `-1` (no window).
-        :param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will
-               perform to this virtual machine when responding to a failure event. Default:
-               `3`
-        :param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after
-               powering on this virtual machine before monitoring for heartbeats. Default:
-               `120` (2 minutes).
-        :param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use
-               when HA is enabled in the cluster. Can be one of `vmMonitoringDisabled`,
-               `vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
-        :param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or
-               not the cluster's default settings or the VM override settings specified in
-               this resource are used for virtual machine monitoring. The default is `true`
-               (use cluster defaults) - set to `false` to have overrides take effect.
-        :param pulumi.Input[str] ha_vm_restart_priority: The restart priority for the virtual
-               machine when vSphere detects a host failure. Can be one of
-               `clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
-               Default: `clusterRestartPriority`.
-        :param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that
-               vSphere HA will wait for this virtual machine to be ready. Use `-1` to
-               specify the cluster default.  Default: `-1`.
-        :param pulumi.Input[str] virtual_machine_id: The UUID of the virtual machine to create
-               the override for.  Forces a new resource if changed.
+        :param pulumi.Input[str] compute_cluster_id: The managed object ID of the cluster.
+        :param pulumi.Input[str] ha_datastore_apd_recovery_action: Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
+               APD event. Can be one of useClusterDefault, none or reset.
+        :param pulumi.Input[str] ha_datastore_apd_response: Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
+               datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
+        :param pulumi.Input[int] ha_datastore_apd_response_delay: Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
+               ha_datastore_apd_response. Specify -1 to use the cluster setting.
+        :param pulumi.Input[str] ha_datastore_pdl_response: Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
+               datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
+        :param pulumi.Input[str] ha_host_isolation_response: The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
+               clusterIsolationResponse, none, powerOff, or shutdown.
+        :param pulumi.Input[int] ha_vm_failure_interval: If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
+               as failed. The value is in seconds.
+        :param pulumi.Input[int] ha_vm_maximum_failure_window: The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
+               attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
+               time is allotted.
+        :param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
+        :param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
+        :param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
+               vmMonitoringOnly, or vmAndAppMonitoring.
+        :param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
+               for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
+        :param pulumi.Input[str] ha_vm_restart_priority: The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
+               lowest, low, medium, high, or highest.
+        :param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
+               default.
+        :param pulumi.Input[str] virtual_machine_id: The managed object ID of the virtual machine.
         """
         if compute_cluster_id is not None:
             pulumi.set(__self__, "compute_cluster_id", compute_cluster_id)
@@ -445,9 +369,7 @@ class _HaVmOverrideState:
     @pulumi.getter(name="computeClusterId")
     def compute_cluster_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The managed object reference
-        ID of the cluster to put the override in.  Forces a new
-        resource if changed.
+        The managed object ID of the cluster.
         """
         return pulumi.get(self, "compute_cluster_id")
@@ -459,10 +381,8 @@ class _HaVmOverrideState:
     @pulumi.getter(name="haDatastoreApdRecoveryAction")
     def ha_datastore_apd_recovery_action(self) -> Optional[pulumi.Input[str]]:
         """
-        Controls the action to take
-        on this virtual machine if an APD status on an affected datastore clears in
-        the middle of an APD event. Can be one of `useClusterDefault`, `none` or
-        `reset`.  Default: `useClusterDefault`.
+        Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
+        APD event. Can be one of useClusterDefault, none or reset.
         """
         return pulumi.get(self, "ha_datastore_apd_recovery_action")
@@ -474,10 +394,8 @@ class _HaVmOverrideState:
     @pulumi.getter(name="haDatastoreApdResponse")
     def ha_datastore_apd_response(self) -> Optional[pulumi.Input[str]]:
         """
-        Controls the action to take on this
-        virtual machine when the cluster has detected loss to all paths to a relevant
-        datastore. Can be one of `clusterDefault`, `disabled`, `warning`,
-        `restartConservative`, or `restartAggressive`.  Default: `clusterDefault`.
+        Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
+        datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
         """
         return pulumi.get(self, "ha_datastore_apd_response")
@@ -489,10 +407,8 @@ class _HaVmOverrideState:
     @pulumi.getter(name="haDatastoreApdResponseDelay")
     def ha_datastore_apd_response_delay(self) -> Optional[pulumi.Input[int]]:
         """
-        Controls the delay in seconds
-        to wait after an APD timeout event to execute the response action defined in
-        `ha_datastore_apd_response`. Use `-1` to use
-        the cluster default. Default: `-1`.
+        Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
+        ha_datastore_apd_response. Specify -1 to use the cluster setting.
         """
         return pulumi.get(self, "ha_datastore_apd_response_delay")
@@ -504,10 +420,8 @@ class _HaVmOverrideState:
     @pulumi.getter(name="haDatastorePdlResponse")
     def ha_datastore_pdl_response(self) -> Optional[pulumi.Input[str]]:
         """
-        Controls the action to take on this
-        virtual machine when the cluster has detected a permanent device loss to a
-        relevant datastore. Can be one of `clusterDefault`, `disabled`, `warning`, or
-        `restartAggressive`. Default: `clusterDefault`.
+        Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
+        datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
         """
         return pulumi.get(self, "ha_datastore_pdl_response")
@@ -519,10 +433,8 @@ class _HaVmOverrideState:
     @pulumi.getter(name="haHostIsolationResponse")
     def ha_host_isolation_response(self) -> Optional[pulumi.Input[str]]:
         """
-        The action to take on this virtual
-        machine when a host has detected that it has been isolated from the rest of
-        the cluster. Can be one of `clusterIsolationResponse`, `none`, `powerOff`, or
-        `shutdown`. Default: `clusterIsolationResponse`.
+        The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
+        clusterIsolationResponse, none, powerOff, or shutdown.
         """
         return pulumi.get(self, "ha_host_isolation_response")
@@ -534,9 +446,8 @@ class _HaVmOverrideState:
     @pulumi.getter(name="haVmFailureInterval")
     def ha_vm_failure_interval(self) -> Optional[pulumi.Input[int]]:
         """
-        If a heartbeat from this virtual
-        machine is not received within this configured interval, the virtual machine
-        is marked as failed. The value is in seconds. Default: `30`.
+        If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
+        as failed. The value is in seconds.
         """
         return pulumi.get(self, "ha_vm_failure_interval")
@@ -548,12 +459,9 @@ class _HaVmOverrideState:
     @pulumi.getter(name="haVmMaximumFailureWindow")
     def ha_vm_maximum_failure_window(self) -> Optional[pulumi.Input[int]]:
         """
-        The length of the reset window in
-        which `ha_vm_maximum_resets` can operate. When this
-        window expires, no more resets are attempted regardless of the setting
-        configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
-        unlimited reset time is allotted. The value is specified in seconds. Default:
-        `-1` (no window).
+        The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
+        attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
+        time is allotted.
         """
         return pulumi.get(self, "ha_vm_maximum_failure_window")
@@ -565,9 +473,7 @@ class _HaVmOverrideState:
     @pulumi.getter(name="haVmMaximumResets")
     def ha_vm_maximum_resets(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum number of resets that HA will
-        perform to this virtual machine when responding to a failure event. Default:
-        `3`
+        The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
         """
         return pulumi.get(self, "ha_vm_maximum_resets")
@@ -579,9 +485,7 @@ class _HaVmOverrideState:
     @pulumi.getter(name="haVmMinimumUptime")
     def ha_vm_minimum_uptime(self) -> Optional[pulumi.Input[int]]:
         """
-        The time, in seconds, that HA waits after
-        powering on this virtual machine before monitoring for heartbeats. Default:
-        `120` (2 minutes).
+        The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
         """
         return pulumi.get(self, "ha_vm_minimum_uptime")
@@ -593,9 +497,8 @@ class _HaVmOverrideState:
     @pulumi.getter(name="haVmMonitoring")
     def ha_vm_monitoring(self) -> Optional[pulumi.Input[str]]:
         """
-        The type of virtual machine monitoring to use
-        when HA is enabled in the cluster. Can be one of `vmMonitoringDisabled`,
-        `vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
+        The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
+        vmMonitoringOnly, or vmAndAppMonitoring.
         """
         return pulumi.get(self, "ha_vm_monitoring")
@@ -607,10 +510,8 @@ class _HaVmOverrideState:
     @pulumi.getter(name="haVmMonitoringUseClusterDefaults")
     def ha_vm_monitoring_use_cluster_defaults(self) -> Optional[pulumi.Input[bool]]:
         """
-        Determines whether or
-        not the cluster's default settings or the VM override settings specified in
-        this resource are used for virtual machine monitoring. The default is `true`
-        (use cluster defaults) - set to `false` to have overrides take effect.
+        Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
+        for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
         """
         return pulumi.get(self, "ha_vm_monitoring_use_cluster_defaults")
@@ -622,10 +523,8 @@ class _HaVmOverrideState:
     @pulumi.getter(name="haVmRestartPriority")
     def ha_vm_restart_priority(self) -> Optional[pulumi.Input[str]]:
         """
-        The restart priority for the virtual
-        machine when vSphere detects a host failure. Can be one of
-        `clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
-        Default: `clusterRestartPriority`.
+        The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
+        lowest, low, medium, high, or highest.
         """
         return pulumi.get(self, "ha_vm_restart_priority")
@@ -637,9 +536,8 @@ class _HaVmOverrideState:
     @pulumi.getter(name="haVmRestartTimeout")
     def ha_vm_restart_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum time, in seconds, that
-        vSphere HA will wait for this virtual machine to be ready. Use `-1` to
-        specify the cluster default.  Default: `-1`.
+        The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
+        default.
         """
         return pulumi.get(self, "ha_vm_restart_timeout")
@@ -651,8 +549,7 @@ class _HaVmOverrideState:
     @pulumi.getter(name="virtualMachineId")
     def virtual_machine_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The UUID of the virtual machine to create
-        the override for.  Forces a new resource if changed.
+        The managed object ID of the virtual machine.
         """
         return pulumi.get(self, "virtual_machine_id")
@@ -683,63 +580,114 @@ class HaVmOverride(pulumi.CustomResource):
                  virtual_machine_id: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Create a HaVmOverride resource with the given unique name, props, and options.
+        The `HaVmOverride` resource can be used to add an override for
+        vSphere HA settings on a cluster for a specific virtual machine. With this
+        resource, one can control specific HA settings so that they are different than
+        the cluster default, accommodating the needs of that specific virtual machine,
+        while not affecting the rest of the cluster.
+        For more information on vSphere HA, see [this page][ref-vsphere-ha-clusters].
+        [ref-vsphere-ha-clusters]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-availability/GUID-5432CA24-14F1-44E3-87FB-61D937831CF6.html
+        > **NOTE:** This resource requires vCenter and is not available on direct ESXi
+        connections.
+        ## Example Usage
+        The example below creates a virtual machine in a cluster using the
+        `VirtualMachine` resource, creating the
+        virtual machine in the cluster looked up by the
+        `ComputeCluster` data source.
+        Considering a scenario where this virtual machine is of high value to the
+        application or organization for which it does its work, it's been determined in
+        the event of a host failure, that this should be one of the first virtual
+        machines to be started by vSphere HA during recovery. Hence, it
+        `ha_vm_restart_priority` has been set to `highest`,
+        which, assuming that the default restart priority is `medium` and no other
+        virtual machine has been assigned the `highest` priority, will mean that this
+        VM will be started before any other virtual machine in the event of host
+        failure.
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        datastore = vsphere.get_datastore(name="datastore1",
+            datacenter_id=datacenter.id)
+        cluster = vsphere.get_compute_cluster(name="cluster-01",
+            datacenter_id=datacenter.id)
+        network = vsphere.get_network(name="network1",
+            datacenter_id=datacenter.id)
+        vm = vsphere.VirtualMachine("vm",
+            name="test",
+            resource_pool_id=cluster.resource_pool_id,
+            datastore_id=datastore.id,
+            num_cpus=2,
+            memory=2048,
+            guest_id="otherLinux64Guest",
+            network_interfaces=[{
+                "network_id": network.id,
+            }],
+            disks=[{
+                "label": "disk0",
+                "size": 20,
+            }])
+        ha_vm_override = vsphere.HaVmOverride("ha_vm_override",
+            compute_cluster_id=cluster.id,
+            virtual_machine_id=vm.id,
+            ha_vm_restart_priority="highest")
+        ```
+        ## Import
+        An existing override can be imported into this resource by
+        supplying both the path to the cluster, and the path to the virtual machine, to
+        `pulumi import`. If no override exists, an error will be given.  An example
+        is below:
+        ```sh
+        $ pulumi import vsphere:index/haVmOverride:HaVmOverride ha_vm_override \\
+        ```
+          '{"compute_cluster_path": "/dc1/host/cluster1", \\
+          "virtual_machine_path": "/dc1/vm/srv1"}'
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] compute_cluster_id: The managed object reference
-               ID of the cluster to put the override in.  Forces a new
-               resource if changed.
-        :param pulumi.Input[str] ha_datastore_apd_recovery_action: Controls the action to take
-               on this virtual machine if an APD status on an affected datastore clears in
-               the middle of an APD event. Can be one of `useClusterDefault`, `none` or
-               `reset`.  Default: `useClusterDefault`.
-        :param pulumi.Input[str] ha_datastore_apd_response: Controls the action to take on this
-               virtual machine when the cluster has detected loss to all paths to a relevant
-               datastore. Can be one of `clusterDefault`, `disabled`, `warning`,
-               `restartConservative`, or `restartAggressive`.  Default: `clusterDefault`.
-        :param pulumi.Input[int] ha_datastore_apd_response_delay: Controls the delay in seconds
-               to wait after an APD timeout event to execute the response action defined in
-               `ha_datastore_apd_response`. Use `-1` to use
-               the cluster default. Default: `-1`.
-        :param pulumi.Input[str] ha_datastore_pdl_response: Controls the action to take on this
-               virtual machine when the cluster has detected a permanent device loss to a
-               relevant datastore. Can be one of `clusterDefault`, `disabled`, `warning`, or
-               `restartAggressive`. Default: `clusterDefault`.
-        :param pulumi.Input[str] ha_host_isolation_response: The action to take on this virtual
-               machine when a host has detected that it has been isolated from the rest of
-               the cluster. Can be one of `clusterIsolationResponse`, `none`, `powerOff`, or
-               `shutdown`. Default: `clusterIsolationResponse`.
-        :param pulumi.Input[int] ha_vm_failure_interval: If a heartbeat from this virtual
-               machine is not received within this configured interval, the virtual machine
-               is marked as failed. The value is in seconds. Default: `30`.
-        :param pulumi.Input[int] ha_vm_maximum_failure_window: The length of the reset window in
-               which `ha_vm_maximum_resets` can operate. When this
-               window expires, no more resets are attempted regardless of the setting
-               configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
-               unlimited reset time is allotted. The value is specified in seconds. Default:
-               `-1` (no window).
-        :param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will
-               perform to this virtual machine when responding to a failure event. Default:
-               `3`
-        :param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after
-               powering on this virtual machine before monitoring for heartbeats. Default:
-               `120` (2 minutes).
-        :param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use
-               when HA is enabled in the cluster. Can be one of `vmMonitoringDisabled`,
-               `vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
-        :param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or
-               not the cluster's default settings or the VM override settings specified in
-               this resource are used for virtual machine monitoring. The default is `true`
-               (use cluster defaults) - set to `false` to have overrides take effect.
-        :param pulumi.Input[str] ha_vm_restart_priority: The restart priority for the virtual
-               machine when vSphere detects a host failure. Can be one of
-               `clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
-               Default: `clusterRestartPriority`.
-        :param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that
-               vSphere HA will wait for this virtual machine to be ready. Use `-1` to
-               specify the cluster default.  Default: `-1`.
-        :param pulumi.Input[str] virtual_machine_id: The UUID of the virtual machine to create
-               the override for.  Forces a new resource if changed.
+        :param pulumi.Input[str] compute_cluster_id: The managed object ID of the cluster.
+        :param pulumi.Input[str] ha_datastore_apd_recovery_action: Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
+               APD event. Can be one of useClusterDefault, none or reset.
+        :param pulumi.Input[str] ha_datastore_apd_response: Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
+               datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
+        :param pulumi.Input[int] ha_datastore_apd_response_delay: Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
+               ha_datastore_apd_response. Specify -1 to use the cluster setting.
+        :param pulumi.Input[str] ha_datastore_pdl_response: Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
+               datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
+        :param pulumi.Input[str] ha_host_isolation_response: The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
+               clusterIsolationResponse, none, powerOff, or shutdown.
+        :param pulumi.Input[int] ha_vm_failure_interval: If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
+               as failed. The value is in seconds.
+        :param pulumi.Input[int] ha_vm_maximum_failure_window: The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
+               attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
+               time is allotted.
+        :param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
+        :param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
+        :param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
+               vmMonitoringOnly, or vmAndAppMonitoring.
+        :param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
+               for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
+        :param pulumi.Input[str] ha_vm_restart_priority: The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
+               lowest, low, medium, high, or highest.
+        :param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
+               default.
+        :param pulumi.Input[str] virtual_machine_id: The managed object ID of the virtual machine.
         """
         ...
     @overload
@@ -748,7 +696,85 @@ class HaVmOverride(pulumi.CustomResource):
                  args: HaVmOverrideArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a HaVmOverride resource with the given unique name, props, and options.
+        The `HaVmOverride` resource can be used to add an override for
+        vSphere HA settings on a cluster for a specific virtual machine. With this
+        resource, one can control specific HA settings so that they are different than
+        the cluster default, accommodating the needs of that specific virtual machine,
+        while not affecting the rest of the cluster.
+        For more information on vSphere HA, see [this page][ref-vsphere-ha-clusters].
+        [ref-vsphere-ha-clusters]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-availability/GUID-5432CA24-14F1-44E3-87FB-61D937831CF6.html
+        > **NOTE:** This resource requires vCenter and is not available on direct ESXi
+        connections.
+        ## Example Usage
+        The example below creates a virtual machine in a cluster using the
+        `VirtualMachine` resource, creating the
+        virtual machine in the cluster looked up by the
+        `ComputeCluster` data source.
+        Considering a scenario where this virtual machine is of high value to the
+        application or organization for which it does its work, it's been determined in
+        the event of a host failure, that this should be one of the first virtual
+        machines to be started by vSphere HA during recovery. Hence, it
+        `ha_vm_restart_priority` has been set to `highest`,
+        which, assuming that the default restart priority is `medium` and no other
+        virtual machine has been assigned the `highest` priority, will mean that this
+        VM will be started before any other virtual machine in the event of host
+        failure.
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        datastore = vsphere.get_datastore(name="datastore1",
+            datacenter_id=datacenter.id)
+        cluster = vsphere.get_compute_cluster(name="cluster-01",
+            datacenter_id=datacenter.id)
+        network = vsphere.get_network(name="network1",
+            datacenter_id=datacenter.id)
+        vm = vsphere.VirtualMachine("vm",
+            name="test",
+            resource_pool_id=cluster.resource_pool_id,
+            datastore_id=datastore.id,
+            num_cpus=2,
+            memory=2048,
+            guest_id="otherLinux64Guest",
+            network_interfaces=[{
+                "network_id": network.id,
+            }],
+            disks=[{
+                "label": "disk0",
+                "size": 20,
+            }])
+        ha_vm_override = vsphere.HaVmOverride("ha_vm_override",
+            compute_cluster_id=cluster.id,
+            virtual_machine_id=vm.id,
+            ha_vm_restart_priority="highest")
+        ```
+        ## Import
+        An existing override can be imported into this resource by
+        supplying both the path to the cluster, and the path to the virtual machine, to
+        `pulumi import`. If no override exists, an error will be given.  An example
+        is below:
+        ```sh
+        $ pulumi import vsphere:index/haVmOverride:HaVmOverride ha_vm_override \\
+        ```
+          '{"compute_cluster_path": "/dc1/host/cluster1", \\
+          "virtual_machine_path": "/dc1/vm/srv1"}'
         :param str resource_name: The name of the resource.
         :param HaVmOverrideArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -839,60 +865,33 @@ class HaVmOverride(pulumi.CustomResource):
         :param str resource_name: The unique name of the resulting resource.
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] compute_cluster_id: The managed object reference
-               ID of the cluster to put the override in.  Forces a new
-               resource if changed.
-        :param pulumi.Input[str] ha_datastore_apd_recovery_action: Controls the action to take
-               on this virtual machine if an APD status on an affected datastore clears in
-               the middle of an APD event. Can be one of `useClusterDefault`, `none` or
-               `reset`.  Default: `useClusterDefault`.
-        :param pulumi.Input[str] ha_datastore_apd_response: Controls the action to take on this
-               virtual machine when the cluster has detected loss to all paths to a relevant
-               datastore. Can be one of `clusterDefault`, `disabled`, `warning`,
-               `restartConservative`, or `restartAggressive`.  Default: `clusterDefault`.
-        :param pulumi.Input[int] ha_datastore_apd_response_delay: Controls the delay in seconds
-               to wait after an APD timeout event to execute the response action defined in
-               `ha_datastore_apd_response`. Use `-1` to use
-               the cluster default. Default: `-1`.
-        :param pulumi.Input[str] ha_datastore_pdl_response: Controls the action to take on this
-               virtual machine when the cluster has detected a permanent device loss to a
-               relevant datastore. Can be one of `clusterDefault`, `disabled`, `warning`, or
-               `restartAggressive`. Default: `clusterDefault`.
-        :param pulumi.Input[str] ha_host_isolation_response: The action to take on this virtual
-               machine when a host has detected that it has been isolated from the rest of
-               the cluster. Can be one of `clusterIsolationResponse`, `none`, `powerOff`, or
-               `shutdown`. Default: `clusterIsolationResponse`.
-        :param pulumi.Input[int] ha_vm_failure_interval: If a heartbeat from this virtual
-               machine is not received within this configured interval, the virtual machine
-               is marked as failed. The value is in seconds. Default: `30`.
-        :param pulumi.Input[int] ha_vm_maximum_failure_window: The length of the reset window in
-               which `ha_vm_maximum_resets` can operate. When this
-               window expires, no more resets are attempted regardless of the setting
-               configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
-               unlimited reset time is allotted. The value is specified in seconds. Default:
-               `-1` (no window).
-        :param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will
-               perform to this virtual machine when responding to a failure event. Default:
-               `3`
-        :param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after
-               powering on this virtual machine before monitoring for heartbeats. Default:
-               `120` (2 minutes).
-        :param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use
-               when HA is enabled in the cluster. Can be one of `vmMonitoringDisabled`,
-               `vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
-        :param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or
-               not the cluster's default settings or the VM override settings specified in
-               this resource are used for virtual machine monitoring. The default is `true`
-               (use cluster defaults) - set to `false` to have overrides take effect.
-        :param pulumi.Input[str] ha_vm_restart_priority: The restart priority for the virtual
-               machine when vSphere detects a host failure. Can be one of
-               `clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
-               Default: `clusterRestartPriority`.
-        :param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that
-               vSphere HA will wait for this virtual machine to be ready. Use `-1` to
-               specify the cluster default.  Default: `-1`.
-        :param pulumi.Input[str] virtual_machine_id: The UUID of the virtual machine to create
-               the override for.  Forces a new resource if changed.
+        :param pulumi.Input[str] compute_cluster_id: The managed object ID of the cluster.
+        :param pulumi.Input[str] ha_datastore_apd_recovery_action: Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
+               APD event. Can be one of useClusterDefault, none or reset.
+        :param pulumi.Input[str] ha_datastore_apd_response: Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
+               datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
+        :param pulumi.Input[int] ha_datastore_apd_response_delay: Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
+               ha_datastore_apd_response. Specify -1 to use the cluster setting.
+        :param pulumi.Input[str] ha_datastore_pdl_response: Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
+               datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
+        :param pulumi.Input[str] ha_host_isolation_response: The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
+               clusterIsolationResponse, none, powerOff, or shutdown.
+        :param pulumi.Input[int] ha_vm_failure_interval: If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
+               as failed. The value is in seconds.
+        :param pulumi.Input[int] ha_vm_maximum_failure_window: The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
+               attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
+               time is allotted.
+        :param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
+        :param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
+        :param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
+               vmMonitoringOnly, or vmAndAppMonitoring.
+        :param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
+               for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
+        :param pulumi.Input[str] ha_vm_restart_priority: The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
+               lowest, low, medium, high, or highest.
+        :param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
+               default.
+        :param pulumi.Input[str] virtual_machine_id: The managed object ID of the virtual machine.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -919,9 +918,7 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="computeClusterId")
     def compute_cluster_id(self) -> pulumi.Output[str]:
         """
-        The managed object reference
-        ID of the cluster to put the override in.  Forces a new
-        resource if changed.
+        The managed object ID of the cluster.
         """
         return pulumi.get(self, "compute_cluster_id")
@@ -929,10 +926,8 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="haDatastoreApdRecoveryAction")
     def ha_datastore_apd_recovery_action(self) -> pulumi.Output[Optional[str]]:
         """
-        Controls the action to take
-        on this virtual machine if an APD status on an affected datastore clears in
-        the middle of an APD event. Can be one of `useClusterDefault`, `none` or
-        `reset`.  Default: `useClusterDefault`.
+        Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
+        APD event. Can be one of useClusterDefault, none or reset.
         """
         return pulumi.get(self, "ha_datastore_apd_recovery_action")
@@ -940,10 +935,8 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="haDatastoreApdResponse")
     def ha_datastore_apd_response(self) -> pulumi.Output[Optional[str]]:
         """
-        Controls the action to take on this
-        virtual machine when the cluster has detected loss to all paths to a relevant
-        datastore. Can be one of `clusterDefault`, `disabled`, `warning`,
-        `restartConservative`, or `restartAggressive`.  Default: `clusterDefault`.
+        Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
+        datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
         """
         return pulumi.get(self, "ha_datastore_apd_response")
@@ -951,10 +944,8 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="haDatastoreApdResponseDelay")
     def ha_datastore_apd_response_delay(self) -> pulumi.Output[Optional[int]]:
         """
-        Controls the delay in seconds
-        to wait after an APD timeout event to execute the response action defined in
-        `ha_datastore_apd_response`. Use `-1` to use
-        the cluster default. Default: `-1`.
+        Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
+        ha_datastore_apd_response. Specify -1 to use the cluster setting.
         """
         return pulumi.get(self, "ha_datastore_apd_response_delay")
@@ -962,10 +953,8 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="haDatastorePdlResponse")
     def ha_datastore_pdl_response(self) -> pulumi.Output[Optional[str]]:
         """
-        Controls the action to take on this
-        virtual machine when the cluster has detected a permanent device loss to a
-        relevant datastore. Can be one of `clusterDefault`, `disabled`, `warning`, or
-        `restartAggressive`. Default: `clusterDefault`.
+        Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
+        datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
         """
         return pulumi.get(self, "ha_datastore_pdl_response")
@@ -973,10 +962,8 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="haHostIsolationResponse")
     def ha_host_isolation_response(self) -> pulumi.Output[Optional[str]]:
         """
-        The action to take on this virtual
-        machine when a host has detected that it has been isolated from the rest of
-        the cluster. Can be one of `clusterIsolationResponse`, `none`, `powerOff`, or
-        `shutdown`. Default: `clusterIsolationResponse`.
+        The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
+        clusterIsolationResponse, none, powerOff, or shutdown.
         """
         return pulumi.get(self, "ha_host_isolation_response")
@@ -984,9 +971,8 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="haVmFailureInterval")
     def ha_vm_failure_interval(self) -> pulumi.Output[Optional[int]]:
         """
-        If a heartbeat from this virtual
-        machine is not received within this configured interval, the virtual machine
-        is marked as failed. The value is in seconds. Default: `30`.
+        If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
+        as failed. The value is in seconds.
         """
         return pulumi.get(self, "ha_vm_failure_interval")
@@ -994,12 +980,9 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="haVmMaximumFailureWindow")
     def ha_vm_maximum_failure_window(self) -> pulumi.Output[Optional[int]]:
         """
-        The length of the reset window in
-        which `ha_vm_maximum_resets` can operate. When this
-        window expires, no more resets are attempted regardless of the setting
-        configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
-        unlimited reset time is allotted. The value is specified in seconds. Default:
-        `-1` (no window).
+        The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
+        attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
+        time is allotted.
         """
         return pulumi.get(self, "ha_vm_maximum_failure_window")
@@ -1007,9 +990,7 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="haVmMaximumResets")
     def ha_vm_maximum_resets(self) -> pulumi.Output[Optional[int]]:
         """
-        The maximum number of resets that HA will
-        perform to this virtual machine when responding to a failure event. Default:
-        `3`
+        The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
         """
         return pulumi.get(self, "ha_vm_maximum_resets")
@@ -1017,9 +998,7 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="haVmMinimumUptime")
     def ha_vm_minimum_uptime(self) -> pulumi.Output[Optional[int]]:
         """
-        The time, in seconds, that HA waits after
-        powering on this virtual machine before monitoring for heartbeats. Default:
-        `120` (2 minutes).
+        The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
         """
         return pulumi.get(self, "ha_vm_minimum_uptime")
@@ -1027,9 +1006,8 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="haVmMonitoring")
     def ha_vm_monitoring(self) -> pulumi.Output[Optional[str]]:
         """
-        The type of virtual machine monitoring to use
-        when HA is enabled in the cluster. Can be one of `vmMonitoringDisabled`,
-        `vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
+        The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
+        vmMonitoringOnly, or vmAndAppMonitoring.
         """
         return pulumi.get(self, "ha_vm_monitoring")
@@ -1037,10 +1015,8 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="haVmMonitoringUseClusterDefaults")
     def ha_vm_monitoring_use_cluster_defaults(self) -> pulumi.Output[Optional[bool]]:
         """
-        Determines whether or
-        not the cluster's default settings or the VM override settings specified in
-        this resource are used for virtual machine monitoring. The default is `true`
-        (use cluster defaults) - set to `false` to have overrides take effect.
+        Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
+        for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
         """
         return pulumi.get(self, "ha_vm_monitoring_use_cluster_defaults")
@@ -1048,10 +1024,8 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="haVmRestartPriority")
     def ha_vm_restart_priority(self) -> pulumi.Output[Optional[str]]:
         """
-        The restart priority for the virtual
-        machine when vSphere detects a host failure. Can be one of
-        `clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
-        Default: `clusterRestartPriority`.
+        The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
+        lowest, low, medium, high, or highest.
         """
         return pulumi.get(self, "ha_vm_restart_priority")
@@ -1059,9 +1033,8 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="haVmRestartTimeout")
     def ha_vm_restart_timeout(self) -> pulumi.Output[Optional[int]]:
         """
-        The maximum time, in seconds, that
-        vSphere HA will wait for this virtual machine to be ready. Use `-1` to
-        specify the cluster default.  Default: `-1`.
+        The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
+        default.
         """
         return pulumi.get(self, "ha_vm_restart_timeout")
@@ -1069,8 +1042,7 @@ class HaVmOverride(pulumi.CustomResource):
     @pulumi.getter(name="virtualMachineId")
     def virtual_machine_id(self) -> pulumi.Output[str]:
         """
-        The UUID of the virtual machine to create
-        the override for.  Forces a new resource if changed.
+        The managed object ID of the virtual machine.
         """
         return pulumi.get(self, "virtual_machine_id")

pulumi-vsphere 4.10.0a1710245029__py3-none-any.whl → 4.13.0a1736849827__py3-none-any.whl

pulumi-vsphere 4.10.0a1710245029py3-none-any.whl → 4.13.0a1736849827py3-none-any.whl