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

pulumi_vsphere/compute_cluster_vm_group.py

@@ -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__ = ['ComputeClusterVmGroupArgs', 'ComputeClusterVmGroup']
@@ -14,23 +19,28 @@ __all__ = ['ComputeClusterVmGroupArgs', 'ComputeClusterVmGroup']
 @pulumi.input_type
 class ComputeClusterVmGroupArgs:
     def __init__(__self__, *,
-                 compute_cluster_id: pulumi.Input[str],
-                 name: Optional[pulumi.Input[str]] = None,
-                 virtual_machine_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None):
+                 compute_cluster_id: pulumi.Input[_builtins.str],
+                 name: Optional[pulumi.Input[_builtins.str]] = None,
+                 virtual_machine_ids: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None):
         """
         The set of arguments for constructing a ComputeClusterVmGroup 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] name: The name of the VM group. This must be unique in the
+        :param pulumi.Input[_builtins.str] name: The name of the VM group. This must be unique in the
                cluster. Forces a new resource if changed.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] virtual_machine_ids: The UUIDs of the virtual machines in this
+        :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] virtual_machine_ids: The UUIDs of the virtual machines in this
                group.
                
                > **NOTE:** The namespace for cluster names on this resource (defined by the
                `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:
@@ -38,9 +48,9 @@ class ComputeClusterVmGroupArgs:
         if virtual_machine_ids is not None:
             pulumi.set(__self__, "virtual_machine_ids", virtual_machine_ids)
 
-    @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
@@ -49,12 +59,12 @@ class ComputeClusterVmGroupArgs:
         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
-    def name(self) -> Optional[pulumi.Input[str]]:
+    def name(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         The name of the VM group. This must be unique in the
         cluster. Forces a new resource if changed.
@@ -62,12 +72,12 @@ class ComputeClusterVmGroupArgs:
         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="virtualMachineIds")
-    def virtual_machine_ids(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
+    def virtual_machine_ids(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]:
         """
         The UUIDs of the virtual machines in this
         group.
@@ -76,34 +86,44 @@ 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")
 
     @virtual_machine_ids.setter
-    def virtual_machine_ids(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
+    def virtual_machine_ids(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]):
         pulumi.set(self, "virtual_machine_ids", value)
 
 
 @pulumi.input_type
 class _ComputeClusterVmGroupState:
     def __init__(__self__, *,
-                 compute_cluster_id: Optional[pulumi.Input[str]] = None,
-                 name: Optional[pulumi.Input[str]] = None,
-                 virtual_machine_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None):
+                 compute_cluster_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 name: Optional[pulumi.Input[_builtins.str]] = None,
+                 virtual_machine_ids: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None):
         """
         Input properties used for looking up and filtering ComputeClusterVmGroup resources.
-        :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] name: The name of the VM group. This must be unique in the
+        :param pulumi.Input[_builtins.str] name: The name of the VM group. This must be unique in the
                cluster. Forces a new resource if changed.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] virtual_machine_ids: The UUIDs of the virtual machines in this
+        :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] virtual_machine_ids: The UUIDs of the virtual machines in this
                group.
                
                > **NOTE:** The namespace for cluster names on this resource (defined by the
                `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)
@@ -112,9 +132,9 @@ class _ComputeClusterVmGroupState:
         if virtual_machine_ids is not None:
             pulumi.set(__self__, "virtual_machine_ids", virtual_machine_ids)
 
-    @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
@@ -123,12 +143,12 @@ class _ComputeClusterVmGroupState:
         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 name(self) -> Optional[pulumi.Input[str]]:
+    def name(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         The name of the VM group. This must be unique in the
         cluster. Forces a new resource if changed.
@@ -136,12 +156,12 @@ class _ComputeClusterVmGroupState:
         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="virtualMachineIds")
-    def virtual_machine_ids(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
+    def virtual_machine_ids(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]:
         """
         The UUIDs of the virtual machines in this
         group.
@@ -150,39 +170,130 @@ 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")
 
     @virtual_machine_ids.setter
-    def virtual_machine_ids(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
+    def virtual_machine_ids(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]):
         pulumi.set(self, "virtual_machine_ids", value)
 
 
+@pulumi.type_token("vsphere:index/computeClusterVmGroup:ComputeClusterVmGroup")
 class ComputeClusterVmGroup(pulumi.CustomResource):
     @overload
     def __init__(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 compute_cluster_id: Optional[pulumi.Input[str]] = None,
-                 name: Optional[pulumi.Input[str]] = None,
-                 virtual_machine_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
+                 compute_cluster_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 name: Optional[pulumi.Input[_builtins.str]] = None,
+                 virtual_machine_ids: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
                  __props__=None):
         """
-        Create a ComputeClusterVmGroup resource with the given unique name, props, and options.
+        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:
+
+        [docs-import]: https://developer.hashicorp.com/terraform/cli/import
+
+        ```sh
+        $ pulumi import vsphere:index/computeClusterVmGroup:ComputeClusterVmGroup cluster_vm_group \\
+        ```
+
+          '{"compute_cluster_path": "/dc1/host/cluster1", \\
+
+          "name": "pulumi-test-cluster-vm-group"}'
+
         :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
+        :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] name: The name of the VM group. This must be unique in the
+        :param pulumi.Input[_builtins.str] name: The name of the VM group. This must be unique in the
                cluster. Forces a new resource if changed.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] virtual_machine_ids: The UUIDs of the virtual machines in this
+        :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] virtual_machine_ids: The UUIDs of the virtual machines in this
                group.
                
                > **NOTE:** The namespace for cluster names on this resource (defined by the
                `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
@@ -191,7 +302,87 @@ class ComputeClusterVmGroup(pulumi.CustomResource):
                  args: ComputeClusterVmGroupArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a ComputeClusterVmGroup resource with the given unique name, props, and options.
+        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:
+
+        [docs-import]: https://developer.hashicorp.com/terraform/cli/import
+
+        ```sh
+        $ pulumi import vsphere:index/computeClusterVmGroup:ComputeClusterVmGroup cluster_vm_group \\
+        ```
+
+          '{"compute_cluster_path": "/dc1/host/cluster1", \\
+
+          "name": "pulumi-test-cluster-vm-group"}'
+
         :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.
@@ -207,9 +398,9 @@ class ComputeClusterVmGroup(pulumi.CustomResource):
     def _internal_init(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 compute_cluster_id: Optional[pulumi.Input[str]] = None,
-                 name: Optional[pulumi.Input[str]] = None,
-                 virtual_machine_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
+                 compute_cluster_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 name: Optional[pulumi.Input[_builtins.str]] = None,
+                 virtual_machine_ids: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
         if not isinstance(opts, pulumi.ResourceOptions):
@@ -234,9 +425,9 @@ class ComputeClusterVmGroup(pulumi.CustomResource):
     def get(resource_name: str,
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
-            compute_cluster_id: Optional[pulumi.Input[str]] = None,
-            name: Optional[pulumi.Input[str]] = None,
-            virtual_machine_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None) -> 'ComputeClusterVmGroup':
+            compute_cluster_id: Optional[pulumi.Input[_builtins.str]] = None,
+            name: Optional[pulumi.Input[_builtins.str]] = None,
+            virtual_machine_ids: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None) -> 'ComputeClusterVmGroup':
         """
         Get an existing ComputeClusterVmGroup resource's state with the given name, id, and optional extra
         properties used to qualify the lookup.
@@ -244,18 +435,23 @@ class ComputeClusterVmGroup(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] 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] name: The name of the VM group. This must be unique in the
+        :param pulumi.Input[_builtins.str] name: The name of the VM group. This must be unique in the
                cluster. Forces a new resource if changed.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] virtual_machine_ids: The UUIDs of the virtual machines in this
+        :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] virtual_machine_ids: The UUIDs of the virtual machines in this
                group.
                
                > **NOTE:** The namespace for cluster names on this resource (defined by the
                `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))
 
@@ -266,9 +462,9 @@ class ComputeClusterVmGroup(pulumi.CustomResource):
         __props__.__dict__["virtual_machine_ids"] = virtual_machine_ids
         return ComputeClusterVmGroup(resource_name, opts=opts, __props__=__props__)
 
-    @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
@@ -276,18 +472,18 @@ class ComputeClusterVmGroup(pulumi.CustomResource):
         """
         return pulumi.get(self, "compute_cluster_id")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def name(self) -> pulumi.Output[str]:
+    def name(self) -> pulumi.Output[_builtins.str]:
         """
         The name of the VM group. This must be unique in the
         cluster. Forces a new resource if changed.
         """
         return pulumi.get(self, "name")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="virtualMachineIds")
-    def virtual_machine_ids(self) -> pulumi.Output[Optional[Sequence[str]]]:
+    def virtual_machine_ids(self) -> pulumi.Output[Optional[Sequence[_builtins.str]]]:
         """
         The UUIDs of the virtual machines in this
         group.
@@ -296,6 +492,11 @@ 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")