PyPI - pulumi-vsphere - Versions diffs - 4.10.0a1709017641__py3-none-any.whl → 4.17.0a1763710194__py3-none-any.whl - Mend

pulumi-vsphere 4.10.0a1709017641py3-none-any.whl → 4.17.0a1763710194py3-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 (89) hide show

pulumi_vsphere/__init__.py +51 -1
pulumi_vsphere/_inputs.py +2568 -1025
pulumi_vsphere/_utilities.py +50 -10
pulumi_vsphere/compute_cluster.py +1564 -2373
pulumi_vsphere/compute_cluster_host_group.py +191 -55
pulumi_vsphere/compute_cluster_vm_affinity_rule.py +157 -113
pulumi_vsphere/compute_cluster_vm_anti_affinity_rule.py +133 -89
pulumi_vsphere/compute_cluster_vm_dependency_rule.py +314 -106
pulumi_vsphere/compute_cluster_vm_group.py +256 -55
pulumi_vsphere/compute_cluster_vm_host_rule.py +323 -123
pulumi_vsphere/config/__init__.py +2 -1
pulumi_vsphere/config/__init__.pyi +7 -2
pulumi_vsphere/config/vars.py +20 -15
pulumi_vsphere/configuration_profile.py +286 -0
pulumi_vsphere/content_library.py +177 -71
pulumi_vsphere/content_library_item.py +252 -106
pulumi_vsphere/custom_attribute.py +118 -38
pulumi_vsphere/datacenter.py +128 -107
pulumi_vsphere/datastore_cluster.py +636 -731
pulumi_vsphere/datastore_cluster_vm_anti_affinity_rule.py +251 -89
pulumi_vsphere/distributed_port_group.py +1129 -967
pulumi_vsphere/distributed_virtual_switch.py +1971 -2239
pulumi_vsphere/distributed_virtual_switch_pvlan_mapping.py +294 -0
pulumi_vsphere/dpm_host_override.py +222 -72
pulumi_vsphere/drs_vm_override.py +236 -72
pulumi_vsphere/entity_permissions.py +96 -69
pulumi_vsphere/file.py +173 -178
pulumi_vsphere/folder.py +236 -113
pulumi_vsphere/get_compute_cluster.py +34 -23
pulumi_vsphere/get_compute_cluster_host_group.py +52 -41
pulumi_vsphere/get_configuration_profile.py +145 -0
pulumi_vsphere/get_content_library.py +33 -21
pulumi_vsphere/get_content_library_item.py +47 -31
pulumi_vsphere/get_custom_attribute.py +26 -17
pulumi_vsphere/get_datacenter.py +40 -18
pulumi_vsphere/get_datastore.py +60 -24
pulumi_vsphere/get_datastore_cluster.py +47 -22
pulumi_vsphere/get_datastore_stats.py +204 -0
pulumi_vsphere/get_distributed_virtual_switch.py +36 -23
pulumi_vsphere/get_dynamic.py +55 -45
pulumi_vsphere/get_folder.py +163 -25
pulumi_vsphere/get_guest_os_customization.py +68 -37
pulumi_vsphere/get_host.py +34 -23
pulumi_vsphere/get_host_base_images.py +104 -0
pulumi_vsphere/get_host_pci_device.py +78 -35
pulumi_vsphere/get_host_thumbprint.py +58 -38
pulumi_vsphere/get_host_vgpu_profile.py +195 -0
pulumi_vsphere/get_license.py +44 -28
pulumi_vsphere/get_network.py +157 -46
pulumi_vsphere/get_ovf_vm_template.py +184 -301
pulumi_vsphere/get_policy.py +23 -15
pulumi_vsphere/get_resource_pool.py +107 -40
pulumi_vsphere/get_role.py +49 -35
pulumi_vsphere/get_tag.py +34 -23
pulumi_vsphere/get_tag_category.py +32 -21
pulumi_vsphere/get_vapp_container.py +31 -21
pulumi_vsphere/get_virtual_machine.py +499 -287
pulumi_vsphere/get_vmfs_disks.py +42 -29
pulumi_vsphere/guest_os_customization.py +135 -79
pulumi_vsphere/ha_vm_override.py +470 -577
pulumi_vsphere/host.py +515 -262
pulumi_vsphere/host_port_group.py +352 -355
pulumi_vsphere/host_virtual_switch.py +580 -580
pulumi_vsphere/license.py +110 -92
pulumi_vsphere/nas_datastore.py +398 -270
pulumi_vsphere/offline_software_depot.py +190 -0
pulumi_vsphere/outputs.py +1582 -1027
pulumi_vsphere/provider.py +172 -152
pulumi_vsphere/pulumi-plugin.json +2 -1
pulumi_vsphere/resource_pool.py +357 -273
pulumi_vsphere/role.py +79 -47
pulumi_vsphere/storage_drs_vm_override.py +225 -89
pulumi_vsphere/supervisor.py +1064 -0
pulumi_vsphere/tag.py +217 -55
pulumi_vsphere/tag_category.py +158 -72
pulumi_vsphere/vapp_container.py +425 -259
pulumi_vsphere/vapp_entity.py +324 -174
pulumi_vsphere/virtual_disk.py +245 -153
pulumi_vsphere/virtual_machine.py +1696 -1836
pulumi_vsphere/virtual_machine_class.py +448 -0
pulumi_vsphere/virtual_machine_snapshot.py +137 -131
pulumi_vsphere/vm_storage_policy.py +160 -154
pulumi_vsphere/vmfs_datastore.py +460 -186
pulumi_vsphere/vnic.py +249 -231
{pulumi_vsphere-4.10.0a1709017641.dist-info → pulumi_vsphere-4.17.0a1763710194.dist-info}/METADATA +7 -6
pulumi_vsphere-4.17.0a1763710194.dist-info/RECORD +89 -0
{pulumi_vsphere-4.10.0a1709017641.dist-info → pulumi_vsphere-4.17.0a1763710194.dist-info}/WHEEL +1 -1
pulumi_vsphere-4.10.0a1709017641.dist-info/RECORD +0 -80
{pulumi_vsphere-4.10.0a1709017641.dist-info → pulumi_vsphere-4.17.0a1763710194.dist-info}/top_level.txt +0 -0

pulumi_vsphere/storage_drs_vm_override.py CHANGED Viewed

@@ -1,12 +1,17 @@
 # coding=utf-8
-# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** WARNING: this file was generated by pulumi-language-python. ***
 # *** Do not edit by hand unless you're certain you know what you are doing! ***
-import copy
+import builtins as _builtins
 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__ = ['StorageDrsVmOverrideArgs', 'StorageDrsVmOverride']
@@ -14,26 +19,26 @@ __all__ = ['StorageDrsVmOverrideArgs', 'StorageDrsVmOverride']
 @pulumi.input_type
 class StorageDrsVmOverrideArgs:
     def __init__(__self__, *,
-                 datastore_cluster_id: pulumi.Input[str],
-                 virtual_machine_id: pulumi.Input[str],
-                 sdrs_automation_level: Optional[pulumi.Input[str]] = None,
-                 sdrs_enabled: Optional[pulumi.Input[str]] = None,
-                 sdrs_intra_vm_affinity: Optional[pulumi.Input[str]] = None):
+                 datastore_cluster_id: pulumi.Input[_builtins.str],
+                 virtual_machine_id: pulumi.Input[_builtins.str],
+                 sdrs_automation_level: Optional[pulumi.Input[_builtins.str]] = None,
+                 sdrs_enabled: Optional[pulumi.Input[_builtins.str]] = None,
+                 sdrs_intra_vm_affinity: Optional[pulumi.Input[_builtins.str]] = None):
         """
         The set of arguments for constructing a StorageDrsVmOverride resource.
-        :param pulumi.Input[str] datastore_cluster_id: The managed object reference
+        :param pulumi.Input[_builtins.str] datastore_cluster_id: The managed object reference
                ID of the datastore 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
+        :param pulumi.Input[_builtins.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] sdrs_automation_level: Overrides any Storage DRS automation
+        :param pulumi.Input[_builtins.str] sdrs_automation_level: Overrides any Storage DRS automation
                levels for this virtual machine. Can be one of `automated` or `manual`. When
                not specified, the datastore cluster's settings are used according to the
                specific SDRS subsystem.
-        :param pulumi.Input[str] sdrs_enabled: Overrides the default Storage DRS setting for
+        :param pulumi.Input[_builtins.str] sdrs_enabled: Overrides the default Storage DRS setting for
                this virtual machine. When not specified, the datastore cluster setting is
                used.
-        :param pulumi.Input[str] sdrs_intra_vm_affinity: Overrides the intra-VM affinity setting
+        :param pulumi.Input[_builtins.str] sdrs_intra_vm_affinity: Overrides the intra-VM affinity setting
                for this virtual machine. When `true`, all disks for this virtual machine
                will be kept on the same datastore. When `false`, Storage DRS may locate
                individual disks on different datastores if it helps satisfy cluster
@@ -48,9 +53,9 @@ class StorageDrsVmOverrideArgs:
         if sdrs_intra_vm_affinity is not None:
             pulumi.set(__self__, "sdrs_intra_vm_affinity", sdrs_intra_vm_affinity)
-    @property
+    @_builtins.property
     @pulumi.getter(name="datastoreClusterId")
-    def datastore_cluster_id(self) -> pulumi.Input[str]:
+    def datastore_cluster_id(self) -> pulumi.Input[_builtins.str]:
         """
         The managed object reference
         ID of the datastore cluster to put the override in.
@@ -59,12 +64,12 @@ class StorageDrsVmOverrideArgs:
         return pulumi.get(self, "datastore_cluster_id")
     @datastore_cluster_id.setter
-    def datastore_cluster_id(self, value: pulumi.Input[str]):
+    def datastore_cluster_id(self, value: pulumi.Input[_builtins.str]):
         pulumi.set(self, "datastore_cluster_id", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="virtualMachineId")
-    def virtual_machine_id(self) -> pulumi.Input[str]:
+    def virtual_machine_id(self) -> pulumi.Input[_builtins.str]:
         """
         The UUID of the virtual machine to create
         the override for.  Forces a new resource if changed.
@@ -72,12 +77,12 @@ class StorageDrsVmOverrideArgs:
         return pulumi.get(self, "virtual_machine_id")
     @virtual_machine_id.setter
-    def virtual_machine_id(self, value: pulumi.Input[str]):
+    def virtual_machine_id(self, value: pulumi.Input[_builtins.str]):
         pulumi.set(self, "virtual_machine_id", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="sdrsAutomationLevel")
-    def sdrs_automation_level(self) -> Optional[pulumi.Input[str]]:
+    def sdrs_automation_level(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         Overrides any Storage DRS automation
         levels for this virtual machine. Can be one of `automated` or `manual`. When
@@ -87,12 +92,12 @@ class StorageDrsVmOverrideArgs:
         return pulumi.get(self, "sdrs_automation_level")
     @sdrs_automation_level.setter
-    def sdrs_automation_level(self, value: Optional[pulumi.Input[str]]):
+    def sdrs_automation_level(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "sdrs_automation_level", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="sdrsEnabled")
-    def sdrs_enabled(self) -> Optional[pulumi.Input[str]]:
+    def sdrs_enabled(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         Overrides the default Storage DRS setting for
         this virtual machine. When not specified, the datastore cluster setting is
@@ -101,12 +106,12 @@ class StorageDrsVmOverrideArgs:
         return pulumi.get(self, "sdrs_enabled")
     @sdrs_enabled.setter
-    def sdrs_enabled(self, value: Optional[pulumi.Input[str]]):
+    def sdrs_enabled(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "sdrs_enabled", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="sdrsIntraVmAffinity")
-    def sdrs_intra_vm_affinity(self) -> Optional[pulumi.Input[str]]:
+    def sdrs_intra_vm_affinity(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         Overrides the intra-VM affinity setting
         for this virtual machine. When `true`, all disks for this virtual machine
@@ -117,36 +122,36 @@ class StorageDrsVmOverrideArgs:
         return pulumi.get(self, "sdrs_intra_vm_affinity")
     @sdrs_intra_vm_affinity.setter
-    def sdrs_intra_vm_affinity(self, value: Optional[pulumi.Input[str]]):
+    def sdrs_intra_vm_affinity(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "sdrs_intra_vm_affinity", value)
 @pulumi.input_type
 class _StorageDrsVmOverrideState:
     def __init__(__self__, *,
-                 datastore_cluster_id: Optional[pulumi.Input[str]] = None,
-                 sdrs_automation_level: Optional[pulumi.Input[str]] = None,
-                 sdrs_enabled: Optional[pulumi.Input[str]] = None,
-                 sdrs_intra_vm_affinity: Optional[pulumi.Input[str]] = None,
-                 virtual_machine_id: Optional[pulumi.Input[str]] = None):
+                 datastore_cluster_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 sdrs_automation_level: Optional[pulumi.Input[_builtins.str]] = None,
+                 sdrs_enabled: Optional[pulumi.Input[_builtins.str]] = None,
+                 sdrs_intra_vm_affinity: Optional[pulumi.Input[_builtins.str]] = None,
+                 virtual_machine_id: Optional[pulumi.Input[_builtins.str]] = None):
         """
         Input properties used for looking up and filtering StorageDrsVmOverride resources.
-        :param pulumi.Input[str] datastore_cluster_id: The managed object reference
+        :param pulumi.Input[_builtins.str] datastore_cluster_id: The managed object reference
                ID of the datastore cluster to put the override in.
                Forces a new resource if changed.
-        :param pulumi.Input[str] sdrs_automation_level: Overrides any Storage DRS automation
+        :param pulumi.Input[_builtins.str] sdrs_automation_level: Overrides any Storage DRS automation
                levels for this virtual machine. Can be one of `automated` or `manual`. When
                not specified, the datastore cluster's settings are used according to the
                specific SDRS subsystem.
-        :param pulumi.Input[str] sdrs_enabled: Overrides the default Storage DRS setting for
+        :param pulumi.Input[_builtins.str] sdrs_enabled: Overrides the default Storage DRS setting for
                this virtual machine. When not specified, the datastore cluster setting is
                used.
-        :param pulumi.Input[str] sdrs_intra_vm_affinity: Overrides the intra-VM affinity setting
+        :param pulumi.Input[_builtins.str] sdrs_intra_vm_affinity: Overrides the intra-VM affinity setting
                for this virtual machine. When `true`, all disks for this virtual machine
                will be kept on the same datastore. When `false`, Storage DRS may locate
                individual disks on different datastores if it helps satisfy cluster
                requirements. When not specified, the datastore cluster's settings are used.
-        :param pulumi.Input[str] virtual_machine_id: The UUID of the virtual machine to create
+        :param pulumi.Input[_builtins.str] virtual_machine_id: The UUID of the virtual machine to create
                the override for.  Forces a new resource if changed.
         """
         if datastore_cluster_id is not None:
@@ -160,9 +165,9 @@ class _StorageDrsVmOverrideState:
         if virtual_machine_id is not None:
             pulumi.set(__self__, "virtual_machine_id", virtual_machine_id)
-    @property
+    @_builtins.property
     @pulumi.getter(name="datastoreClusterId")
-    def datastore_cluster_id(self) -> Optional[pulumi.Input[str]]:
+    def datastore_cluster_id(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         The managed object reference
         ID of the datastore cluster to put the override in.
@@ -171,12 +176,12 @@ class _StorageDrsVmOverrideState:
         return pulumi.get(self, "datastore_cluster_id")
     @datastore_cluster_id.setter
-    def datastore_cluster_id(self, value: Optional[pulumi.Input[str]]):
+    def datastore_cluster_id(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "datastore_cluster_id", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="sdrsAutomationLevel")
-    def sdrs_automation_level(self) -> Optional[pulumi.Input[str]]:
+    def sdrs_automation_level(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         Overrides any Storage DRS automation
         levels for this virtual machine. Can be one of `automated` or `manual`. When
@@ -186,12 +191,12 @@ class _StorageDrsVmOverrideState:
         return pulumi.get(self, "sdrs_automation_level")
     @sdrs_automation_level.setter
-    def sdrs_automation_level(self, value: Optional[pulumi.Input[str]]):
+    def sdrs_automation_level(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "sdrs_automation_level", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="sdrsEnabled")
-    def sdrs_enabled(self) -> Optional[pulumi.Input[str]]:
+    def sdrs_enabled(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         Overrides the default Storage DRS setting for
         this virtual machine. When not specified, the datastore cluster setting is
@@ -200,12 +205,12 @@ class _StorageDrsVmOverrideState:
         return pulumi.get(self, "sdrs_enabled")
     @sdrs_enabled.setter
-    def sdrs_enabled(self, value: Optional[pulumi.Input[str]]):
+    def sdrs_enabled(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "sdrs_enabled", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="sdrsIntraVmAffinity")
-    def sdrs_intra_vm_affinity(self) -> Optional[pulumi.Input[str]]:
+    def sdrs_intra_vm_affinity(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         Overrides the intra-VM affinity setting
         for this virtual machine. When `true`, all disks for this virtual machine
@@ -216,12 +221,12 @@ class _StorageDrsVmOverrideState:
         return pulumi.get(self, "sdrs_intra_vm_affinity")
     @sdrs_intra_vm_affinity.setter
-    def sdrs_intra_vm_affinity(self, value: Optional[pulumi.Input[str]]):
+    def sdrs_intra_vm_affinity(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "sdrs_intra_vm_affinity", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="virtualMachineId")
-    def virtual_machine_id(self) -> Optional[pulumi.Input[str]]:
+    def virtual_machine_id(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         The UUID of the virtual machine to create
         the override for.  Forces a new resource if changed.
@@ -229,41 +234,107 @@ class _StorageDrsVmOverrideState:
         return pulumi.get(self, "virtual_machine_id")
     @virtual_machine_id.setter
-    def virtual_machine_id(self, value: Optional[pulumi.Input[str]]):
+    def virtual_machine_id(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "virtual_machine_id", value)
+@pulumi.type_token("vsphere:index/storageDrsVmOverride:StorageDrsVmOverride")
 class StorageDrsVmOverride(pulumi.CustomResource):
     @overload
     def __init__(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 datastore_cluster_id: Optional[pulumi.Input[str]] = None,
-                 sdrs_automation_level: Optional[pulumi.Input[str]] = None,
-                 sdrs_enabled: Optional[pulumi.Input[str]] = None,
-                 sdrs_intra_vm_affinity: Optional[pulumi.Input[str]] = None,
-                 virtual_machine_id: Optional[pulumi.Input[str]] = None,
+                 datastore_cluster_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 sdrs_automation_level: Optional[pulumi.Input[_builtins.str]] = None,
+                 sdrs_enabled: Optional[pulumi.Input[_builtins.str]] = None,
+                 sdrs_intra_vm_affinity: Optional[pulumi.Input[_builtins.str]] = None,
+                 virtual_machine_id: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         """
-        Create a StorageDrsVmOverride resource with the given unique name, props, and options.
+        The `StorageDrsVmOverride` resource can be used to add a Storage DRS
+        override to a datastore cluster for a specific virtual machine. With this
+        resource, one can enable or disable Storage DRS, and control the automation
+        level and disk affinity for a single virtual machine without affecting the rest
+        of the datastore cluster.
+        For more information on vSphere datastore clusters and Storage DRS, see [this
+        page][ref-vsphere-datastore-clusters].
+        [ref-vsphere-datastore-clusters]: https://techdocs.broadcom.com/us/en/vmware-cis/vsphere/vsphere/8-0/vsphere-resource-management-8-0/creating-a-datastore-cluster.html
+        ## Example Usage
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        datastore_cluster = vsphere.get_datastore_cluster(name="datastore-cluster1",
+            datacenter_id=datacenter.id)
+        member_datastore = vsphere.get_datastore(name="datastore-cluster1-member1",
+            datacenter_id=datacenter.id)
+        pool = vsphere.get_resource_pool(name="cluster1/Resources",
+            datacenter_id=datacenter.id)
+        network = vsphere.get_network(name="public",
+            datacenter_id=datacenter.id)
+        vm = vsphere.VirtualMachine("vm",
+            name="test",
+            resource_pool_id=pool.id,
+            datastore_id=member_datastore.id,
+            num_cpus=2,
+            memory=1024,
+            guest_id="otherLinux64Guest",
+            network_interfaces=[{
+                "network_id": network.id,
+            }],
+            disks=[{
+                "label": "disk0",
+                "size": 20,
+            }])
+        drs_vm_override = vsphere.StorageDrsVmOverride("drs_vm_override",
+            datastore_cluster_id=datastore_cluster.id,
+            virtual_machine_id=vm.id,
+            sdrs_enabled="false")
+        ```
+        ## Import
+        An existing override can be imported into this resource by
+        supplying both the path to the datastore cluster and the path to the virtual
+        machine to `pulumi import`. If no override exists, an error will be given.
+        An example is below:
+        [docs-import]: https://developer.hashicorp.com/terraform/cli/import
+        ```sh
+        $ pulumi import vsphere:index/storageDrsVmOverride:StorageDrsVmOverride drs_vm_override \\
+        ```
+          '{"datastore_cluster_path": "/dc1/datastore/ds-cluster", \\
+          "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] datastore_cluster_id: The managed object reference
+        :param pulumi.Input[_builtins.str] datastore_cluster_id: The managed object reference
                ID of the datastore cluster to put the override in.
                Forces a new resource if changed.
-        :param pulumi.Input[str] sdrs_automation_level: Overrides any Storage DRS automation
+        :param pulumi.Input[_builtins.str] sdrs_automation_level: Overrides any Storage DRS automation
                levels for this virtual machine. Can be one of `automated` or `manual`. When
                not specified, the datastore cluster's settings are used according to the
                specific SDRS subsystem.
-        :param pulumi.Input[str] sdrs_enabled: Overrides the default Storage DRS setting for
+        :param pulumi.Input[_builtins.str] sdrs_enabled: Overrides the default Storage DRS setting for
                this virtual machine. When not specified, the datastore cluster setting is
                used.
-        :param pulumi.Input[str] sdrs_intra_vm_affinity: Overrides the intra-VM affinity setting
+        :param pulumi.Input[_builtins.str] sdrs_intra_vm_affinity: Overrides the intra-VM affinity setting
                for this virtual machine. When `true`, all disks for this virtual machine
                will be kept on the same datastore. When `false`, Storage DRS may locate
                individual disks on different datastores if it helps satisfy cluster
                requirements. When not specified, the datastore cluster's settings are used.
-        :param pulumi.Input[str] virtual_machine_id: The UUID of the virtual machine to create
+        :param pulumi.Input[_builtins.str] virtual_machine_id: The UUID of the virtual machine to create
                the override for.  Forces a new resource if changed.
         """
         ...
@@ -273,7 +344,72 @@ class StorageDrsVmOverride(pulumi.CustomResource):
                  args: StorageDrsVmOverrideArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a StorageDrsVmOverride resource with the given unique name, props, and options.
+        The `StorageDrsVmOverride` resource can be used to add a Storage DRS
+        override to a datastore cluster for a specific virtual machine. With this
+        resource, one can enable or disable Storage DRS, and control the automation
+        level and disk affinity for a single virtual machine without affecting the rest
+        of the datastore cluster.
+        For more information on vSphere datastore clusters and Storage DRS, see [this
+        page][ref-vsphere-datastore-clusters].
+        [ref-vsphere-datastore-clusters]: https://techdocs.broadcom.com/us/en/vmware-cis/vsphere/vsphere/8-0/vsphere-resource-management-8-0/creating-a-datastore-cluster.html
+        ## Example Usage
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        datastore_cluster = vsphere.get_datastore_cluster(name="datastore-cluster1",
+            datacenter_id=datacenter.id)
+        member_datastore = vsphere.get_datastore(name="datastore-cluster1-member1",
+            datacenter_id=datacenter.id)
+        pool = vsphere.get_resource_pool(name="cluster1/Resources",
+            datacenter_id=datacenter.id)
+        network = vsphere.get_network(name="public",
+            datacenter_id=datacenter.id)
+        vm = vsphere.VirtualMachine("vm",
+            name="test",
+            resource_pool_id=pool.id,
+            datastore_id=member_datastore.id,
+            num_cpus=2,
+            memory=1024,
+            guest_id="otherLinux64Guest",
+            network_interfaces=[{
+                "network_id": network.id,
+            }],
+            disks=[{
+                "label": "disk0",
+                "size": 20,
+            }])
+        drs_vm_override = vsphere.StorageDrsVmOverride("drs_vm_override",
+            datastore_cluster_id=datastore_cluster.id,
+            virtual_machine_id=vm.id,
+            sdrs_enabled="false")
+        ```
+        ## Import
+        An existing override can be imported into this resource by
+        supplying both the path to the datastore cluster and the path to the virtual
+        machine to `pulumi import`. If no override exists, an error will be given.
+        An example is below:
+        [docs-import]: https://developer.hashicorp.com/terraform/cli/import
+        ```sh
+        $ pulumi import vsphere:index/storageDrsVmOverride:StorageDrsVmOverride drs_vm_override \\
+        ```
+          '{"datastore_cluster_path": "/dc1/datastore/ds-cluster", \\
+          "virtual_machine_path": "/dc1/vm/srv1"}'
         :param str resource_name: The name of the resource.
         :param StorageDrsVmOverrideArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -289,11 +425,11 @@ class StorageDrsVmOverride(pulumi.CustomResource):
     def _internal_init(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 datastore_cluster_id: Optional[pulumi.Input[str]] = None,
-                 sdrs_automation_level: Optional[pulumi.Input[str]] = None,
-                 sdrs_enabled: Optional[pulumi.Input[str]] = None,
-                 sdrs_intra_vm_affinity: Optional[pulumi.Input[str]] = None,
-                 virtual_machine_id: Optional[pulumi.Input[str]] = None,
+                 datastore_cluster_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 sdrs_automation_level: Optional[pulumi.Input[_builtins.str]] = None,
+                 sdrs_enabled: Optional[pulumi.Input[_builtins.str]] = None,
+                 sdrs_intra_vm_affinity: Optional[pulumi.Input[_builtins.str]] = None,
+                 virtual_machine_id: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
         if not isinstance(opts, pulumi.ResourceOptions):
@@ -322,11 +458,11 @@ class StorageDrsVmOverride(pulumi.CustomResource):
     def get(resource_name: str,
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
-            datastore_cluster_id: Optional[pulumi.Input[str]] = None,
-            sdrs_automation_level: Optional[pulumi.Input[str]] = None,
-            sdrs_enabled: Optional[pulumi.Input[str]] = None,
-            sdrs_intra_vm_affinity: Optional[pulumi.Input[str]] = None,
-            virtual_machine_id: Optional[pulumi.Input[str]] = None) -> 'StorageDrsVmOverride':
+            datastore_cluster_id: Optional[pulumi.Input[_builtins.str]] = None,
+            sdrs_automation_level: Optional[pulumi.Input[_builtins.str]] = None,
+            sdrs_enabled: Optional[pulumi.Input[_builtins.str]] = None,
+            sdrs_intra_vm_affinity: Optional[pulumi.Input[_builtins.str]] = None,
+            virtual_machine_id: Optional[pulumi.Input[_builtins.str]] = None) -> 'StorageDrsVmOverride':
         """
         Get an existing StorageDrsVmOverride resource's state with the given name, id, and optional extra
         properties used to qualify the lookup.
@@ -334,22 +470,22 @@ class StorageDrsVmOverride(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] datastore_cluster_id: The managed object reference
+        :param pulumi.Input[_builtins.str] datastore_cluster_id: The managed object reference
                ID of the datastore cluster to put the override in.
                Forces a new resource if changed.
-        :param pulumi.Input[str] sdrs_automation_level: Overrides any Storage DRS automation
+        :param pulumi.Input[_builtins.str] sdrs_automation_level: Overrides any Storage DRS automation
                levels for this virtual machine. Can be one of `automated` or `manual`. When
                not specified, the datastore cluster's settings are used according to the
                specific SDRS subsystem.
-        :param pulumi.Input[str] sdrs_enabled: Overrides the default Storage DRS setting for
+        :param pulumi.Input[_builtins.str] sdrs_enabled: Overrides the default Storage DRS setting for
                this virtual machine. When not specified, the datastore cluster setting is
                used.
-        :param pulumi.Input[str] sdrs_intra_vm_affinity: Overrides the intra-VM affinity setting
+        :param pulumi.Input[_builtins.str] sdrs_intra_vm_affinity: Overrides the intra-VM affinity setting
                for this virtual machine. When `true`, all disks for this virtual machine
                will be kept on the same datastore. When `false`, Storage DRS may locate
                individual disks on different datastores if it helps satisfy cluster
                requirements. When not specified, the datastore cluster's settings are used.
-        :param pulumi.Input[str] virtual_machine_id: The UUID of the virtual machine to create
+        :param pulumi.Input[_builtins.str] virtual_machine_id: The UUID of the virtual machine to create
                the override for.  Forces a new resource if changed.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -363,9 +499,9 @@ class StorageDrsVmOverride(pulumi.CustomResource):
         __props__.__dict__["virtual_machine_id"] = virtual_machine_id
         return StorageDrsVmOverride(resource_name, opts=opts, __props__=__props__)
-    @property
+    @_builtins.property
     @pulumi.getter(name="datastoreClusterId")
-    def datastore_cluster_id(self) -> pulumi.Output[str]:
+    def datastore_cluster_id(self) -> pulumi.Output[_builtins.str]:
         """
         The managed object reference
         ID of the datastore cluster to put the override in.
@@ -373,9 +509,9 @@ class StorageDrsVmOverride(pulumi.CustomResource):
         """
         return pulumi.get(self, "datastore_cluster_id")
-    @property
+    @_builtins.property
     @pulumi.getter(name="sdrsAutomationLevel")
-    def sdrs_automation_level(self) -> pulumi.Output[Optional[str]]:
+    def sdrs_automation_level(self) -> pulumi.Output[Optional[_builtins.str]]:
         """
         Overrides any Storage DRS automation
         levels for this virtual machine. Can be one of `automated` or `manual`. When
@@ -384,9 +520,9 @@ class StorageDrsVmOverride(pulumi.CustomResource):
         """
         return pulumi.get(self, "sdrs_automation_level")
-    @property
+    @_builtins.property
     @pulumi.getter(name="sdrsEnabled")
-    def sdrs_enabled(self) -> pulumi.Output[Optional[str]]:
+    def sdrs_enabled(self) -> pulumi.Output[Optional[_builtins.str]]:
         """
         Overrides the default Storage DRS setting for
         this virtual machine. When not specified, the datastore cluster setting is
@@ -394,9 +530,9 @@ class StorageDrsVmOverride(pulumi.CustomResource):
         """
         return pulumi.get(self, "sdrs_enabled")
-    @property
+    @_builtins.property
     @pulumi.getter(name="sdrsIntraVmAffinity")
-    def sdrs_intra_vm_affinity(self) -> pulumi.Output[Optional[str]]:
+    def sdrs_intra_vm_affinity(self) -> pulumi.Output[Optional[_builtins.str]]:
         """
         Overrides the intra-VM affinity setting
         for this virtual machine. When `true`, all disks for this virtual machine
@@ -406,9 +542,9 @@ class StorageDrsVmOverride(pulumi.CustomResource):
         """
         return pulumi.get(self, "sdrs_intra_vm_affinity")
-    @property
+    @_builtins.property
     @pulumi.getter(name="virtualMachineId")
-    def virtual_machine_id(self) -> pulumi.Output[str]:
+    def virtual_machine_id(self) -> pulumi.Output[_builtins.str]:
         """
         The UUID of the virtual machine to create
         the override for.  Forces a new resource if changed.

pulumi-vsphere 4.10.0a1709017641__py3-none-any.whl → 4.17.0a1763710194__py3-none-any.whl

Potentially problematic release.

pulumi-vsphere 4.10.0a1709017641py3-none-any.whl → 4.17.0a1763710194py3-none-any.whl