pulumi-vsphere 4.12.0__py3-none-any.whl → 4.12.0a1725645004__py3-none-any.whl

pulumi_vsphere/compute_cluster_vm_group.py

@@ -4,14 +4,9 @@
 
 import copy
 import warnings
-import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
-if sys.version_info >= (3, 11):
-    from typing import NotRequired, TypedDict, TypeAlias
-else:
-    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = ['ComputeClusterVmGroupArgs', 'ComputeClusterVmGroup']
@@ -36,11 +31,6 @@ class ComputeClusterVmGroupArgs:
                `name` argument) is shared with the
                `ComputeClusterHostGroup`
                resource. Make sure your names are unique across both resources.
-               
-               > **NOTE:** To update a existing VM group, you must first import the group with `import` command in
-               import section. When importing a VM group, validate that all virtual machines that
-               need to be in the group are included in the `virtual_machine_ids`; otherwise, any virtual machines
-               that are not in `virtual_machine_ids` the included will be removed from the group.
         """
         pulumi.set(__self__, "compute_cluster_id", compute_cluster_id)
         if name is not None:
@@ -86,11 +76,6 @@ class ComputeClusterVmGroupArgs:
         `name` argument) is shared with the
         `ComputeClusterHostGroup`
         resource. Make sure your names are unique across both resources.
-
-        > **NOTE:** To update a existing VM group, you must first import the group with `import` command in
-        import section. When importing a VM group, validate that all virtual machines that
-        need to be in the group are included in the `virtual_machine_ids`; otherwise, any virtual machines
-        that are not in `virtual_machine_ids` the included will be removed from the group.
         """
         return pulumi.get(self, "virtual_machine_ids")
 
@@ -119,11 +104,6 @@ class _ComputeClusterVmGroupState:
                `name` argument) is shared with the
                `ComputeClusterHostGroup`
                resource. Make sure your names are unique across both resources.
-               
-               > **NOTE:** To update a existing VM group, you must first import the group with `import` command in
-               import section. When importing a VM group, validate that all virtual machines that
-               need to be in the group are included in the `virtual_machine_ids`; otherwise, any virtual machines
-               that are not in `virtual_machine_ids` the included will be removed from the group.
         """
         if compute_cluster_id is not None:
             pulumi.set(__self__, "compute_cluster_id", compute_cluster_id)
@@ -170,11 +150,6 @@ class _ComputeClusterVmGroupState:
         `name` argument) is shared with the
         `ComputeClusterHostGroup`
         resource. Make sure your names are unique across both resources.
-
-        > **NOTE:** To update a existing VM group, you must first import the group with `import` command in
-        import section. When importing a VM group, validate that all virtual machines that
-        need to be in the group are included in the `virtual_machine_ids`; otherwise, any virtual machines
-        that are not in `virtual_machine_ids` the included will be removed from the group.
         """
         return pulumi.get(self, "virtual_machine_ids")
 
@@ -193,85 +168,7 @@ class ComputeClusterVmGroup(pulumi.CustomResource):
                  virtual_machine_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  __props__=None):
         """
-        The `ComputeClusterVmGroup` resource can be used to manage groups of
-        virtual machines in a cluster, either created by the
-        [`ComputeCluster`][tf-vsphere-cluster-resource] resource or looked up
-        by the [`ComputeCluster`][tf-vsphere-cluster-data-source] data source.
-
-        [tf-vsphere-cluster-resource]: /docs/providers/vsphere/r/compute_cluster.html
-        [tf-vsphere-cluster-data-source]: /docs/providers/vsphere/d/compute_cluster.html
-
-        This resource mainly serves as an input to the
-        [`ComputeClusterVmDependencyRule`][tf-vsphere-cluster-vm-dependency-rule-resource]
-        and
-        [`ComputeClusterVmHostRule`][tf-vsphere-cluster-vm-host-rule-resource]
-        resources. See the individual resource documentation pages for more information.
-
-        [tf-vsphere-cluster-vm-dependency-rule-resource]: /docs/providers/vsphere/r/compute_cluster_vm_dependency_rule.html
-        [tf-vsphere-cluster-vm-host-rule-resource]: /docs/providers/vsphere/r/compute_cluster_vm_host_rule.html
-
-        > **NOTE:** This resource requires vCenter and is not available on direct ESXi
-        connections.
-
-        ## Example Usage
-
-        The example below creates two virtual machines in a cluster using the
-        `VirtualMachine` resource, creating the
-        virtual machine in the cluster looked up by the
-        `ComputeCluster` data source. It
-        then creates a group from these two virtual machines.
-
-        ```python
-        import pulumi
-        import pulumi_vsphere as vsphere
-
-        datacenter = vsphere.get_datacenter(name="dc-01")
-        datastore = vsphere.get_datastore(name="datastore1",
-            datacenter_id=datacenter.id)
-        cluster = vsphere.get_compute_cluster(name="cluster-01",
-            datacenter_id=datacenter.id)
-        network = vsphere.get_network(name="network1",
-            datacenter_id=datacenter.id)
-        vm = []
-        for range in [{"value": i} for i in range(0, 2)]:
-            vm.append(vsphere.VirtualMachine(f"vm-{range['value']}",
-                name=f"test-{range['value']}",
-                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=[[__item.id for __item in vm]])
-        ```
-
-        ## Import
-
-        An existing group can be imported into this resource by
-
-        supplying both the path to the cluster, and the name of the VM group. If the
-
-        name or cluster is not found, or if the group is of a different type, an error
-
-        will be returned. An example is below:
-
-        ```sh
-        $ pulumi import vsphere:index/computeClusterVmGroup:ComputeClusterVmGroup cluster_vm_group \\
-        ```
-
-          '{"compute_cluster_path": "/dc1/host/cluster1", \\
-
-          "name": "pulumi-test-cluster-vm-group"}'
-
+        Create a ComputeClusterVmGroup resource with the given unique name, props, and options.
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] compute_cluster_id: The managed object reference
@@ -286,11 +183,6 @@ class ComputeClusterVmGroup(pulumi.CustomResource):
                `name` argument) is shared with the
                `ComputeClusterHostGroup`
                resource. Make sure your names are unique across both resources.
-               
-               > **NOTE:** To update a existing VM group, you must first import the group with `import` command in
-               import section. When importing a VM group, validate that all virtual machines that
-               need to be in the group are included in the `virtual_machine_ids`; otherwise, any virtual machines
-               that are not in `virtual_machine_ids` the included will be removed from the group.
         """
         ...
     @overload
@@ -299,85 +191,7 @@ class ComputeClusterVmGroup(pulumi.CustomResource):
                  args: ComputeClusterVmGroupArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        The `ComputeClusterVmGroup` resource can be used to manage groups of
-        virtual machines in a cluster, either created by the
-        [`ComputeCluster`][tf-vsphere-cluster-resource] resource or looked up
-        by the [`ComputeCluster`][tf-vsphere-cluster-data-source] data source.
-
-        [tf-vsphere-cluster-resource]: /docs/providers/vsphere/r/compute_cluster.html
-        [tf-vsphere-cluster-data-source]: /docs/providers/vsphere/d/compute_cluster.html
-
-        This resource mainly serves as an input to the
-        [`ComputeClusterVmDependencyRule`][tf-vsphere-cluster-vm-dependency-rule-resource]
-        and
-        [`ComputeClusterVmHostRule`][tf-vsphere-cluster-vm-host-rule-resource]
-        resources. See the individual resource documentation pages for more information.
-
-        [tf-vsphere-cluster-vm-dependency-rule-resource]: /docs/providers/vsphere/r/compute_cluster_vm_dependency_rule.html
-        [tf-vsphere-cluster-vm-host-rule-resource]: /docs/providers/vsphere/r/compute_cluster_vm_host_rule.html
-
-        > **NOTE:** This resource requires vCenter and is not available on direct ESXi
-        connections.
-
-        ## Example Usage
-
-        The example below creates two virtual machines in a cluster using the
-        `VirtualMachine` resource, creating the
-        virtual machine in the cluster looked up by the
-        `ComputeCluster` data source. It
-        then creates a group from these two virtual machines.
-
-        ```python
-        import pulumi
-        import pulumi_vsphere as vsphere
-
-        datacenter = vsphere.get_datacenter(name="dc-01")
-        datastore = vsphere.get_datastore(name="datastore1",
-            datacenter_id=datacenter.id)
-        cluster = vsphere.get_compute_cluster(name="cluster-01",
-            datacenter_id=datacenter.id)
-        network = vsphere.get_network(name="network1",
-            datacenter_id=datacenter.id)
-        vm = []
-        for range in [{"value": i} for i in range(0, 2)]:
-            vm.append(vsphere.VirtualMachine(f"vm-{range['value']}",
-                name=f"test-{range['value']}",
-                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=[[__item.id for __item in vm]])
-        ```
-
-        ## Import
-
-        An existing group can be imported into this resource by
-
-        supplying both the path to the cluster, and the name of the VM group. If the
-
-        name or cluster is not found, or if the group is of a different type, an error
-
-        will be returned. An example is below:
-
-        ```sh
-        $ pulumi import vsphere:index/computeClusterVmGroup:ComputeClusterVmGroup cluster_vm_group \\
-        ```
-
-          '{"compute_cluster_path": "/dc1/host/cluster1", \\
-
-          "name": "pulumi-test-cluster-vm-group"}'
-
+        Create a ComputeClusterVmGroup resource with the given unique name, props, and options.
         :param str resource_name: The name of the resource.
         :param ComputeClusterVmGroupArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -442,11 +256,6 @@ class ComputeClusterVmGroup(pulumi.CustomResource):
                `name` argument) is shared with the
                `ComputeClusterHostGroup`
                resource. Make sure your names are unique across both resources.
-               
-               > **NOTE:** To update a existing VM group, you must first import the group with `import` command in
-               import section. When importing a VM group, validate that all virtual machines that
-               need to be in the group are included in the `virtual_machine_ids`; otherwise, any virtual machines
-               that are not in `virtual_machine_ids` the included will be removed from the group.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -487,11 +296,6 @@ class ComputeClusterVmGroup(pulumi.CustomResource):
         `name` argument) is shared with the
         `ComputeClusterHostGroup`
         resource. Make sure your names are unique across both resources.
-
-        > **NOTE:** To update a existing VM group, you must first import the group with `import` command in
-        import section. When importing a VM group, validate that all virtual machines that
-        need to be in the group are included in the `virtual_machine_ids`; otherwise, any virtual machines
-        that are not in `virtual_machine_ids` the included will be removed from the group.
         """
         return pulumi.get(self, "virtual_machine_ids")
 

pulumi_vsphere/compute_cluster_vm_host_rule.py

@@ -4,14 +4,9 @@
 
 import copy
 import warnings
-import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
-if sys.version_info >= (3, 11):
-    from typing import NotRequired, TypedDict, TypeAlias
-else:
-    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = ['ComputeClusterVmHostRuleArgs', 'ComputeClusterVmHostRule']
@@ -336,40 +331,7 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
                  vm_group_name: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        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.
-
-        ## 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:
-
-        ```sh
-        $ pulumi import vsphere:index/computeClusterVmHostRule:ComputeClusterVmHostRule cluster_vm_host_rule \\
-        ```
-
-          '{"compute_cluster_path": "/dc1/host/cluster1", \\
-
-          "name": "pulumi-test-cluster-vm-host-rule"}'
-
+        Create a ComputeClusterVmHostRule resource with the given unique name, props, and options.
         :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
@@ -404,40 +366,7 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
                  args: ComputeClusterVmHostRuleArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        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.
-
-        ## 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:
-
-        ```sh
-        $ pulumi import vsphere:index/computeClusterVmHostRule:ComputeClusterVmHostRule cluster_vm_host_rule \\
-        ```
-
-          '{"compute_cluster_path": "/dc1/host/cluster1", \\
-
-          "name": "pulumi-test-cluster-vm-host-rule"}'
-
+        Create a ComputeClusterVmHostRule resource with the given unique name, props, and options.
         :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.

pulumi_vsphere/config/__init__.pyi

@@ -4,14 +4,9 @@
 
 import copy
 import warnings
-import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
-if sys.version_info >= (3, 11):
-    from typing import NotRequired, TypedDict, TypeAlias
-else:
-    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from .. import _utilities
 
 allowUnverifiedSsl: Optional[bool]

pulumi_vsphere/config/vars.py

@@ -4,14 +4,9 @@
 
 import copy
 import warnings
-import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
-if sys.version_info >= (3, 11):
-    from typing import NotRequired, TypedDict, TypeAlias
-else:
-    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from .. import _utilities
 
 import types

pulumi_vsphere/content_library.py

@@ -4,14 +4,9 @@
 
 import copy
 import warnings
-import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
-if sys.version_info >= (3, 11):
-    from typing import NotRequired, TypedDict, TypeAlias
-else:
-    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 from . import outputs
 from ._inputs import *
@@ -205,55 +200,7 @@ class ContentLibrary(pulumi.CustomResource):
                  subscription: Optional[pulumi.Input[Union['ContentLibrarySubscriptionArgs', 'ContentLibrarySubscriptionArgsDict']]] = None,
                  __props__=None):
         """
-        The `ContentLibrary` resource can be used to manage content libraries.
-
-        > **NOTE:** This resource requires a vCenter Server instance and is not available on direct ESXi host connections.
-
-        ## Example Usage
-
-        The following example creates a publishing content library using the datastore named `publisher-datastore` as the storage backing.
-
-        ```python
-        import pulumi
-        import pulumi_vsphere as vsphere
-
-        datacenter_a = vsphere.get_datacenter(name="dc-01-a")
-        publisher_datastore = vsphere.get_datastore(name="publisher-datastore",
-            datacenter_id=datacenter_a.id)
-        publisher_content_library = vsphere.ContentLibrary("publisher_content_library",
-            name="Publisher Content Library",
-            description="A publishing content library.",
-            storage_backings=[publisher_datastore.id])
-        ```
-
-        The next example creates a subscribed content library using the URL of the publisher content library as the source and the datastore named `subscriber-datastore` as the storage backing.
-
-        ```python
-        import pulumi
-        import pulumi_vsphere as vsphere
-
-        datacenter_b = vsphere.get_datacenter(name="dc-01-b")
-        subscriber_datastore = vsphere.get_datastore(name="subscriber-datastore",
-            datacenter_id=datacenter_b.id)
-        subscriber_content_library = vsphere.ContentLibrary("subscriber_content_library",
-            name="Subscriber Content Library",
-            description="A subscribing content library.",
-            storage_backings=[subscriber_datastore.id],
-            subscription={
-                "subscription_url": "https://vc-01-a.example.com:443/cls/vcsp/lib/f42a4b25-844a-44ec-9063-a3a5e9cc88c7/lib.json",
-                "automatic_sync": True,
-                "on_demand": False,
-            })
-        ```
-
-        ## Import
-
-        An existing content library can be imported into this resource by supplying the content library ID. For example:
-
-        ```sh
-        $ pulumi import vsphere:index/contentLibrary:ContentLibrary vsphere_content_library publisher_content_library f42a4b25-844a-44ec-9063-a3a5e9cc88c7
-        ```
-
+        Create a ContentLibrary resource with the given unique name, props, and options.
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] description: A description for the content library.
@@ -269,55 +216,7 @@ class ContentLibrary(pulumi.CustomResource):
                  args: ContentLibraryArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        The `ContentLibrary` resource can be used to manage content libraries.
-
-        > **NOTE:** This resource requires a vCenter Server instance and is not available on direct ESXi host connections.
-
-        ## Example Usage
-
-        The following example creates a publishing content library using the datastore named `publisher-datastore` as the storage backing.
-
-        ```python
-        import pulumi
-        import pulumi_vsphere as vsphere
-
-        datacenter_a = vsphere.get_datacenter(name="dc-01-a")
-        publisher_datastore = vsphere.get_datastore(name="publisher-datastore",
-            datacenter_id=datacenter_a.id)
-        publisher_content_library = vsphere.ContentLibrary("publisher_content_library",
-            name="Publisher Content Library",
-            description="A publishing content library.",
-            storage_backings=[publisher_datastore.id])
-        ```
-
-        The next example creates a subscribed content library using the URL of the publisher content library as the source and the datastore named `subscriber-datastore` as the storage backing.
-
-        ```python
-        import pulumi
-        import pulumi_vsphere as vsphere
-
-        datacenter_b = vsphere.get_datacenter(name="dc-01-b")
-        subscriber_datastore = vsphere.get_datastore(name="subscriber-datastore",
-            datacenter_id=datacenter_b.id)
-        subscriber_content_library = vsphere.ContentLibrary("subscriber_content_library",
-            name="Subscriber Content Library",
-            description="A subscribing content library.",
-            storage_backings=[subscriber_datastore.id],
-            subscription={
-                "subscription_url": "https://vc-01-a.example.com:443/cls/vcsp/lib/f42a4b25-844a-44ec-9063-a3a5e9cc88c7/lib.json",
-                "automatic_sync": True,
-                "on_demand": False,
-            })
-        ```
-
-        ## Import
-
-        An existing content library can be imported into this resource by supplying the content library ID. For example:
-
-        ```sh
-        $ pulumi import vsphere:index/contentLibrary:ContentLibrary vsphere_content_library publisher_content_library f42a4b25-844a-44ec-9063-a3a5e9cc88c7
-        ```
-
+        Create a ContentLibrary resource with the given unique name, props, and options.
         :param str resource_name: The name of the resource.
         :param ContentLibraryArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.