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

pulumi-vsphere 4.10.0a1710245029py3-none-any.whl → 4.13.0a1736836157py3-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 (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.0a1736836157.dist-info}/METADATA +7 -6
pulumi_vsphere-4.13.0a1736836157.dist-info/RECORD +86 -0
{pulumi_vsphere-4.10.0a1710245029.dist-info → pulumi_vsphere-4.13.0a1736836157.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.0a1736836157.dist-info}/top_level.txt +0 -0

pulumi_vsphere/datastore_cluster.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__ = ['DatastoreClusterArgs', 'DatastoreCluster']
@@ -61,63 +66,33 @@ class DatastoreClusterArgs:
                `/dc1/datastore/foo/bar`, with the final inventory path being
                `/dc1/datastore/foo/bar/datastore-cluster-test`.
         :param pulumi.Input[str] name: The name of the datastore cluster.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: A key/value map of advanced Storage DRS
-               settings that are not exposed via the provider or the vSphere client.
-        :param pulumi.Input[str] sdrs_automation_level: The global automation level for all
-               virtual machines in this datastore cluster. Default: `manual`.
-        :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When `true`, all disks in a
-               single virtual machine will be kept on the same datastore. Default: `true`.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: Advanced configuration options for storage DRS.
+        :param pulumi.Input[str] sdrs_automation_level: The default automation level for all virtual machines in this storage cluster.
+        :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
         :param pulumi.Input[bool] sdrs_enabled: Enable Storage DRS for this datastore cluster.
                Default: `false`.
-        :param pulumi.Input[int] sdrs_free_space_threshold: The free space threshold to use.
-               When set to `utilization`, `drs_space_utilization_threshold` is used, and
-               when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
-               `utilization`.
+        :param pulumi.Input[int] sdrs_free_space_threshold: The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
         :param pulumi.Input[str] sdrs_free_space_threshold_mode: The free space threshold to use. When set to utilization, drs_space_utilization_threshold is used, and when set to
                freeSpace, drs_free_space_threshold is used.
-        :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in
-               percent, of difference between space utilization in datastores before storage
-               DRS makes decisions to balance the space. Default: `5` percent.
-        :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default
-               automation settings when correcting I/O load imbalances.
-        :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in
-               milliseconds, that storage DRS uses to make recommendations to move disks
-               from this datastore. Default: `15` seconds.
-        :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for
-               this datastore cluster. Default: `true`.
-        :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load
-               in datastores in the cluster before storage DRS makes recommendations to
-               balance the load. Default: `5` percent.
-        :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable
-               IOPS of all virtual machines on the datastore before storage DRS makes
-               recommendations to move VMs off of a datastore. Note that this setting should
-               only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
-               estimate of the capacity of the datastores in your cluster, and should be set
-               to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
-        :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in
-               percent, of actual estimated performance of the datastore (in IOPS) that
-               storage DRS uses to make recommendations to move VMs off of a datastore when
-               the total reservable IOPS exceeds the threshold. Default: `60` percent.
-        :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS
-               threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
-               of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
-               `manual`. Default: `automatic`.
-        :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in
-               minutes. Default: `480` minutes.
-        :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default
-               automation settings when correcting storage and VM policy violations.
-        :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default
-               automation settings when correcting affinity rule violations.
-        :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default
-               automation settings when correcting disk space imbalances.
-        :param pulumi.Input[int] sdrs_space_utilization_threshold: Runtime thresholds govern
-               when Storage DRS performs or recommends migrations
-               (based on the selected automation level). Default: `80` percent.
-        :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default
-               automation settings when generating recommendations for datastore evacuation.
+        :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
+               balance the space.
+        :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default automation settings when correcting I/O load imbalances.
+        :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
+               datastore.
+        :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for this datastore cluster.
+        :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
+        :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
+               move VMs off of a datastore.
+        :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
+               recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
+        :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
+        :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in minutes.
+        :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default automation settings when correcting storage and VM policy violations.
+        :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default automation settings when correcting affinity rule violations.
+        :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default automation settings when correcting disk space imbalances.
+        :param pulumi.Input[int] sdrs_space_utilization_threshold: The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
+        :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default automation settings when generating recommendations for datastore evacuation.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
-               > **NOTE:** Tagging support requires vCenter 6.0 or higher.
         """
         pulumi.set(__self__, "datacenter_id", datacenter_id)
         if custom_attributes is not None:
@@ -237,8 +212,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsAdvancedOptions")
     def sdrs_advanced_options(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
-        A key/value map of advanced Storage DRS
-        settings that are not exposed via the provider or the vSphere client.
+        Advanced configuration options for storage DRS.
         """
         return pulumi.get(self, "sdrs_advanced_options")
@@ -250,8 +224,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsAutomationLevel")
     def sdrs_automation_level(self) -> Optional[pulumi.Input[str]]:
         """
-        The global automation level for all
-        virtual machines in this datastore cluster. Default: `manual`.
+        The default automation level for all virtual machines in this storage cluster.
         """
         return pulumi.get(self, "sdrs_automation_level")
@@ -263,8 +236,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsDefaultIntraVmAffinity")
     def sdrs_default_intra_vm_affinity(self) -> Optional[pulumi.Input[bool]]:
         """
-        When `true`, all disks in a
-        single virtual machine will be kept on the same datastore. Default: `true`.
+        When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
         """
         return pulumi.get(self, "sdrs_default_intra_vm_affinity")
@@ -289,10 +261,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsFreeSpaceThreshold")
     def sdrs_free_space_threshold(self) -> Optional[pulumi.Input[int]]:
         """
-        The free space threshold to use.
-        When set to `utilization`, `drs_space_utilization_threshold` is used, and
-        when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
-        `utilization`.
+        The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
         """
         return pulumi.get(self, "sdrs_free_space_threshold")
@@ -317,9 +286,8 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsFreeSpaceUtilizationDifference")
     def sdrs_free_space_utilization_difference(self) -> Optional[pulumi.Input[int]]:
         """
-        The threshold, in
-        percent, of difference between space utilization in datastores before storage
-        DRS makes decisions to balance the space. Default: `5` percent.
+        The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
+        balance the space.
         """
         return pulumi.get(self, "sdrs_free_space_utilization_difference")
@@ -331,8 +299,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsIoBalanceAutomationLevel")
     def sdrs_io_balance_automation_level(self) -> Optional[pulumi.Input[str]]:
         """
-        Overrides the default
-        automation settings when correcting I/O load imbalances.
+        Overrides the default automation settings when correcting I/O load imbalances.
         """
         return pulumi.get(self, "sdrs_io_balance_automation_level")
@@ -344,9 +311,8 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsIoLatencyThreshold")
     def sdrs_io_latency_threshold(self) -> Optional[pulumi.Input[int]]:
         """
-        The I/O latency threshold, in
-        milliseconds, that storage DRS uses to make recommendations to move disks
-        from this datastore. Default: `15` seconds.
+        The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
+        datastore.
         """
         return pulumi.get(self, "sdrs_io_latency_threshold")
@@ -358,8 +324,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsIoLoadBalanceEnabled")
     def sdrs_io_load_balance_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable I/O load balancing for
-        this datastore cluster. Default: `true`.
+        Enable I/O load balancing for this datastore cluster.
         """
         return pulumi.get(self, "sdrs_io_load_balance_enabled")
@@ -371,9 +336,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsIoLoadImbalanceThreshold")
     def sdrs_io_load_imbalance_threshold(self) -> Optional[pulumi.Input[int]]:
         """
-        The difference between load
-        in datastores in the cluster before storage DRS makes recommendations to
-        balance the load. Default: `5` percent.
+        The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
         """
         return pulumi.get(self, "sdrs_io_load_imbalance_threshold")
@@ -385,12 +348,8 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsIoReservableIopsThreshold")
     def sdrs_io_reservable_iops_threshold(self) -> Optional[pulumi.Input[int]]:
         """
-        The threshold of reservable
-        IOPS of all virtual machines on the datastore before storage DRS makes
-        recommendations to move VMs off of a datastore. Note that this setting should
-        only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
-        estimate of the capacity of the datastores in your cluster, and should be set
-        to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
+        The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
+        move VMs off of a datastore.
         """
         return pulumi.get(self, "sdrs_io_reservable_iops_threshold")
@@ -402,10 +361,8 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsIoReservablePercentThreshold")
     def sdrs_io_reservable_percent_threshold(self) -> Optional[pulumi.Input[int]]:
         """
-        The threshold, in
-        percent, of actual estimated performance of the datastore (in IOPS) that
-        storage DRS uses to make recommendations to move VMs off of a datastore when
-        the total reservable IOPS exceeds the threshold. Default: `60` percent.
+        The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
+        recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
         """
         return pulumi.get(self, "sdrs_io_reservable_percent_threshold")
@@ -417,10 +374,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsIoReservableThresholdMode")
     def sdrs_io_reservable_threshold_mode(self) -> Optional[pulumi.Input[str]]:
         """
-        The reservable IOPS
-        threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
-        of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
-        `manual`. Default: `automatic`.
+        The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
         """
         return pulumi.get(self, "sdrs_io_reservable_threshold_mode")
@@ -432,8 +386,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsLoadBalanceInterval")
     def sdrs_load_balance_interval(self) -> Optional[pulumi.Input[int]]:
         """
-        The storage DRS poll interval, in
-        minutes. Default: `480` minutes.
+        The storage DRS poll interval, in minutes.
         """
         return pulumi.get(self, "sdrs_load_balance_interval")
@@ -445,8 +398,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsPolicyEnforcementAutomationLevel")
     def sdrs_policy_enforcement_automation_level(self) -> Optional[pulumi.Input[str]]:
         """
-        Overrides the default
-        automation settings when correcting storage and VM policy violations.
+        Overrides the default automation settings when correcting storage and VM policy violations.
         """
         return pulumi.get(self, "sdrs_policy_enforcement_automation_level")
@@ -458,8 +410,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsRuleEnforcementAutomationLevel")
     def sdrs_rule_enforcement_automation_level(self) -> Optional[pulumi.Input[str]]:
         """
-        Overrides the default
-        automation settings when correcting affinity rule violations.
+        Overrides the default automation settings when correcting affinity rule violations.
         """
         return pulumi.get(self, "sdrs_rule_enforcement_automation_level")
@@ -471,8 +422,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsSpaceBalanceAutomationLevel")
     def sdrs_space_balance_automation_level(self) -> Optional[pulumi.Input[str]]:
         """
-        Overrides the default
-        automation settings when correcting disk space imbalances.
+        Overrides the default automation settings when correcting disk space imbalances.
         """
         return pulumi.get(self, "sdrs_space_balance_automation_level")
@@ -484,9 +434,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsSpaceUtilizationThreshold")
     def sdrs_space_utilization_threshold(self) -> Optional[pulumi.Input[int]]:
         """
-        Runtime thresholds govern
-        when Storage DRS performs or recommends migrations
-        (based on the selected automation level). Default: `80` percent.
+        The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
         """
         return pulumi.get(self, "sdrs_space_utilization_threshold")
@@ -498,8 +446,7 @@ class DatastoreClusterArgs:
     @pulumi.getter(name="sdrsVmEvacuationAutomationLevel")
     def sdrs_vm_evacuation_automation_level(self) -> Optional[pulumi.Input[str]]:
         """
-        Overrides the default
-        automation settings when generating recommendations for datastore evacuation.
+        Overrides the default automation settings when generating recommendations for datastore evacuation.
         """
         return pulumi.get(self, "sdrs_vm_evacuation_automation_level")
@@ -512,8 +459,6 @@ class DatastoreClusterArgs:
     def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
         The IDs of any tags to attach to this resource.
-        > **NOTE:** Tagging support requires vCenter 6.0 or higher.
         """
         return pulumi.get(self, "tags")
@@ -572,63 +517,33 @@ class _DatastoreClusterState:
                `/dc1/datastore/foo/bar`, with the final inventory path being
                `/dc1/datastore/foo/bar/datastore-cluster-test`.
         :param pulumi.Input[str] name: The name of the datastore cluster.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: A key/value map of advanced Storage DRS
-               settings that are not exposed via the provider or the vSphere client.
-        :param pulumi.Input[str] sdrs_automation_level: The global automation level for all
-               virtual machines in this datastore cluster. Default: `manual`.
-        :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When `true`, all disks in a
-               single virtual machine will be kept on the same datastore. Default: `true`.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: Advanced configuration options for storage DRS.
+        :param pulumi.Input[str] sdrs_automation_level: The default automation level for all virtual machines in this storage cluster.
+        :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
         :param pulumi.Input[bool] sdrs_enabled: Enable Storage DRS for this datastore cluster.
                Default: `false`.
-        :param pulumi.Input[int] sdrs_free_space_threshold: The free space threshold to use.
-               When set to `utilization`, `drs_space_utilization_threshold` is used, and
-               when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
-               `utilization`.
+        :param pulumi.Input[int] sdrs_free_space_threshold: The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
         :param pulumi.Input[str] sdrs_free_space_threshold_mode: The free space threshold to use. When set to utilization, drs_space_utilization_threshold is used, and when set to
                freeSpace, drs_free_space_threshold is used.
-        :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in
-               percent, of difference between space utilization in datastores before storage
-               DRS makes decisions to balance the space. Default: `5` percent.
-        :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default
-               automation settings when correcting I/O load imbalances.
-        :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in
-               milliseconds, that storage DRS uses to make recommendations to move disks
-               from this datastore. Default: `15` seconds.
-        :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for
-               this datastore cluster. Default: `true`.
-        :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load
-               in datastores in the cluster before storage DRS makes recommendations to
-               balance the load. Default: `5` percent.
-        :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable
-               IOPS of all virtual machines on the datastore before storage DRS makes
-               recommendations to move VMs off of a datastore. Note that this setting should
-               only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
-               estimate of the capacity of the datastores in your cluster, and should be set
-               to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
-        :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in
-               percent, of actual estimated performance of the datastore (in IOPS) that
-               storage DRS uses to make recommendations to move VMs off of a datastore when
-               the total reservable IOPS exceeds the threshold. Default: `60` percent.
-        :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS
-               threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
-               of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
-               `manual`. Default: `automatic`.
-        :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in
-               minutes. Default: `480` minutes.
-        :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default
-               automation settings when correcting storage and VM policy violations.
-        :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default
-               automation settings when correcting affinity rule violations.
-        :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default
-               automation settings when correcting disk space imbalances.
-        :param pulumi.Input[int] sdrs_space_utilization_threshold: Runtime thresholds govern
-               when Storage DRS performs or recommends migrations
-               (based on the selected automation level). Default: `80` percent.
-        :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default
-               automation settings when generating recommendations for datastore evacuation.
+        :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
+               balance the space.
+        :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default automation settings when correcting I/O load imbalances.
+        :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
+               datastore.
+        :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for this datastore cluster.
+        :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
+        :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
+               move VMs off of a datastore.
+        :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
+               recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
+        :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
+        :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in minutes.
+        :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default automation settings when correcting storage and VM policy violations.
+        :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default automation settings when correcting affinity rule violations.
+        :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default automation settings when correcting disk space imbalances.
+        :param pulumi.Input[int] sdrs_space_utilization_threshold: The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
+        :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default automation settings when generating recommendations for datastore evacuation.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
-               > **NOTE:** Tagging support requires vCenter 6.0 or higher.
         """
         if custom_attributes is not None:
             pulumi.set(__self__, "custom_attributes", custom_attributes)
@@ -749,8 +664,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsAdvancedOptions")
     def sdrs_advanced_options(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
-        A key/value map of advanced Storage DRS
-        settings that are not exposed via the provider or the vSphere client.
+        Advanced configuration options for storage DRS.
         """
         return pulumi.get(self, "sdrs_advanced_options")
@@ -762,8 +676,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsAutomationLevel")
     def sdrs_automation_level(self) -> Optional[pulumi.Input[str]]:
         """
-        The global automation level for all
-        virtual machines in this datastore cluster. Default: `manual`.
+        The default automation level for all virtual machines in this storage cluster.
         """
         return pulumi.get(self, "sdrs_automation_level")
@@ -775,8 +688,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsDefaultIntraVmAffinity")
     def sdrs_default_intra_vm_affinity(self) -> Optional[pulumi.Input[bool]]:
         """
-        When `true`, all disks in a
-        single virtual machine will be kept on the same datastore. Default: `true`.
+        When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
         """
         return pulumi.get(self, "sdrs_default_intra_vm_affinity")
@@ -801,10 +713,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsFreeSpaceThreshold")
     def sdrs_free_space_threshold(self) -> Optional[pulumi.Input[int]]:
         """
-        The free space threshold to use.
-        When set to `utilization`, `drs_space_utilization_threshold` is used, and
-        when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
-        `utilization`.
+        The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
         """
         return pulumi.get(self, "sdrs_free_space_threshold")
@@ -829,9 +738,8 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsFreeSpaceUtilizationDifference")
     def sdrs_free_space_utilization_difference(self) -> Optional[pulumi.Input[int]]:
         """
-        The threshold, in
-        percent, of difference between space utilization in datastores before storage
-        DRS makes decisions to balance the space. Default: `5` percent.
+        The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
+        balance the space.
         """
         return pulumi.get(self, "sdrs_free_space_utilization_difference")
@@ -843,8 +751,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsIoBalanceAutomationLevel")
     def sdrs_io_balance_automation_level(self) -> Optional[pulumi.Input[str]]:
         """
-        Overrides the default
-        automation settings when correcting I/O load imbalances.
+        Overrides the default automation settings when correcting I/O load imbalances.
         """
         return pulumi.get(self, "sdrs_io_balance_automation_level")
@@ -856,9 +763,8 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsIoLatencyThreshold")
     def sdrs_io_latency_threshold(self) -> Optional[pulumi.Input[int]]:
         """
-        The I/O latency threshold, in
-        milliseconds, that storage DRS uses to make recommendations to move disks
-        from this datastore. Default: `15` seconds.
+        The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
+        datastore.
         """
         return pulumi.get(self, "sdrs_io_latency_threshold")
@@ -870,8 +776,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsIoLoadBalanceEnabled")
     def sdrs_io_load_balance_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable I/O load balancing for
-        this datastore cluster. Default: `true`.
+        Enable I/O load balancing for this datastore cluster.
         """
         return pulumi.get(self, "sdrs_io_load_balance_enabled")
@@ -883,9 +788,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsIoLoadImbalanceThreshold")
     def sdrs_io_load_imbalance_threshold(self) -> Optional[pulumi.Input[int]]:
         """
-        The difference between load
-        in datastores in the cluster before storage DRS makes recommendations to
-        balance the load. Default: `5` percent.
+        The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
         """
         return pulumi.get(self, "sdrs_io_load_imbalance_threshold")
@@ -897,12 +800,8 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsIoReservableIopsThreshold")
     def sdrs_io_reservable_iops_threshold(self) -> Optional[pulumi.Input[int]]:
         """
-        The threshold of reservable
-        IOPS of all virtual machines on the datastore before storage DRS makes
-        recommendations to move VMs off of a datastore. Note that this setting should
-        only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
-        estimate of the capacity of the datastores in your cluster, and should be set
-        to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
+        The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
+        move VMs off of a datastore.
         """
         return pulumi.get(self, "sdrs_io_reservable_iops_threshold")
@@ -914,10 +813,8 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsIoReservablePercentThreshold")
     def sdrs_io_reservable_percent_threshold(self) -> Optional[pulumi.Input[int]]:
         """
-        The threshold, in
-        percent, of actual estimated performance of the datastore (in IOPS) that
-        storage DRS uses to make recommendations to move VMs off of a datastore when
-        the total reservable IOPS exceeds the threshold. Default: `60` percent.
+        The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
+        recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
         """
         return pulumi.get(self, "sdrs_io_reservable_percent_threshold")
@@ -929,10 +826,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsIoReservableThresholdMode")
     def sdrs_io_reservable_threshold_mode(self) -> Optional[pulumi.Input[str]]:
         """
-        The reservable IOPS
-        threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
-        of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
-        `manual`. Default: `automatic`.
+        The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
         """
         return pulumi.get(self, "sdrs_io_reservable_threshold_mode")
@@ -944,8 +838,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsLoadBalanceInterval")
     def sdrs_load_balance_interval(self) -> Optional[pulumi.Input[int]]:
         """
-        The storage DRS poll interval, in
-        minutes. Default: `480` minutes.
+        The storage DRS poll interval, in minutes.
         """
         return pulumi.get(self, "sdrs_load_balance_interval")
@@ -957,8 +850,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsPolicyEnforcementAutomationLevel")
     def sdrs_policy_enforcement_automation_level(self) -> Optional[pulumi.Input[str]]:
         """
-        Overrides the default
-        automation settings when correcting storage and VM policy violations.
+        Overrides the default automation settings when correcting storage and VM policy violations.
         """
         return pulumi.get(self, "sdrs_policy_enforcement_automation_level")
@@ -970,8 +862,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsRuleEnforcementAutomationLevel")
     def sdrs_rule_enforcement_automation_level(self) -> Optional[pulumi.Input[str]]:
         """
-        Overrides the default
-        automation settings when correcting affinity rule violations.
+        Overrides the default automation settings when correcting affinity rule violations.
         """
         return pulumi.get(self, "sdrs_rule_enforcement_automation_level")
@@ -983,8 +874,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsSpaceBalanceAutomationLevel")
     def sdrs_space_balance_automation_level(self) -> Optional[pulumi.Input[str]]:
         """
-        Overrides the default
-        automation settings when correcting disk space imbalances.
+        Overrides the default automation settings when correcting disk space imbalances.
         """
         return pulumi.get(self, "sdrs_space_balance_automation_level")
@@ -996,9 +886,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsSpaceUtilizationThreshold")
     def sdrs_space_utilization_threshold(self) -> Optional[pulumi.Input[int]]:
         """
-        Runtime thresholds govern
-        when Storage DRS performs or recommends migrations
-        (based on the selected automation level). Default: `80` percent.
+        The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
         """
         return pulumi.get(self, "sdrs_space_utilization_threshold")
@@ -1010,8 +898,7 @@ class _DatastoreClusterState:
     @pulumi.getter(name="sdrsVmEvacuationAutomationLevel")
     def sdrs_vm_evacuation_automation_level(self) -> Optional[pulumi.Input[str]]:
         """
-        Overrides the default
-        automation settings when generating recommendations for datastore evacuation.
+        Overrides the default automation settings when generating recommendations for datastore evacuation.
         """
         return pulumi.get(self, "sdrs_vm_evacuation_automation_level")
@@ -1024,8 +911,6 @@ class _DatastoreClusterState:
     def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
         The IDs of any tags to attach to this resource.
-        > **NOTE:** Tagging support requires vCenter 6.0 or higher.
         """
         return pulumi.get(self, "tags")
@@ -1066,7 +951,35 @@ class DatastoreCluster(pulumi.CustomResource):
                  tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  __props__=None):
         """
-        Create a DatastoreCluster resource with the given unique name, props, and options.
+        The `DatastoreCluster` resource can be used to create and manage
+        datastore clusters. This can be used to create groups of datastores with a
+        shared management interface, allowing for resource control and load balancing
+        through Storage DRS.
+        For more information on vSphere datastore clusters and Storage DRS, see [this
+        page][ref-vsphere-datastore-clusters].
+        [ref-vsphere-datastore-clusters]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-resource-management/GUID-598DF695-107E-406B-9C95-0AF961FC227A.html
+        > **NOTE:** This resource requires vCenter and is not available on direct ESXi
+        connections.
+        > **NOTE:** Storage DRS requires a vSphere Enterprise Plus license.
+        ## Import
+        An existing datastore cluster can be imported into this resource
+        via the path to the cluster, via the following command:
+        ```sh
+        $ pulumi import vsphere:index/datastoreCluster:DatastoreCluster datastore_cluster /dc1/datastore/ds-cluster
+        ```
+        The above would import the datastore cluster named `ds-cluster` that is located
+        in the `dc1` datacenter.
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: A map of custom attribute ids to attribute
@@ -1089,63 +1002,33 @@ class DatastoreCluster(pulumi.CustomResource):
                `/dc1/datastore/foo/bar`, with the final inventory path being
                `/dc1/datastore/foo/bar/datastore-cluster-test`.
         :param pulumi.Input[str] name: The name of the datastore cluster.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: A key/value map of advanced Storage DRS
-               settings that are not exposed via the provider or the vSphere client.
-        :param pulumi.Input[str] sdrs_automation_level: The global automation level for all
-               virtual machines in this datastore cluster. Default: `manual`.
-        :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When `true`, all disks in a
-               single virtual machine will be kept on the same datastore. Default: `true`.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: Advanced configuration options for storage DRS.
+        :param pulumi.Input[str] sdrs_automation_level: The default automation level for all virtual machines in this storage cluster.
+        :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
         :param pulumi.Input[bool] sdrs_enabled: Enable Storage DRS for this datastore cluster.
                Default: `false`.
-        :param pulumi.Input[int] sdrs_free_space_threshold: The free space threshold to use.
-               When set to `utilization`, `drs_space_utilization_threshold` is used, and
-               when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
-               `utilization`.
+        :param pulumi.Input[int] sdrs_free_space_threshold: The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
         :param pulumi.Input[str] sdrs_free_space_threshold_mode: The free space threshold to use. When set to utilization, drs_space_utilization_threshold is used, and when set to
                freeSpace, drs_free_space_threshold is used.
-        :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in
-               percent, of difference between space utilization in datastores before storage
-               DRS makes decisions to balance the space. Default: `5` percent.
-        :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default
-               automation settings when correcting I/O load imbalances.
-        :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in
-               milliseconds, that storage DRS uses to make recommendations to move disks
-               from this datastore. Default: `15` seconds.
-        :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for
-               this datastore cluster. Default: `true`.
-        :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load
-               in datastores in the cluster before storage DRS makes recommendations to
-               balance the load. Default: `5` percent.
-        :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable
-               IOPS of all virtual machines on the datastore before storage DRS makes
-               recommendations to move VMs off of a datastore. Note that this setting should
-               only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
-               estimate of the capacity of the datastores in your cluster, and should be set
-               to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
-        :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in
-               percent, of actual estimated performance of the datastore (in IOPS) that
-               storage DRS uses to make recommendations to move VMs off of a datastore when
-               the total reservable IOPS exceeds the threshold. Default: `60` percent.
-        :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS
-               threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
-               of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
-               `manual`. Default: `automatic`.
-        :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in
-               minutes. Default: `480` minutes.
-        :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default
-               automation settings when correcting storage and VM policy violations.
-        :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default
-               automation settings when correcting affinity rule violations.
-        :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default
-               automation settings when correcting disk space imbalances.
-        :param pulumi.Input[int] sdrs_space_utilization_threshold: Runtime thresholds govern
-               when Storage DRS performs or recommends migrations
-               (based on the selected automation level). Default: `80` percent.
-        :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default
-               automation settings when generating recommendations for datastore evacuation.
+        :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
+               balance the space.
+        :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default automation settings when correcting I/O load imbalances.
+        :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
+               datastore.
+        :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for this datastore cluster.
+        :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
+        :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
+               move VMs off of a datastore.
+        :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
+               recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
+        :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
+        :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in minutes.
+        :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default automation settings when correcting storage and VM policy violations.
+        :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default automation settings when correcting affinity rule violations.
+        :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default automation settings when correcting disk space imbalances.
+        :param pulumi.Input[int] sdrs_space_utilization_threshold: The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
+        :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default automation settings when generating recommendations for datastore evacuation.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
-               > **NOTE:** Tagging support requires vCenter 6.0 or higher.
         """
         ...
     @overload
@@ -1154,7 +1037,35 @@ class DatastoreCluster(pulumi.CustomResource):
                  args: DatastoreClusterArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a DatastoreCluster resource with the given unique name, props, and options.
+        The `DatastoreCluster` resource can be used to create and manage
+        datastore clusters. This can be used to create groups of datastores with a
+        shared management interface, allowing for resource control and load balancing
+        through Storage DRS.
+        For more information on vSphere datastore clusters and Storage DRS, see [this
+        page][ref-vsphere-datastore-clusters].
+        [ref-vsphere-datastore-clusters]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-resource-management/GUID-598DF695-107E-406B-9C95-0AF961FC227A.html
+        > **NOTE:** This resource requires vCenter and is not available on direct ESXi
+        connections.
+        > **NOTE:** Storage DRS requires a vSphere Enterprise Plus license.
+        ## Import
+        An existing datastore cluster can be imported into this resource
+        via the path to the cluster, via the following command:
+        ```sh
+        $ pulumi import vsphere:index/datastoreCluster:DatastoreCluster datastore_cluster /dc1/datastore/ds-cluster
+        ```
+        The above would import the datastore cluster named `ds-cluster` that is located
+        in the `dc1` datacenter.
         :param str resource_name: The name of the resource.
         :param DatastoreClusterArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -1293,63 +1204,33 @@ class DatastoreCluster(pulumi.CustomResource):
                `/dc1/datastore/foo/bar`, with the final inventory path being
                `/dc1/datastore/foo/bar/datastore-cluster-test`.
         :param pulumi.Input[str] name: The name of the datastore cluster.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: A key/value map of advanced Storage DRS
-               settings that are not exposed via the provider or the vSphere client.
-        :param pulumi.Input[str] sdrs_automation_level: The global automation level for all
-               virtual machines in this datastore cluster. Default: `manual`.
-        :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When `true`, all disks in a
-               single virtual machine will be kept on the same datastore. Default: `true`.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: Advanced configuration options for storage DRS.
+        :param pulumi.Input[str] sdrs_automation_level: The default automation level for all virtual machines in this storage cluster.
+        :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
         :param pulumi.Input[bool] sdrs_enabled: Enable Storage DRS for this datastore cluster.
                Default: `false`.
-        :param pulumi.Input[int] sdrs_free_space_threshold: The free space threshold to use.
-               When set to `utilization`, `drs_space_utilization_threshold` is used, and
-               when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
-               `utilization`.
+        :param pulumi.Input[int] sdrs_free_space_threshold: The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
         :param pulumi.Input[str] sdrs_free_space_threshold_mode: The free space threshold to use. When set to utilization, drs_space_utilization_threshold is used, and when set to
                freeSpace, drs_free_space_threshold is used.
-        :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in
-               percent, of difference between space utilization in datastores before storage
-               DRS makes decisions to balance the space. Default: `5` percent.
-        :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default
-               automation settings when correcting I/O load imbalances.
-        :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in
-               milliseconds, that storage DRS uses to make recommendations to move disks
-               from this datastore. Default: `15` seconds.
-        :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for
-               this datastore cluster. Default: `true`.
-        :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load
-               in datastores in the cluster before storage DRS makes recommendations to
-               balance the load. Default: `5` percent.
-        :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable
-               IOPS of all virtual machines on the datastore before storage DRS makes
-               recommendations to move VMs off of a datastore. Note that this setting should
-               only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
-               estimate of the capacity of the datastores in your cluster, and should be set
-               to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
-        :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in
-               percent, of actual estimated performance of the datastore (in IOPS) that
-               storage DRS uses to make recommendations to move VMs off of a datastore when
-               the total reservable IOPS exceeds the threshold. Default: `60` percent.
-        :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS
-               threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
-               of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
-               `manual`. Default: `automatic`.
-        :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in
-               minutes. Default: `480` minutes.
-        :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default
-               automation settings when correcting storage and VM policy violations.
-        :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default
-               automation settings when correcting affinity rule violations.
-        :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default
-               automation settings when correcting disk space imbalances.
-        :param pulumi.Input[int] sdrs_space_utilization_threshold: Runtime thresholds govern
-               when Storage DRS performs or recommends migrations
-               (based on the selected automation level). Default: `80` percent.
-        :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default
-               automation settings when generating recommendations for datastore evacuation.
+        :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
+               balance the space.
+        :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default automation settings when correcting I/O load imbalances.
+        :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
+               datastore.
+        :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for this datastore cluster.
+        :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
+        :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
+               move VMs off of a datastore.
+        :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
+               recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
+        :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
+        :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in minutes.
+        :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default automation settings when correcting storage and VM policy violations.
+        :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default automation settings when correcting affinity rule violations.
+        :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default automation settings when correcting disk space imbalances.
+        :param pulumi.Input[int] sdrs_space_utilization_threshold: The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
+        :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default automation settings when generating recommendations for datastore evacuation.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
-               > **NOTE:** Tagging support requires vCenter 6.0 or higher.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -1434,8 +1315,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsAdvancedOptions")
     def sdrs_advanced_options(self) -> pulumi.Output[Optional[Mapping[str, str]]]:
         """
-        A key/value map of advanced Storage DRS
-        settings that are not exposed via the provider or the vSphere client.
+        Advanced configuration options for storage DRS.
         """
         return pulumi.get(self, "sdrs_advanced_options")
@@ -1443,8 +1323,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsAutomationLevel")
     def sdrs_automation_level(self) -> pulumi.Output[Optional[str]]:
         """
-        The global automation level for all
-        virtual machines in this datastore cluster. Default: `manual`.
+        The default automation level for all virtual machines in this storage cluster.
         """
         return pulumi.get(self, "sdrs_automation_level")
@@ -1452,8 +1331,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsDefaultIntraVmAffinity")
     def sdrs_default_intra_vm_affinity(self) -> pulumi.Output[Optional[bool]]:
         """
-        When `true`, all disks in a
-        single virtual machine will be kept on the same datastore. Default: `true`.
+        When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
         """
         return pulumi.get(self, "sdrs_default_intra_vm_affinity")
@@ -1470,10 +1348,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsFreeSpaceThreshold")
     def sdrs_free_space_threshold(self) -> pulumi.Output[Optional[int]]:
         """
-        The free space threshold to use.
-        When set to `utilization`, `drs_space_utilization_threshold` is used, and
-        when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
-        `utilization`.
+        The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
         """
         return pulumi.get(self, "sdrs_free_space_threshold")
@@ -1490,9 +1365,8 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsFreeSpaceUtilizationDifference")
     def sdrs_free_space_utilization_difference(self) -> pulumi.Output[Optional[int]]:
         """
-        The threshold, in
-        percent, of difference between space utilization in datastores before storage
-        DRS makes decisions to balance the space. Default: `5` percent.
+        The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
+        balance the space.
         """
         return pulumi.get(self, "sdrs_free_space_utilization_difference")
@@ -1500,8 +1374,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsIoBalanceAutomationLevel")
     def sdrs_io_balance_automation_level(self) -> pulumi.Output[Optional[str]]:
         """
-        Overrides the default
-        automation settings when correcting I/O load imbalances.
+        Overrides the default automation settings when correcting I/O load imbalances.
         """
         return pulumi.get(self, "sdrs_io_balance_automation_level")
@@ -1509,9 +1382,8 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsIoLatencyThreshold")
     def sdrs_io_latency_threshold(self) -> pulumi.Output[Optional[int]]:
         """
-        The I/O latency threshold, in
-        milliseconds, that storage DRS uses to make recommendations to move disks
-        from this datastore. Default: `15` seconds.
+        The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
+        datastore.
         """
         return pulumi.get(self, "sdrs_io_latency_threshold")
@@ -1519,8 +1391,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsIoLoadBalanceEnabled")
     def sdrs_io_load_balance_enabled(self) -> pulumi.Output[Optional[bool]]:
         """
-        Enable I/O load balancing for
-        this datastore cluster. Default: `true`.
+        Enable I/O load balancing for this datastore cluster.
         """
         return pulumi.get(self, "sdrs_io_load_balance_enabled")
@@ -1528,9 +1399,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsIoLoadImbalanceThreshold")
     def sdrs_io_load_imbalance_threshold(self) -> pulumi.Output[Optional[int]]:
         """
-        The difference between load
-        in datastores in the cluster before storage DRS makes recommendations to
-        balance the load. Default: `5` percent.
+        The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
         """
         return pulumi.get(self, "sdrs_io_load_imbalance_threshold")
@@ -1538,12 +1407,8 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsIoReservableIopsThreshold")
     def sdrs_io_reservable_iops_threshold(self) -> pulumi.Output[Optional[int]]:
         """
-        The threshold of reservable
-        IOPS of all virtual machines on the datastore before storage DRS makes
-        recommendations to move VMs off of a datastore. Note that this setting should
-        only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
-        estimate of the capacity of the datastores in your cluster, and should be set
-        to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
+        The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
+        move VMs off of a datastore.
         """
         return pulumi.get(self, "sdrs_io_reservable_iops_threshold")
@@ -1551,10 +1416,8 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsIoReservablePercentThreshold")
     def sdrs_io_reservable_percent_threshold(self) -> pulumi.Output[Optional[int]]:
         """
-        The threshold, in
-        percent, of actual estimated performance of the datastore (in IOPS) that
-        storage DRS uses to make recommendations to move VMs off of a datastore when
-        the total reservable IOPS exceeds the threshold. Default: `60` percent.
+        The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
+        recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
         """
         return pulumi.get(self, "sdrs_io_reservable_percent_threshold")
@@ -1562,10 +1425,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsIoReservableThresholdMode")
     def sdrs_io_reservable_threshold_mode(self) -> pulumi.Output[Optional[str]]:
         """
-        The reservable IOPS
-        threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
-        of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
-        `manual`. Default: `automatic`.
+        The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
         """
         return pulumi.get(self, "sdrs_io_reservable_threshold_mode")
@@ -1573,8 +1433,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsLoadBalanceInterval")
     def sdrs_load_balance_interval(self) -> pulumi.Output[Optional[int]]:
         """
-        The storage DRS poll interval, in
-        minutes. Default: `480` minutes.
+        The storage DRS poll interval, in minutes.
         """
         return pulumi.get(self, "sdrs_load_balance_interval")
@@ -1582,8 +1441,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsPolicyEnforcementAutomationLevel")
     def sdrs_policy_enforcement_automation_level(self) -> pulumi.Output[Optional[str]]:
         """
-        Overrides the default
-        automation settings when correcting storage and VM policy violations.
+        Overrides the default automation settings when correcting storage and VM policy violations.
         """
         return pulumi.get(self, "sdrs_policy_enforcement_automation_level")
@@ -1591,8 +1449,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsRuleEnforcementAutomationLevel")
     def sdrs_rule_enforcement_automation_level(self) -> pulumi.Output[Optional[str]]:
         """
-        Overrides the default
-        automation settings when correcting affinity rule violations.
+        Overrides the default automation settings when correcting affinity rule violations.
         """
         return pulumi.get(self, "sdrs_rule_enforcement_automation_level")
@@ -1600,8 +1457,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsSpaceBalanceAutomationLevel")
     def sdrs_space_balance_automation_level(self) -> pulumi.Output[Optional[str]]:
         """
-        Overrides the default
-        automation settings when correcting disk space imbalances.
+        Overrides the default automation settings when correcting disk space imbalances.
         """
         return pulumi.get(self, "sdrs_space_balance_automation_level")
@@ -1609,9 +1465,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsSpaceUtilizationThreshold")
     def sdrs_space_utilization_threshold(self) -> pulumi.Output[Optional[int]]:
         """
-        Runtime thresholds govern
-        when Storage DRS performs or recommends migrations
-        (based on the selected automation level). Default: `80` percent.
+        The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
         """
         return pulumi.get(self, "sdrs_space_utilization_threshold")
@@ -1619,8 +1473,7 @@ class DatastoreCluster(pulumi.CustomResource):
     @pulumi.getter(name="sdrsVmEvacuationAutomationLevel")
     def sdrs_vm_evacuation_automation_level(self) -> pulumi.Output[Optional[str]]:
         """
-        Overrides the default
-        automation settings when generating recommendations for datastore evacuation.
+        Overrides the default automation settings when generating recommendations for datastore evacuation.
         """
         return pulumi.get(self, "sdrs_vm_evacuation_automation_level")
@@ -1629,8 +1482,6 @@ class DatastoreCluster(pulumi.CustomResource):
     def tags(self) -> pulumi.Output[Optional[Sequence[str]]]:
         """
         The IDs of any tags to attach to this resource.
-        > **NOTE:** Tagging support requires vCenter 6.0 or higher.
         """
         return pulumi.get(self, "tags")

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

Potentially problematic release.

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