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/compute_cluster_vm_host_rule.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__ = ['ComputeClusterVmHostRuleArgs', 'ComputeClusterVmHostRule']
@@ -14,28 +19,28 @@ __all__ = ['ComputeClusterVmHostRuleArgs', 'ComputeClusterVmHostRule']
 @pulumi.input_type
 class ComputeClusterVmHostRuleArgs:
     def __init__(__self__, *,
-                 compute_cluster_id: pulumi.Input[str],
-                 vm_group_name: pulumi.Input[str],
-                 affinity_host_group_name: Optional[pulumi.Input[str]] = None,
-                 anti_affinity_host_group_name: Optional[pulumi.Input[str]] = None,
-                 enabled: Optional[pulumi.Input[bool]] = None,
-                 mandatory: Optional[pulumi.Input[bool]] = None,
-                 name: Optional[pulumi.Input[str]] = None):
+                 compute_cluster_id: pulumi.Input[_builtins.str],
+                 vm_group_name: pulumi.Input[_builtins.str],
+                 affinity_host_group_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 anti_affinity_host_group_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 enabled: Optional[pulumi.Input[_builtins.bool]] = None,
+                 mandatory: Optional[pulumi.Input[_builtins.bool]] = None,
+                 name: Optional[pulumi.Input[_builtins.str]] = None):
         """
         The set of arguments for constructing a ComputeClusterVmHostRule resource.
-        :param pulumi.Input[str] compute_cluster_id: The managed object reference
+        :param pulumi.Input[_builtins.str] compute_cluster_id: The managed object reference
                ID of the cluster to put the group in.  Forces a new
                resource if changed.
-        :param pulumi.Input[str] vm_group_name: The name of the virtual machine group to use
+        :param pulumi.Input[_builtins.str] vm_group_name: The name of the virtual machine group to use
                with this rule.
-        :param pulumi.Input[str] affinity_host_group_name: When this field is used, the virtual
+        :param pulumi.Input[_builtins.str] affinity_host_group_name: When this field is used, the virtual
                machines defined in `vm_group_name` will be run on the
                hosts defined in this host group.
-        :param pulumi.Input[str] anti_affinity_host_group_name: When this field is used, the
+        :param pulumi.Input[_builtins.str] anti_affinity_host_group_name: When this field is used, the
                virtual machines defined in `vm_group_name` will _not_ be
                run on the hosts defined in this host group.
-        :param pulumi.Input[bool] enabled: Enable this rule in the cluster. Default: `true`.
-        :param pulumi.Input[bool] mandatory: When this value is `true`, prevents any virtual
+        :param pulumi.Input[_builtins.bool] enabled: Enable this rule in the cluster. Default: `true`.
+        :param pulumi.Input[_builtins.bool] mandatory: When this value is `true`, prevents any virtual
                machine operations that may violate this rule. Default: `false`.
                > **NOTE:** One of `affinity_host_group_name` or
@@ -45,7 +50,7 @@ class ComputeClusterVmHostRuleArgs:
                > **NOTE:** The namespace for rule names on this resource (defined by the
                `name` argument) is shared with all rules in the cluster - consider
                this when naming your rules.
-        :param pulumi.Input[str] name: The name of the rule. This must be unique in the
+        :param pulumi.Input[_builtins.str] name: The name of the rule. This must be unique in the
                cluster.
         """
         pulumi.set(__self__, "compute_cluster_id", compute_cluster_id)
@@ -61,9 +66,9 @@ class ComputeClusterVmHostRuleArgs:
         if name is not None:
             pulumi.set(__self__, "name", name)
-    @property
+    @_builtins.property
     @pulumi.getter(name="computeClusterId")
-    def compute_cluster_id(self) -> pulumi.Input[str]:
+    def compute_cluster_id(self) -> pulumi.Input[_builtins.str]:
         """
         The managed object reference
         ID of the cluster to put the group in.  Forces a new
@@ -72,12 +77,12 @@ class ComputeClusterVmHostRuleArgs:
         return pulumi.get(self, "compute_cluster_id")
     @compute_cluster_id.setter
-    def compute_cluster_id(self, value: pulumi.Input[str]):
+    def compute_cluster_id(self, value: pulumi.Input[_builtins.str]):
         pulumi.set(self, "compute_cluster_id", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="vmGroupName")
-    def vm_group_name(self) -> pulumi.Input[str]:
+    def vm_group_name(self) -> pulumi.Input[_builtins.str]:
         """
         The name of the virtual machine group to use
         with this rule.
@@ -85,12 +90,12 @@ class ComputeClusterVmHostRuleArgs:
         return pulumi.get(self, "vm_group_name")
     @vm_group_name.setter
-    def vm_group_name(self, value: pulumi.Input[str]):
+    def vm_group_name(self, value: pulumi.Input[_builtins.str]):
         pulumi.set(self, "vm_group_name", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="affinityHostGroupName")
-    def affinity_host_group_name(self) -> Optional[pulumi.Input[str]]:
+    def affinity_host_group_name(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         When this field is used, the virtual
         machines defined in `vm_group_name` will be run on the
@@ -99,12 +104,12 @@ class ComputeClusterVmHostRuleArgs:
         return pulumi.get(self, "affinity_host_group_name")
     @affinity_host_group_name.setter
-    def affinity_host_group_name(self, value: Optional[pulumi.Input[str]]):
+    def affinity_host_group_name(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "affinity_host_group_name", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="antiAffinityHostGroupName")
-    def anti_affinity_host_group_name(self) -> Optional[pulumi.Input[str]]:
+    def anti_affinity_host_group_name(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         When this field is used, the
         virtual machines defined in `vm_group_name` will _not_ be
@@ -113,24 +118,24 @@ class ComputeClusterVmHostRuleArgs:
         return pulumi.get(self, "anti_affinity_host_group_name")
     @anti_affinity_host_group_name.setter
-    def anti_affinity_host_group_name(self, value: Optional[pulumi.Input[str]]):
+    def anti_affinity_host_group_name(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "anti_affinity_host_group_name", value)
-    @property
+    @_builtins.property
     @pulumi.getter
-    def enabled(self) -> Optional[pulumi.Input[bool]]:
+    def enabled(self) -> Optional[pulumi.Input[_builtins.bool]]:
         """
         Enable this rule in the cluster. Default: `true`.
         """
         return pulumi.get(self, "enabled")
     @enabled.setter
-    def enabled(self, value: Optional[pulumi.Input[bool]]):
+    def enabled(self, value: Optional[pulumi.Input[_builtins.bool]]):
         pulumi.set(self, "enabled", value)
-    @property
+    @_builtins.property
     @pulumi.getter
-    def mandatory(self) -> Optional[pulumi.Input[bool]]:
+    def mandatory(self) -> Optional[pulumi.Input[_builtins.bool]]:
         """
         When this value is `true`, prevents any virtual
         machine operations that may violate this rule. Default: `false`.
@@ -146,12 +151,12 @@ class ComputeClusterVmHostRuleArgs:
         return pulumi.get(self, "mandatory")
     @mandatory.setter
-    def mandatory(self, value: Optional[pulumi.Input[bool]]):
+    def mandatory(self, value: Optional[pulumi.Input[_builtins.bool]]):
         pulumi.set(self, "mandatory", value)
-    @property
+    @_builtins.property
     @pulumi.getter
-    def name(self) -> Optional[pulumi.Input[str]]:
+    def name(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         The name of the rule. This must be unique in the
         cluster.
@@ -159,33 +164,33 @@ class ComputeClusterVmHostRuleArgs:
         return pulumi.get(self, "name")
     @name.setter
-    def name(self, value: Optional[pulumi.Input[str]]):
+    def name(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "name", value)
 @pulumi.input_type
 class _ComputeClusterVmHostRuleState:
     def __init__(__self__, *,
-                 affinity_host_group_name: Optional[pulumi.Input[str]] = None,
-                 anti_affinity_host_group_name: Optional[pulumi.Input[str]] = None,
-                 compute_cluster_id: Optional[pulumi.Input[str]] = None,
-                 enabled: Optional[pulumi.Input[bool]] = None,
-                 mandatory: Optional[pulumi.Input[bool]] = None,
-                 name: Optional[pulumi.Input[str]] = None,
-                 vm_group_name: Optional[pulumi.Input[str]] = None):
+                 affinity_host_group_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 anti_affinity_host_group_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 compute_cluster_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 enabled: Optional[pulumi.Input[_builtins.bool]] = None,
+                 mandatory: Optional[pulumi.Input[_builtins.bool]] = None,
+                 name: Optional[pulumi.Input[_builtins.str]] = None,
+                 vm_group_name: Optional[pulumi.Input[_builtins.str]] = None):
         """
         Input properties used for looking up and filtering ComputeClusterVmHostRule resources.
-        :param pulumi.Input[str] affinity_host_group_name: When this field is used, the virtual
+        :param pulumi.Input[_builtins.str] affinity_host_group_name: When this field is used, the virtual
                machines defined in `vm_group_name` will be run on the
                hosts defined in this host group.
-        :param pulumi.Input[str] anti_affinity_host_group_name: When this field is used, the
+        :param pulumi.Input[_builtins.str] anti_affinity_host_group_name: When this field is used, the
                virtual machines defined in `vm_group_name` will _not_ be
                run on the hosts defined in this host group.
-        :param pulumi.Input[str] compute_cluster_id: The managed object reference
+        :param pulumi.Input[_builtins.str] compute_cluster_id: The managed object reference
                ID of the cluster to put the group in.  Forces a new
                resource if changed.
-        :param pulumi.Input[bool] enabled: Enable this rule in the cluster. Default: `true`.
-        :param pulumi.Input[bool] mandatory: When this value is `true`, prevents any virtual
+        :param pulumi.Input[_builtins.bool] enabled: Enable this rule in the cluster. Default: `true`.
+        :param pulumi.Input[_builtins.bool] mandatory: When this value is `true`, prevents any virtual
                machine operations that may violate this rule. Default: `false`.
                > **NOTE:** One of `affinity_host_group_name` or
@@ -195,9 +200,9 @@ class _ComputeClusterVmHostRuleState:
                > **NOTE:** The namespace for rule names on this resource (defined by the
                `name` argument) is shared with all rules in the cluster - consider
                this when naming your rules.
-        :param pulumi.Input[str] name: The name of the rule. This must be unique in the
+        :param pulumi.Input[_builtins.str] name: The name of the rule. This must be unique in the
                cluster.
-        :param pulumi.Input[str] vm_group_name: The name of the virtual machine group to use
+        :param pulumi.Input[_builtins.str] vm_group_name: The name of the virtual machine group to use
                with this rule.
         """
         if affinity_host_group_name is not None:
@@ -215,9 +220,9 @@ class _ComputeClusterVmHostRuleState:
         if vm_group_name is not None:
             pulumi.set(__self__, "vm_group_name", vm_group_name)
-    @property
+    @_builtins.property
     @pulumi.getter(name="affinityHostGroupName")
-    def affinity_host_group_name(self) -> Optional[pulumi.Input[str]]:
+    def affinity_host_group_name(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         When this field is used, the virtual
         machines defined in `vm_group_name` will be run on the
@@ -226,12 +231,12 @@ class _ComputeClusterVmHostRuleState:
         return pulumi.get(self, "affinity_host_group_name")
     @affinity_host_group_name.setter
-    def affinity_host_group_name(self, value: Optional[pulumi.Input[str]]):
+    def affinity_host_group_name(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "affinity_host_group_name", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="antiAffinityHostGroupName")
-    def anti_affinity_host_group_name(self) -> Optional[pulumi.Input[str]]:
+    def anti_affinity_host_group_name(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         When this field is used, the
         virtual machines defined in `vm_group_name` will _not_ be
@@ -240,12 +245,12 @@ class _ComputeClusterVmHostRuleState:
         return pulumi.get(self, "anti_affinity_host_group_name")
     @anti_affinity_host_group_name.setter
-    def anti_affinity_host_group_name(self, value: Optional[pulumi.Input[str]]):
+    def anti_affinity_host_group_name(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "anti_affinity_host_group_name", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="computeClusterId")
-    def compute_cluster_id(self) -> Optional[pulumi.Input[str]]:
+    def compute_cluster_id(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         The managed object reference
         ID of the cluster to put the group in.  Forces a new
@@ -254,24 +259,24 @@ class _ComputeClusterVmHostRuleState:
         return pulumi.get(self, "compute_cluster_id")
     @compute_cluster_id.setter
-    def compute_cluster_id(self, value: Optional[pulumi.Input[str]]):
+    def compute_cluster_id(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "compute_cluster_id", value)
-    @property
+    @_builtins.property
     @pulumi.getter
-    def enabled(self) -> Optional[pulumi.Input[bool]]:
+    def enabled(self) -> Optional[pulumi.Input[_builtins.bool]]:
         """
         Enable this rule in the cluster. Default: `true`.
         """
         return pulumi.get(self, "enabled")
     @enabled.setter
-    def enabled(self, value: Optional[pulumi.Input[bool]]):
+    def enabled(self, value: Optional[pulumi.Input[_builtins.bool]]):
         pulumi.set(self, "enabled", value)
-    @property
+    @_builtins.property
     @pulumi.getter
-    def mandatory(self) -> Optional[pulumi.Input[bool]]:
+    def mandatory(self) -> Optional[pulumi.Input[_builtins.bool]]:
         """
         When this value is `true`, prevents any virtual
         machine operations that may violate this rule. Default: `false`.
@@ -287,12 +292,12 @@ class _ComputeClusterVmHostRuleState:
         return pulumi.get(self, "mandatory")
     @mandatory.setter
-    def mandatory(self, value: Optional[pulumi.Input[bool]]):
+    def mandatory(self, value: Optional[pulumi.Input[_builtins.bool]]):
         pulumi.set(self, "mandatory", value)
-    @property
+    @_builtins.property
     @pulumi.getter
-    def name(self) -> Optional[pulumi.Input[str]]:
+    def name(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         The name of the rule. This must be unique in the
         cluster.
@@ -300,12 +305,12 @@ class _ComputeClusterVmHostRuleState:
         return pulumi.get(self, "name")
     @name.setter
-    def name(self, value: Optional[pulumi.Input[str]]):
+    def name(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "name", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="vmGroupName")
-    def vm_group_name(self) -> Optional[pulumi.Input[str]]:
+    def vm_group_name(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         The name of the virtual machine group to use
         with this rule.
@@ -313,38 +318,136 @@ class _ComputeClusterVmHostRuleState:
         return pulumi.get(self, "vm_group_name")
     @vm_group_name.setter
-    def vm_group_name(self, value: Optional[pulumi.Input[str]]):
+    def vm_group_name(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "vm_group_name", value)
+@pulumi.type_token("vsphere:index/computeClusterVmHostRule:ComputeClusterVmHostRule")
 class ComputeClusterVmHostRule(pulumi.CustomResource):
     @overload
     def __init__(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 affinity_host_group_name: Optional[pulumi.Input[str]] = None,
-                 anti_affinity_host_group_name: Optional[pulumi.Input[str]] = None,
-                 compute_cluster_id: Optional[pulumi.Input[str]] = None,
-                 enabled: Optional[pulumi.Input[bool]] = None,
-                 mandatory: Optional[pulumi.Input[bool]] = None,
-                 name: Optional[pulumi.Input[str]] = None,
-                 vm_group_name: Optional[pulumi.Input[str]] = None,
+                 affinity_host_group_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 anti_affinity_host_group_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 compute_cluster_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 enabled: Optional[pulumi.Input[_builtins.bool]] = None,
+                 mandatory: Optional[pulumi.Input[_builtins.bool]] = None,
+                 name: Optional[pulumi.Input[_builtins.str]] = None,
+                 vm_group_name: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         """
-        Create a ComputeClusterVmHostRule resource with the given unique name, props, and options.
+        The `ComputeClusterVmHostRule` resource can be used to manage
+        VM-to-host rules in a cluster, either created by the
+        `ComputeCluster` resource or looked up
+        by the `ComputeCluster` data source.
+        This resource can create both _affinity rules_, where virtual machines run on
+        specified hosts, or _anti-affinity_ rules, where virtual machines run on hosts
+        outside of the ones specified in the rule. Virtual machines and hosts are
+        supplied via groups, which can be managed via the
+        `ComputeClusterVmGroup` and
+        `ComputeClusterHostGroup`
+        resources.
+        > **NOTE:** This resource requires vCenter and is not available on direct ESXi
+        connections.
+        ## Example Usage
+        The example below creates a virtual machine in a cluster using the
+        `VirtualMachine` resource in a cluster
+        looked up by the `ComputeCluster`
+        data source. It then creates a group with this virtual machine. It also creates
+        a host group off of the host looked up via the
+        `Host` data source. Finally, this
+        virtual machine is configured to run specifically on that host via a
+        `ComputeClusterVmHostRule` resource.
+        > Note how `vm_group_name` and
+        `affinity_host_group_name` are sourced off of the
+        `name` attributes from the
+        `ComputeClusterVmGroup` and
+        `ComputeClusterHostGroup`
+        resources. This is to ensure that the rule is not created before the groups
+        exist, which may not possibly happen in the event that the names came from a
+        "static" source such as a variable.
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        datastore = vsphere.get_datastore(name="datastore1",
+            datacenter_id=datacenter.id)
+        cluster = vsphere.get_compute_cluster(name="cluster-01",
+            datacenter_id=datacenter.id)
+        host = vsphere.get_host(name="esxi-01.example.com",
+            datacenter_id=datacenter.id)
+        network = vsphere.get_network(name="network1",
+            datacenter_id=datacenter.id)
+        vm = vsphere.VirtualMachine("vm",
+            name="test",
+            resource_pool_id=cluster.resource_pool_id,
+            datastore_id=datastore.id,
+            num_cpus=2,
+            memory=2048,
+            guest_id="otherLinux64Guest",
+            network_interfaces=[{
+                "network_id": network.id,
+            }],
+            disks=[{
+                "label": "disk0",
+                "size": 20,
+            }])
+        cluster_vm_group = vsphere.ComputeClusterVmGroup("cluster_vm_group",
+            name="test-cluster-vm-group",
+            compute_cluster_id=cluster.id,
+            virtual_machine_ids=[vm.id])
+        cluster_host_group = vsphere.ComputeClusterHostGroup("cluster_host_group",
+            name="test-cluster-vm-group",
+            compute_cluster_id=cluster.id,
+            host_system_ids=[host.id])
+        cluster_vm_host_rule = vsphere.ComputeClusterVmHostRule("cluster_vm_host_rule",
+            compute_cluster_id=cluster.id,
+            name="test-cluster-vm-host-rule",
+            vm_group_name=cluster_vm_group.name,
+            affinity_host_group_name=cluster_host_group.name)
+        ```
+        ## Import
+        An existing rule can be imported into this resource by supplying
+        both the path to the cluster, and the name the rule. If the name or cluster is
+        not found, or if the rule is of a different type, an error will be returned. An
+        example is below:
+        [docs-import]: https://developer.hashicorp.com/terraform/cli/import
+        ```sh
+        $ pulumi import vsphere:index/computeClusterVmHostRule:ComputeClusterVmHostRule cluster_vm_host_rule \\
+        ```
+          '{"compute_cluster_path": "/dc1/host/cluster1", \\
+          "name": "pulumi-test-cluster-vm-host-rule"}'
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] affinity_host_group_name: When this field is used, the virtual
+        :param pulumi.Input[_builtins.str] affinity_host_group_name: When this field is used, the virtual
                machines defined in `vm_group_name` will be run on the
                hosts defined in this host group.
-        :param pulumi.Input[str] anti_affinity_host_group_name: When this field is used, the
+        :param pulumi.Input[_builtins.str] anti_affinity_host_group_name: When this field is used, the
                virtual machines defined in `vm_group_name` will _not_ be
                run on the hosts defined in this host group.
-        :param pulumi.Input[str] compute_cluster_id: The managed object reference
+        :param pulumi.Input[_builtins.str] compute_cluster_id: The managed object reference
                ID of the cluster to put the group in.  Forces a new
                resource if changed.
-        :param pulumi.Input[bool] enabled: Enable this rule in the cluster. Default: `true`.
-        :param pulumi.Input[bool] mandatory: When this value is `true`, prevents any virtual
+        :param pulumi.Input[_builtins.bool] enabled: Enable this rule in the cluster. Default: `true`.
+        :param pulumi.Input[_builtins.bool] mandatory: When this value is `true`, prevents any virtual
                machine operations that may violate this rule. Default: `false`.
                > **NOTE:** One of `affinity_host_group_name` or
@@ -354,9 +457,9 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
                > **NOTE:** The namespace for rule names on this resource (defined by the
                `name` argument) is shared with all rules in the cluster - consider
                this when naming your rules.
-        :param pulumi.Input[str] name: The name of the rule. This must be unique in the
+        :param pulumi.Input[_builtins.str] name: The name of the rule. This must be unique in the
                cluster.
-        :param pulumi.Input[str] vm_group_name: The name of the virtual machine group to use
+        :param pulumi.Input[_builtins.str] vm_group_name: The name of the virtual machine group to use
                with this rule.
         """
         ...
@@ -366,7 +469,104 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
                  args: ComputeClusterVmHostRuleArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a ComputeClusterVmHostRule resource with the given unique name, props, and options.
+        The `ComputeClusterVmHostRule` resource can be used to manage
+        VM-to-host rules in a cluster, either created by the
+        `ComputeCluster` resource or looked up
+        by the `ComputeCluster` data source.
+        This resource can create both _affinity rules_, where virtual machines run on
+        specified hosts, or _anti-affinity_ rules, where virtual machines run on hosts
+        outside of the ones specified in the rule. Virtual machines and hosts are
+        supplied via groups, which can be managed via the
+        `ComputeClusterVmGroup` and
+        `ComputeClusterHostGroup`
+        resources.
+        > **NOTE:** This resource requires vCenter and is not available on direct ESXi
+        connections.
+        ## Example Usage
+        The example below creates a virtual machine in a cluster using the
+        `VirtualMachine` resource in a cluster
+        looked up by the `ComputeCluster`
+        data source. It then creates a group with this virtual machine. It also creates
+        a host group off of the host looked up via the
+        `Host` data source. Finally, this
+        virtual machine is configured to run specifically on that host via a
+        `ComputeClusterVmHostRule` resource.
+        > Note how `vm_group_name` and
+        `affinity_host_group_name` are sourced off of the
+        `name` attributes from the
+        `ComputeClusterVmGroup` and
+        `ComputeClusterHostGroup`
+        resources. This is to ensure that the rule is not created before the groups
+        exist, which may not possibly happen in the event that the names came from a
+        "static" source such as a variable.
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        datastore = vsphere.get_datastore(name="datastore1",
+            datacenter_id=datacenter.id)
+        cluster = vsphere.get_compute_cluster(name="cluster-01",
+            datacenter_id=datacenter.id)
+        host = vsphere.get_host(name="esxi-01.example.com",
+            datacenter_id=datacenter.id)
+        network = vsphere.get_network(name="network1",
+            datacenter_id=datacenter.id)
+        vm = vsphere.VirtualMachine("vm",
+            name="test",
+            resource_pool_id=cluster.resource_pool_id,
+            datastore_id=datastore.id,
+            num_cpus=2,
+            memory=2048,
+            guest_id="otherLinux64Guest",
+            network_interfaces=[{
+                "network_id": network.id,
+            }],
+            disks=[{
+                "label": "disk0",
+                "size": 20,
+            }])
+        cluster_vm_group = vsphere.ComputeClusterVmGroup("cluster_vm_group",
+            name="test-cluster-vm-group",
+            compute_cluster_id=cluster.id,
+            virtual_machine_ids=[vm.id])
+        cluster_host_group = vsphere.ComputeClusterHostGroup("cluster_host_group",
+            name="test-cluster-vm-group",
+            compute_cluster_id=cluster.id,
+            host_system_ids=[host.id])
+        cluster_vm_host_rule = vsphere.ComputeClusterVmHostRule("cluster_vm_host_rule",
+            compute_cluster_id=cluster.id,
+            name="test-cluster-vm-host-rule",
+            vm_group_name=cluster_vm_group.name,
+            affinity_host_group_name=cluster_host_group.name)
+        ```
+        ## Import
+        An existing rule can be imported into this resource by supplying
+        both the path to the cluster, and the name the rule. If the name or cluster is
+        not found, or if the rule is of a different type, an error will be returned. An
+        example is below:
+        [docs-import]: https://developer.hashicorp.com/terraform/cli/import
+        ```sh
+        $ pulumi import vsphere:index/computeClusterVmHostRule:ComputeClusterVmHostRule cluster_vm_host_rule \\
+        ```
+          '{"compute_cluster_path": "/dc1/host/cluster1", \\
+          "name": "pulumi-test-cluster-vm-host-rule"}'
         :param str resource_name: The name of the resource.
         :param ComputeClusterVmHostRuleArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -382,13 +582,13 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
     def _internal_init(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 affinity_host_group_name: Optional[pulumi.Input[str]] = None,
-                 anti_affinity_host_group_name: Optional[pulumi.Input[str]] = None,
-                 compute_cluster_id: Optional[pulumi.Input[str]] = None,
-                 enabled: Optional[pulumi.Input[bool]] = None,
-                 mandatory: Optional[pulumi.Input[bool]] = None,
-                 name: Optional[pulumi.Input[str]] = None,
-                 vm_group_name: Optional[pulumi.Input[str]] = None,
+                 affinity_host_group_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 anti_affinity_host_group_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 compute_cluster_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 enabled: Optional[pulumi.Input[_builtins.bool]] = None,
+                 mandatory: Optional[pulumi.Input[_builtins.bool]] = None,
+                 name: Optional[pulumi.Input[_builtins.str]] = None,
+                 vm_group_name: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
         if not isinstance(opts, pulumi.ResourceOptions):
@@ -419,13 +619,13 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
     def get(resource_name: str,
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
-            affinity_host_group_name: Optional[pulumi.Input[str]] = None,
-            anti_affinity_host_group_name: Optional[pulumi.Input[str]] = None,
-            compute_cluster_id: Optional[pulumi.Input[str]] = None,
-            enabled: Optional[pulumi.Input[bool]] = None,
-            mandatory: Optional[pulumi.Input[bool]] = None,
-            name: Optional[pulumi.Input[str]] = None,
-            vm_group_name: Optional[pulumi.Input[str]] = None) -> 'ComputeClusterVmHostRule':
+            affinity_host_group_name: Optional[pulumi.Input[_builtins.str]] = None,
+            anti_affinity_host_group_name: Optional[pulumi.Input[_builtins.str]] = None,
+            compute_cluster_id: Optional[pulumi.Input[_builtins.str]] = None,
+            enabled: Optional[pulumi.Input[_builtins.bool]] = None,
+            mandatory: Optional[pulumi.Input[_builtins.bool]] = None,
+            name: Optional[pulumi.Input[_builtins.str]] = None,
+            vm_group_name: Optional[pulumi.Input[_builtins.str]] = None) -> 'ComputeClusterVmHostRule':
         """
         Get an existing ComputeClusterVmHostRule resource's state with the given name, id, and optional extra
         properties used to qualify the lookup.
@@ -433,17 +633,17 @@ class ComputeClusterVmHostRule(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] affinity_host_group_name: When this field is used, the virtual
+        :param pulumi.Input[_builtins.str] affinity_host_group_name: When this field is used, the virtual
                machines defined in `vm_group_name` will be run on the
                hosts defined in this host group.
-        :param pulumi.Input[str] anti_affinity_host_group_name: When this field is used, the
+        :param pulumi.Input[_builtins.str] anti_affinity_host_group_name: When this field is used, the
                virtual machines defined in `vm_group_name` will _not_ be
                run on the hosts defined in this host group.
-        :param pulumi.Input[str] compute_cluster_id: The managed object reference
+        :param pulumi.Input[_builtins.str] compute_cluster_id: The managed object reference
                ID of the cluster to put the group in.  Forces a new
                resource if changed.
-        :param pulumi.Input[bool] enabled: Enable this rule in the cluster. Default: `true`.
-        :param pulumi.Input[bool] mandatory: When this value is `true`, prevents any virtual
+        :param pulumi.Input[_builtins.bool] enabled: Enable this rule in the cluster. Default: `true`.
+        :param pulumi.Input[_builtins.bool] mandatory: When this value is `true`, prevents any virtual
                machine operations that may violate this rule. Default: `false`.
                > **NOTE:** One of `affinity_host_group_name` or
@@ -453,9 +653,9 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
                > **NOTE:** The namespace for rule names on this resource (defined by the
                `name` argument) is shared with all rules in the cluster - consider
                this when naming your rules.
-        :param pulumi.Input[str] name: The name of the rule. This must be unique in the
+        :param pulumi.Input[_builtins.str] name: The name of the rule. This must be unique in the
                cluster.
-        :param pulumi.Input[str] vm_group_name: The name of the virtual machine group to use
+        :param pulumi.Input[_builtins.str] vm_group_name: The name of the virtual machine group to use
                with this rule.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -471,9 +671,9 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
         __props__.__dict__["vm_group_name"] = vm_group_name
         return ComputeClusterVmHostRule(resource_name, opts=opts, __props__=__props__)
-    @property
+    @_builtins.property
     @pulumi.getter(name="affinityHostGroupName")
-    def affinity_host_group_name(self) -> pulumi.Output[Optional[str]]:
+    def affinity_host_group_name(self) -> pulumi.Output[Optional[_builtins.str]]:
         """
         When this field is used, the virtual
         machines defined in `vm_group_name` will be run on the
@@ -481,9 +681,9 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
         """
         return pulumi.get(self, "affinity_host_group_name")
-    @property
+    @_builtins.property
     @pulumi.getter(name="antiAffinityHostGroupName")
-    def anti_affinity_host_group_name(self) -> pulumi.Output[Optional[str]]:
+    def anti_affinity_host_group_name(self) -> pulumi.Output[Optional[_builtins.str]]:
         """
         When this field is used, the
         virtual machines defined in `vm_group_name` will _not_ be
@@ -491,9 +691,9 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
         """
         return pulumi.get(self, "anti_affinity_host_group_name")
-    @property
+    @_builtins.property
     @pulumi.getter(name="computeClusterId")
-    def compute_cluster_id(self) -> pulumi.Output[str]:
+    def compute_cluster_id(self) -> pulumi.Output[_builtins.str]:
         """
         The managed object reference
         ID of the cluster to put the group in.  Forces a new
@@ -501,17 +701,17 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
         """
         return pulumi.get(self, "compute_cluster_id")
-    @property
+    @_builtins.property
     @pulumi.getter
-    def enabled(self) -> pulumi.Output[Optional[bool]]:
+    def enabled(self) -> pulumi.Output[Optional[_builtins.bool]]:
         """
         Enable this rule in the cluster. Default: `true`.
         """
         return pulumi.get(self, "enabled")
-    @property
+    @_builtins.property
     @pulumi.getter
-    def mandatory(self) -> pulumi.Output[Optional[bool]]:
+    def mandatory(self) -> pulumi.Output[Optional[_builtins.bool]]:
         """
         When this value is `true`, prevents any virtual
         machine operations that may violate this rule. Default: `false`.
@@ -526,18 +726,18 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
         """
         return pulumi.get(self, "mandatory")
-    @property
+    @_builtins.property
     @pulumi.getter
-    def name(self) -> pulumi.Output[str]:
+    def name(self) -> pulumi.Output[_builtins.str]:
         """
         The name of the rule. This must be unique in the
         cluster.
         """
         return pulumi.get(self, "name")
-    @property
+    @_builtins.property
     @pulumi.getter(name="vmGroupName")
-    def vm_group_name(self) -> pulumi.Output[str]:
+    def vm_group_name(self) -> pulumi.Output[_builtins.str]:
         """
         The name of the virtual machine group to use
         with this rule.

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