pulumi-vsphere 4.10.0a1710245029__py3-none-any.whl → 4.10.2__py3-none-any.whl

pulumi_vsphere/compute_cluster_vm_affinity_rule.py

@@ -249,8 +249,6 @@ class ComputeClusterVmAffinityRule(pulumi.CustomResource):
         > **NOTE:** This resource requires vCenter Server and is not available on
         direct ESXi host connections.
 
-        > **NOTE:** vSphere DRS requires a vSphere Enterprise Plus license.
-
         ## Example Usage
 
         The following example creates two virtual machines in a cluster using the
@@ -260,7 +258,6 @@ class ComputeClusterVmAffinityRule(pulumi.CustomResource):
         then creates an affinity rule for these two virtual machines, ensuring they
         will run on the same host whenever possible.
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_vsphere as vsphere
@@ -275,6 +272,7 @@ class ComputeClusterVmAffinityRule(pulumi.CustomResource):
         vm = []
         for range in [{"value": i} for i in range(0, 2)]:
             vm.append(vsphere.VirtualMachine(f"vm-{range['value']}",
+                name=f"foo-{range['value']}",
                 resource_pool_id=cluster.resource_pool_id,
                 datastore_id=datastore.id,
                 num_cpus=1,
@@ -287,17 +285,16 @@ class ComputeClusterVmAffinityRule(pulumi.CustomResource):
                     label="disk0",
                     size=20,
                 )]))
-        vm_affinity_rule = vsphere.ComputeClusterVmAffinityRule("vmAffinityRule",
+        vm_affinity_rule = vsphere.ComputeClusterVmAffinityRule("vm_affinity_rule",
+            name="vm-affinity-rule",
             compute_cluster_id=cluster.id,
             virtual_machine_ids=[v.id for k, v in vm])
         ```
-        <!--End PulumiCodeChooser -->
 
         The following example creates an affinity rule for a set of virtual machines
         in the cluster by looking up the virtual machine UUIDs from the
         `VirtualMachine` data source.
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_vsphere as vsphere
@@ -309,14 +306,21 @@ class ComputeClusterVmAffinityRule(pulumi.CustomResource):
         datacenter = vsphere.get_datacenter(name="dc-01")
         cluster = vsphere.get_compute_cluster(name="cluster-01",
             datacenter_id=datacenter.id)
-        vms_virtual_machine = [vsphere.get_virtual_machine(name=vms[__index],
+        vms_get_virtual_machine = [vsphere.get_virtual_machine(name=vms[__index],
             datacenter_id=datacenter.id) for __index in range(len(vms))]
-        vm_affinity_rule = vsphere.ComputeClusterVmAffinityRule("vmAffinityRule",
+        vm_affinity_rule = vsphere.ComputeClusterVmAffinityRule("vm_affinity_rule",
+            name="vm-affinity-rule",
             enabled=True,
             compute_cluster_id=cluster.id,
-            virtual_machine_ids=[__item.id for __item in vms_virtual_machine])
+            virtual_machine_ids=[__item.id for __item in vms_get_virtual_machine])
         ```
-        <!--End PulumiCodeChooser -->
+
+        ## Importing
+
+        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:
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -361,8 +365,6 @@ class ComputeClusterVmAffinityRule(pulumi.CustomResource):
         > **NOTE:** This resource requires vCenter Server and is not available on
         direct ESXi host connections.
 
-        > **NOTE:** vSphere DRS requires a vSphere Enterprise Plus license.
-
         ## Example Usage
 
         The following example creates two virtual machines in a cluster using the
@@ -372,7 +374,6 @@ class ComputeClusterVmAffinityRule(pulumi.CustomResource):
         then creates an affinity rule for these two virtual machines, ensuring they
         will run on the same host whenever possible.
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_vsphere as vsphere
@@ -387,6 +388,7 @@ class ComputeClusterVmAffinityRule(pulumi.CustomResource):
         vm = []
         for range in [{"value": i} for i in range(0, 2)]:
             vm.append(vsphere.VirtualMachine(f"vm-{range['value']}",
+                name=f"foo-{range['value']}",
                 resource_pool_id=cluster.resource_pool_id,
                 datastore_id=datastore.id,
                 num_cpus=1,
@@ -399,17 +401,16 @@ class ComputeClusterVmAffinityRule(pulumi.CustomResource):
                     label="disk0",
                     size=20,
                 )]))
-        vm_affinity_rule = vsphere.ComputeClusterVmAffinityRule("vmAffinityRule",
+        vm_affinity_rule = vsphere.ComputeClusterVmAffinityRule("vm_affinity_rule",
+            name="vm-affinity-rule",
             compute_cluster_id=cluster.id,
             virtual_machine_ids=[v.id for k, v in vm])
         ```
-        <!--End PulumiCodeChooser -->
 
         The following example creates an affinity rule for a set of virtual machines
         in the cluster by looking up the virtual machine UUIDs from the
         `VirtualMachine` data source.
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_vsphere as vsphere
@@ -421,14 +422,21 @@ class ComputeClusterVmAffinityRule(pulumi.CustomResource):
         datacenter = vsphere.get_datacenter(name="dc-01")
         cluster = vsphere.get_compute_cluster(name="cluster-01",
             datacenter_id=datacenter.id)
-        vms_virtual_machine = [vsphere.get_virtual_machine(name=vms[__index],
+        vms_get_virtual_machine = [vsphere.get_virtual_machine(name=vms[__index],
             datacenter_id=datacenter.id) for __index in range(len(vms))]
-        vm_affinity_rule = vsphere.ComputeClusterVmAffinityRule("vmAffinityRule",
+        vm_affinity_rule = vsphere.ComputeClusterVmAffinityRule("vm_affinity_rule",
+            name="vm-affinity-rule",
             enabled=True,
             compute_cluster_id=cluster.id,
-            virtual_machine_ids=[__item.id for __item in vms_virtual_machine])
+            virtual_machine_ids=[__item.id for __item in vms_get_virtual_machine])
         ```
-        <!--End PulumiCodeChooser -->
+
+        ## Importing
+
+        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:
 
         :param str resource_name: The name of the resource.
         :param ComputeClusterVmAffinityRuleArgs args: The arguments to use to populate this resource's properties.

pulumi_vsphere/datacenter.py

@@ -20,7 +20,7 @@ class DatacenterArgs:
                  tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None):
         """
         The set of arguments for constructing a Datacenter resource.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to value 
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to value
                strings to set for datacenter resource. See
                [here][docs-setting-custom-attributes] for a reference on how to set values
                for custom attributes.
@@ -34,9 +34,6 @@ class DatacenterArgs:
         :param pulumi.Input[str] name: The name of the datacenter. This name needs to be unique
                within the folder. Forces a new resource if changed.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
-               
-               > **NOTE:** Tagging support is unsupported on direct ESXi connections and
-               requires vCenter 6.0 or higher.
         """
         if custom_attributes is not None:
             pulumi.set(__self__, "custom_attributes", custom_attributes)
@@ -51,7 +48,7 @@ class DatacenterArgs:
     @pulumi.getter(name="customAttributes")
     def custom_attributes(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
-        Map of custom attribute ids to value 
+        Map of custom attribute ids to value
         strings to set for datacenter resource. See
         [here][docs-setting-custom-attributes] for a reference on how to set values
         for custom attributes.
@@ -98,9 +95,6 @@ class DatacenterArgs:
     def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
         The IDs of any tags to attach to this resource.
-
-        > **NOTE:** Tagging support is unsupported on direct ESXi connections and
-        requires vCenter 6.0 or higher.
         """
         return pulumi.get(self, "tags")
 
@@ -119,7 +113,7 @@ class _DatacenterState:
                  tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None):
         """
         Input properties used for looking up and filtering Datacenter resources.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to value 
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to value
                strings to set for datacenter resource. See
                [here][docs-setting-custom-attributes] for a reference on how to set values
                for custom attributes.
@@ -134,9 +128,6 @@ class _DatacenterState:
         :param pulumi.Input[str] name: The name of the datacenter. This name needs to be unique
                within the folder. Forces a new resource if changed.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
-               
-               > **NOTE:** Tagging support is unsupported on direct ESXi connections and
-               requires vCenter 6.0 or higher.
         """
         if custom_attributes is not None:
             pulumi.set(__self__, "custom_attributes", custom_attributes)
@@ -153,7 +144,7 @@ class _DatacenterState:
     @pulumi.getter(name="customAttributes")
     def custom_attributes(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
-        Map of custom attribute ids to value 
+        Map of custom attribute ids to value
         strings to set for datacenter resource. See
         [here][docs-setting-custom-attributes] for a reference on how to set values
         for custom attributes.
@@ -212,9 +203,6 @@ class _DatacenterState:
     def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
         The IDs of any tags to attach to this resource.
-
-        > **NOTE:** Tagging support is unsupported on direct ESXi connections and
-        requires vCenter 6.0 or higher.
         """
         return pulumi.get(self, "tags")
 
@@ -241,29 +229,36 @@ class Datacenter(pulumi.CustomResource):
 
         ### Create datacenter on the root folder
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_vsphere as vsphere
 
-        prod_datacenter = vsphere.Datacenter("prodDatacenter")
+        prod_datacenter = vsphere.Datacenter("prod_datacenter", name="my_prod_datacenter")
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Create datacenter on a subfolder
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_vsphere as vsphere
 
-        research_datacenter = vsphere.Datacenter("researchDatacenter", folder="/research/")
+        research_datacenter = vsphere.Datacenter("research_datacenter",
+            name="my_research_datacenter",
+            folder="/research/")
         ```
-        <!--End PulumiCodeChooser -->
+
+        ## Importing
+
+        An existing datacenter can be [imported][docs-import] into this resource
+        via supplying the full path to the datacenter. An example is below:
+
+        [docs-import]: /docs/import/index.html
+
+        The above would import the datacenter named `dc1`.
 
         :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: Map of custom attribute ids to value 
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to value
                strings to set for datacenter resource. See
                [here][docs-setting-custom-attributes] for a reference on how to set values
                for custom attributes.
@@ -277,9 +272,6 @@ class Datacenter(pulumi.CustomResource):
         :param pulumi.Input[str] name: The name of the datacenter. This name needs to be unique
                within the folder. Forces a new resource if changed.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
-               
-               > **NOTE:** Tagging support is unsupported on direct ESXi connections and
-               requires vCenter 6.0 or higher.
         """
         ...
     @overload
@@ -295,25 +287,32 @@ class Datacenter(pulumi.CustomResource):
 
         ### Create datacenter on the root folder
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_vsphere as vsphere
 
-        prod_datacenter = vsphere.Datacenter("prodDatacenter")
+        prod_datacenter = vsphere.Datacenter("prod_datacenter", name="my_prod_datacenter")
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Create datacenter on a subfolder
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_vsphere as vsphere
 
-        research_datacenter = vsphere.Datacenter("researchDatacenter", folder="/research/")
+        research_datacenter = vsphere.Datacenter("research_datacenter",
+            name="my_research_datacenter",
+            folder="/research/")
         ```
-        <!--End PulumiCodeChooser -->
+
+        ## Importing
+
+        An existing datacenter can be [imported][docs-import] into this resource
+        via supplying the full path to the datacenter. An example is below:
+
+        [docs-import]: /docs/import/index.html
+
+        The above would import the datacenter named `dc1`.
 
         :param str resource_name: The name of the resource.
         :param DatacenterArgs args: The arguments to use to populate this resource's properties.
@@ -370,7 +369,7 @@ class Datacenter(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[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to value 
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to value
                strings to set for datacenter resource. See
                [here][docs-setting-custom-attributes] for a reference on how to set values
                for custom attributes.
@@ -385,9 +384,6 @@ class Datacenter(pulumi.CustomResource):
         :param pulumi.Input[str] name: The name of the datacenter. This name needs to be unique
                within the folder. Forces a new resource if changed.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
-               
-               > **NOTE:** Tagging support is unsupported on direct ESXi connections and
-               requires vCenter 6.0 or higher.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -404,7 +400,7 @@ class Datacenter(pulumi.CustomResource):
     @pulumi.getter(name="customAttributes")
     def custom_attributes(self) -> pulumi.Output[Optional[Mapping[str, str]]]:
         """
-        Map of custom attribute ids to value 
+        Map of custom attribute ids to value
         strings to set for datacenter resource. See
         [here][docs-setting-custom-attributes] for a reference on how to set values
         for custom attributes.
@@ -447,9 +443,6 @@ class Datacenter(pulumi.CustomResource):
     def tags(self) -> pulumi.Output[Optional[Sequence[str]]]:
         """
         The IDs of any tags to attach to this resource.
-
-        > **NOTE:** Tagging support is unsupported on direct ESXi connections and
-        requires vCenter 6.0 or higher.
         """
         return pulumi.get(self, "tags")