pulumi-vsphere 4.11.0__py3-none-any.whl → 4.11.0a1710920591__py3-none-any.whl

pulumi_vsphere/get_datacenter.py

@@ -63,12 +63,14 @@ def get_datacenter(name: Optional[str] = None,
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     datacenter = vsphere.get_datacenter(name="dc-01")
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param str name: The name of the datacenter. This can be a name or path.
@@ -100,12 +102,14 @@ def get_datacenter_output(name: Optional[pulumi.Input[Optional[str]]] = None,
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     datacenter = vsphere.get_datacenter(name="dc-01")
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param str name: The name of the datacenter. This can be a name or path.

pulumi_vsphere/get_datastore.py

@@ -55,11 +55,11 @@ class GetDatastoreResult:
 
     @property
     @pulumi.getter
-    def stats(self) -> Optional[Mapping[str, str]]:
+    def stats(self) -> Optional[Mapping[str, Any]]:
         """
-        The disk space usage statistics for the specific datastore. The
-        total datastore capacity is represented as `capacity` and the free remaining
-        disk is represented as `free`.
+        The disk space usage statistics for the specific datastore. The total
+        datastore capacity is represented as `capacity` and the free remaining disk is
+        represented as `free`.
         """
         return pulumi.get(self, "stats")
 
@@ -78,7 +78,7 @@ class AwaitableGetDatastoreResult(GetDatastoreResult):
 
 def get_datastore(datacenter_id: Optional[str] = None,
                   name: Optional[str] = None,
-                  stats: Optional[Mapping[str, str]] = None,
+                  stats: Optional[Mapping[str, Any]] = None,
                   opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetDatastoreResult:
     """
     The `get_datastore` data source can be used to discover the ID of a
@@ -88,6 +88,7 @@ def get_datastore(datacenter_id: Optional[str] = None,
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -96,6 +97,7 @@ def get_datastore(datacenter_id: Optional[str] = None,
     datastore = vsphere.get_datastore(name="datastore-01",
         datacenter_id=datacenter.id)
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param str datacenter_id: The managed object reference ID
@@ -103,9 +105,9 @@ def get_datastore(datacenter_id: Optional[str] = None,
            search path used in `name` is an absolute path. For default datacenters, use
            the `id` attribute from an empty `Datacenter` data source.
     :param str name: The name of the datastore. This can be a name or path.
-    :param Mapping[str, str] stats: The disk space usage statistics for the specific datastore. The
-           total datastore capacity is represented as `capacity` and the free remaining
-           disk is represented as `free`.
+    :param Mapping[str, Any] stats: The disk space usage statistics for the specific datastore. The total
+           datastore capacity is represented as `capacity` and the free remaining disk is
+           represented as `free`.
     """
     __args__ = dict()
     __args__['datacenterId'] = datacenter_id
@@ -124,7 +126,7 @@ def get_datastore(datacenter_id: Optional[str] = None,
 @_utilities.lift_output_func(get_datastore)
 def get_datastore_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] = None,
                          name: Optional[pulumi.Input[str]] = None,
-                         stats: Optional[pulumi.Input[Optional[Mapping[str, str]]]] = None,
+                         stats: Optional[pulumi.Input[Optional[Mapping[str, Any]]]] = None,
                          opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetDatastoreResult]:
     """
     The `get_datastore` data source can be used to discover the ID of a
@@ -134,6 +136,7 @@ def get_datastore_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] =
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -142,6 +145,7 @@ def get_datastore_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] =
     datastore = vsphere.get_datastore(name="datastore-01",
         datacenter_id=datacenter.id)
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param str datacenter_id: The managed object reference ID
@@ -149,8 +153,8 @@ def get_datastore_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] =
            search path used in `name` is an absolute path. For default datacenters, use
            the `id` attribute from an empty `Datacenter` data source.
     :param str name: The name of the datastore. This can be a name or path.
-    :param Mapping[str, str] stats: The disk space usage statistics for the specific datastore. The
-           total datastore capacity is represented as `capacity` and the free remaining
-           disk is represented as `free`.
+    :param Mapping[str, Any] stats: The disk space usage statistics for the specific datastore. The total
+           datastore capacity is represented as `capacity` and the free remaining disk is
+           represented as `free`.
     """
     ...

pulumi_vsphere/get_datastore_cluster.py

@@ -73,6 +73,7 @@ def get_datastore_cluster(datacenter_id: Optional[str] = None,
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -81,6 +82,7 @@ def get_datastore_cluster(datacenter_id: Optional[str] = None,
     datastore_cluster = vsphere.get_datastore_cluster(name="datastore-cluster-01",
         datacenter_id=datacenter.id)
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param str datacenter_id: The managed object reference
@@ -114,6 +116,7 @@ def get_datastore_cluster_output(datacenter_id: Optional[pulumi.Input[Optional[s
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -122,6 +125,7 @@ def get_datastore_cluster_output(datacenter_id: Optional[pulumi.Input[Optional[s
     datastore_cluster = vsphere.get_datastore_cluster(name="datastore-cluster-01",
         datacenter_id=datacenter.id)
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param str datacenter_id: The managed object reference

pulumi_vsphere/get_datastore_stats.py

@@ -37,10 +37,10 @@ class GetDatastoreStatsResult:
 
     @property
     @pulumi.getter
-    def capacity(self) -> Optional[Mapping[str, str]]:
+    def capacity(self) -> Optional[Mapping[str, Any]]:
         """
-        A mapping of the capacity for all datastore in the datacenter,
-        where the name of the datastore is used as key and the capacity as value.
+        A mapping of the capacity for all datastore in the datacenter
+        , where the name of the datastore is used as key and the capacity as value.
         """
         return pulumi.get(self, "capacity")
 
@@ -48,18 +48,18 @@ class GetDatastoreStatsResult:
     @pulumi.getter(name="datacenterId")
     def datacenter_id(self) -> str:
         """
-        The [managed object reference ID][docs-about-morefs] of the
-        datacenter the datastores are located in.
+        The [managed object reference ID][docs-about-morefs]
+        of the datacenter the datastores are located in.
         """
         return pulumi.get(self, "datacenter_id")
 
     @property
     @pulumi.getter(name="freeSpace")
-    def free_space(self) -> Optional[Mapping[str, str]]:
+    def free_space(self) -> Optional[Mapping[str, Any]]:
         """
         A mapping of the free space for each datastore in the
-        datacenter, where the name of the datastore is used as key and the free space
-        as value.
+        datacenter, where the name of the datastore is used as key and the free
+        space as value.
         """
         return pulumi.get(self, "free_space")
 
@@ -84,18 +84,18 @@ class AwaitableGetDatastoreStatsResult(GetDatastoreStatsResult):
             id=self.id)
 
 
-def get_datastore_stats(capacity: Optional[Mapping[str, str]] = None,
+def get_datastore_stats(capacity: Optional[Mapping[str, Any]] = None,
                         datacenter_id: Optional[str] = None,
-                        free_space: Optional[Mapping[str, str]] = None,
+                        free_space: Optional[Mapping[str, Any]] = None,
                         opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetDatastoreStatsResult:
     """
-    The `get_datastore_stats` data source can be used to retrieve the usage
-    stats of all vSphere datastore objects in a datacenter. This can then be used as
-    a standalone data source to get information required as input to other data
-    sources.
+    The `get_datastore_stats` data source can be used to retrieve the usage stats
+    of all vSphere datastore objects in a datacenter. This can then be used as a
+    standalone datasource to get information required as input to other data sources.
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -103,33 +103,36 @@ def get_datastore_stats(capacity: Optional[Mapping[str, str]] = None,
     datacenter = vsphere.get_datacenter(name="dc-01")
     datastore_stats = vsphere.get_datastore_stats(datacenter_id=datacenter.id)
     ```
+    <!--End PulumiCodeChooser -->
 
-    A useful example of this data source would be to determine the datastore with
-    the most free space. For example, in addition to the above:
+    A usefull example of this datasource would be to determine the
+    datastore with the most free space. For example, in addition to
+    the above:
 
     Create an `outputs.tf` like that:
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
 
-    pulumi.export("maxFreeSpaceName", their_max_free_space_name)
-    pulumi.export("maxFreeSpace", their_max_free_space)
+    pulumi.export("maxFreeSpaceName", local["max_free_space_name"])
+    pulumi.export("maxFreeSpace", local["max_free_space"])
     ```
+    <!--End PulumiCodeChooser -->
 
     and a `locals.tf` like that:
 
 
-    :param Mapping[str, str] capacity: A mapping of the capacity for all datastore in the datacenter,
-           where the name of the datastore is used as key and the capacity as value.
-    :param str datacenter_id: The
-           [managed object reference ID][docs-about-morefs] of the datacenter the
-           datastores are located in. For default datacenters, use the `id` attribute
-           from an empty `Datacenter` data source.
+    :param Mapping[str, Any] capacity: A mapping of the capacity for all datastore in the datacenter
+           , where the name of the datastore is used as key and the capacity as value.
+    :param str datacenter_id: The [managed object reference ID][docs-about-morefs]
+           of the datacenter the datastores are located in. For default datacenters, use
+           the `id` attribute from an empty `Datacenter` data source.
            
            [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
-    :param Mapping[str, str] free_space: A mapping of the free space for each datastore in the
-           datacenter, where the name of the datastore is used as key and the free space
-           as value.
+    :param Mapping[str, Any] free_space: A mapping of the free space for each datastore in the
+           datacenter, where the name of the datastore is used as key and the free
+           space as value.
     """
     __args__ = dict()
     __args__['capacity'] = capacity
@@ -146,18 +149,18 @@ def get_datastore_stats(capacity: Optional[Mapping[str, str]] = None,
 
 
 @_utilities.lift_output_func(get_datastore_stats)
-def get_datastore_stats_output(capacity: Optional[pulumi.Input[Optional[Mapping[str, str]]]] = None,
+def get_datastore_stats_output(capacity: Optional[pulumi.Input[Optional[Mapping[str, Any]]]] = None,
                                datacenter_id: Optional[pulumi.Input[str]] = None,
-                               free_space: Optional[pulumi.Input[Optional[Mapping[str, str]]]] = None,
+                               free_space: Optional[pulumi.Input[Optional[Mapping[str, Any]]]] = None,
                                opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetDatastoreStatsResult]:
     """
-    The `get_datastore_stats` data source can be used to retrieve the usage
-    stats of all vSphere datastore objects in a datacenter. This can then be used as
-    a standalone data source to get information required as input to other data
-    sources.
+    The `get_datastore_stats` data source can be used to retrieve the usage stats
+    of all vSphere datastore objects in a datacenter. This can then be used as a
+    standalone datasource to get information required as input to other data sources.
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -165,32 +168,35 @@ def get_datastore_stats_output(capacity: Optional[pulumi.Input[Optional[Mapping[
     datacenter = vsphere.get_datacenter(name="dc-01")
     datastore_stats = vsphere.get_datastore_stats(datacenter_id=datacenter.id)
     ```
+    <!--End PulumiCodeChooser -->
 
-    A useful example of this data source would be to determine the datastore with
-    the most free space. For example, in addition to the above:
+    A usefull example of this datasource would be to determine the
+    datastore with the most free space. For example, in addition to
+    the above:
 
     Create an `outputs.tf` like that:
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
 
-    pulumi.export("maxFreeSpaceName", their_max_free_space_name)
-    pulumi.export("maxFreeSpace", their_max_free_space)
+    pulumi.export("maxFreeSpaceName", local["max_free_space_name"])
+    pulumi.export("maxFreeSpace", local["max_free_space"])
     ```
+    <!--End PulumiCodeChooser -->
 
     and a `locals.tf` like that:
 
 
-    :param Mapping[str, str] capacity: A mapping of the capacity for all datastore in the datacenter,
-           where the name of the datastore is used as key and the capacity as value.
-    :param str datacenter_id: The
-           [managed object reference ID][docs-about-morefs] of the datacenter the
-           datastores are located in. For default datacenters, use the `id` attribute
-           from an empty `Datacenter` data source.
+    :param Mapping[str, Any] capacity: A mapping of the capacity for all datastore in the datacenter
+           , where the name of the datastore is used as key and the capacity as value.
+    :param str datacenter_id: The [managed object reference ID][docs-about-morefs]
+           of the datacenter the datastores are located in. For default datacenters, use
+           the `id` attribute from an empty `Datacenter` data source.
            
            [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
-    :param Mapping[str, str] free_space: A mapping of the free space for each datastore in the
-           datacenter, where the name of the datastore is used as key and the free space
-           as value.
+    :param Mapping[str, Any] free_space: A mapping of the free space for each datastore in the
+           datacenter, where the name of the datastore is used as key and the free
+           space as value.
     """
     ...

pulumi_vsphere/get_distributed_virtual_switch.py

@@ -97,6 +97,7 @@ def get_distributed_virtual_switch(datacenter_id: Optional[str] = None,
     `DistributedPortGroup` resource that uses the first uplink as a
     primary uplink and the second uplink as a secondary.
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -105,11 +106,11 @@ def get_distributed_virtual_switch(datacenter_id: Optional[str] = None,
     vds = vsphere.get_distributed_virtual_switch(name="vds-01",
         datacenter_id=datacenter.id)
     dvpg = vsphere.DistributedPortGroup("dvpg",
-        name="dvpg-01",
         distributed_virtual_switch_uuid=vds.id,
         active_uplinks=[vds.uplinks[0]],
         standby_uplinks=[vds.uplinks[1]])
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param str datacenter_id: The managed object reference ID
@@ -152,6 +153,7 @@ def get_distributed_virtual_switch_output(datacenter_id: Optional[pulumi.Input[O
     `DistributedPortGroup` resource that uses the first uplink as a
     primary uplink and the second uplink as a secondary.
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -160,11 +162,11 @@ def get_distributed_virtual_switch_output(datacenter_id: Optional[pulumi.Input[O
     vds = vsphere.get_distributed_virtual_switch(name="vds-01",
         datacenter_id=datacenter.id)
     dvpg = vsphere.DistributedPortGroup("dvpg",
-        name="dvpg-01",
         distributed_virtual_switch_uuid=vds.id,
         active_uplinks=[vds.uplinks[0]],
         standby_uplinks=[vds.uplinks[1]])
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param str datacenter_id: The managed object reference ID

pulumi_vsphere/get_dynamic.py

@@ -78,22 +78,22 @@ def get_dynamic(filters: Optional[Sequence[str]] = None,
     """
     [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
 
-    The `get_dynamic` data source can be used to get the
-    [managed object reference ID][docs-about-morefs] of any tagged managed object in
-    vCenter Server by providing a list of tag IDs and an optional regular expression
-    to filter objects by name.
+    The `get_dynamic` data source can be used to get the [managed object reference ID][docs-about-morefs]
+    of any tagged managed object in vCenter Server by providing a list of tag IDs
+    and an optional regular expression to filter objects by name.
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     category = vsphere.get_tag_category(name="SomeCategory")
     tag1 = vsphere.get_tag(name="FirstTag",
-        category_id=cat["id"])
+        category_id=data["vsphere_tag_category"]["cat"]["id"])
     tag2 = vsphere.get_tag(name="SecondTag",
-        category_id=cat["id"])
+        category_id=data["vsphere_tag_category"]["cat"]["id"])
     dyn = vsphere.get_dynamic(filters=[
             tag1.id,
             tag1.id,
@@ -101,15 +101,16 @@ def get_dynamic(filters: Optional[Sequence[str]] = None,
         name_regex="ubuntu",
         type="Datacenter")
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param Sequence[str] filters: A list of tag IDs that must be present on an object to
            be a match.
-    :param str name_regex: A regular expression that will be used to match the
-           object's name.
+    :param str name_regex: A regular expression that will be used to match
+           the object's name.
     :param str type: The managed object type the returned object must match.
            The managed object types can be found in the managed object type section
-           [here](https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/).
+           [here](https://developer.vmware.com/apis/968/vsphere).
     """
     __args__ = dict()
     __args__['filters'] = filters
@@ -133,22 +134,22 @@ def get_dynamic_output(filters: Optional[pulumi.Input[Sequence[str]]] = None,
     """
     [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
 
-    The `get_dynamic` data source can be used to get the
-    [managed object reference ID][docs-about-morefs] of any tagged managed object in
-    vCenter Server by providing a list of tag IDs and an optional regular expression
-    to filter objects by name.
+    The `get_dynamic` data source can be used to get the [managed object reference ID][docs-about-morefs]
+    of any tagged managed object in vCenter Server by providing a list of tag IDs
+    and an optional regular expression to filter objects by name.
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     category = vsphere.get_tag_category(name="SomeCategory")
     tag1 = vsphere.get_tag(name="FirstTag",
-        category_id=cat["id"])
+        category_id=data["vsphere_tag_category"]["cat"]["id"])
     tag2 = vsphere.get_tag(name="SecondTag",
-        category_id=cat["id"])
+        category_id=data["vsphere_tag_category"]["cat"]["id"])
     dyn = vsphere.get_dynamic(filters=[
             tag1.id,
             tag1.id,
@@ -156,14 +157,15 @@ def get_dynamic_output(filters: Optional[pulumi.Input[Sequence[str]]] = None,
         name_regex="ubuntu",
         type="Datacenter")
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param Sequence[str] filters: A list of tag IDs that must be present on an object to
            be a match.
-    :param str name_regex: A regular expression that will be used to match the
-           object's name.
+    :param str name_regex: A regular expression that will be used to match
+           the object's name.
     :param str type: The managed object type the returned object must match.
            The managed object types can be found in the managed object type section
-           [here](https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/).
+           [here](https://developer.vmware.com/apis/968/vsphere).
     """
     ...

pulumi_vsphere/get_folder.py

@@ -57,20 +57,18 @@ def get_folder(path: Optional[str] = None,
                opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetFolderResult:
     """
     The `Folder` data source can be used to get the general attributes of a
-    vSphere inventory folder. The data source supports creating folders of the 5
-    major types - datacenter folders, host and cluster folders, virtual machine
-    folders, storage folders, and network folders.
-
-    Paths are absolute and must include the datacenter.
+    vSphere inventory folder. Paths are absolute and must include the datacenter.
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     folder = vsphere.get_folder(path="/dc-01/datastore-01/folder-01")
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param str path: The absolute path of the folder. For example, given a
@@ -94,20 +92,18 @@ def get_folder_output(path: Optional[pulumi.Input[str]] = None,
                       opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetFolderResult]:
     """
     The `Folder` data source can be used to get the general attributes of a
-    vSphere inventory folder. The data source supports creating folders of the 5
-    major types - datacenter folders, host and cluster folders, virtual machine
-    folders, storage folders, and network folders.
-
-    Paths are absolute and must include the datacenter.
+    vSphere inventory folder. Paths are absolute and must include the datacenter.
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     folder = vsphere.get_folder(path="/dc-01/datastore-01/folder-01")
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param str path: The absolute path of the folder. For example, given a

pulumi_vsphere/get_guest_os_customization.py

@@ -48,11 +48,17 @@ class GetGuestOsCustomizationResult:
     @property
     @pulumi.getter(name="changeVersion")
     def change_version(self) -> str:
+        """
+        The number of last changed version to the customization specification.
+        """
         return pulumi.get(self, "change_version")
 
     @property
     @pulumi.getter
     def description(self) -> str:
+        """
+        The description for the customization specification.
+        """
         return pulumi.get(self, "description")
 
     @property
@@ -66,6 +72,9 @@ class GetGuestOsCustomizationResult:
     @property
     @pulumi.getter(name="lastUpdateTime")
     def last_update_time(self) -> str:
+        """
+        The time of last modification to the customization specification.
+        """
         return pulumi.get(self, "last_update_time")
 
     @property
@@ -76,11 +85,17 @@ class GetGuestOsCustomizationResult:
     @property
     @pulumi.getter
     def specs(self) -> Sequence['outputs.GetGuestOsCustomizationSpecResult']:
+        """
+        Container object for the guest operating system properties to be customized. See virtual machine customizations
+        """
         return pulumi.get(self, "specs")
 
     @property
     @pulumi.getter
     def type(self) -> str:
+        """
+        The type of customization specification: One among: Windows, Linux.
+        """
         return pulumi.get(self, "type")
 
 
@@ -102,12 +117,24 @@ class AwaitableGetGuestOsCustomizationResult(GetGuestOsCustomizationResult):
 def get_guest_os_customization(name: Optional[str] = None,
                                opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetGuestOsCustomizationResult:
     """
-    The `GuestOsCustomization` data source can be used to discover the
-    details about a customization specification for a guest operating system.
+    The `GuestOsCustomization` data source can be used to discover the details about a customization specification for a guest operating system.
+
+    Suggested change
+    > **NOTE:** The name attribute is the unique identifier for the customization specification per vCenter Server instance.
+
+    ## Example Usage
+
+    <!--Start PulumiCodeChooser -->
+    ```python
+    import pulumi
+    import pulumi_vsphere as vsphere
+
+    gosc1 = vsphere.get_guest_os_customization(name="linux-spec")
+    ```
+    <!--End PulumiCodeChooser -->
 
 
-    :param str name: The name of the customization specification is the unique
-           identifier per vCenter Server instance. ## Attribute Reference
+    :param str name: The name of the customization specification is the unique identifier per vCenter Server instance.
     """
     __args__ = dict()
     __args__['name'] = name
@@ -128,11 +155,23 @@ def get_guest_os_customization(name: Optional[str] = None,
 def get_guest_os_customization_output(name: Optional[pulumi.Input[str]] = None,
                                       opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetGuestOsCustomizationResult]:
     """
-    The `GuestOsCustomization` data source can be used to discover the
-    details about a customization specification for a guest operating system.
+    The `GuestOsCustomization` data source can be used to discover the details about a customization specification for a guest operating system.
+
+    Suggested change
+    > **NOTE:** The name attribute is the unique identifier for the customization specification per vCenter Server instance.
+
+    ## Example Usage
+
+    <!--Start PulumiCodeChooser -->
+    ```python
+    import pulumi
+    import pulumi_vsphere as vsphere
+
+    gosc1 = vsphere.get_guest_os_customization(name="linux-spec")
+    ```
+    <!--End PulumiCodeChooser -->
 
 
-    :param str name: The name of the customization specification is the unique
-           identifier per vCenter Server instance. ## Attribute Reference
+    :param str name: The name of the customization specification is the unique identifier per vCenter Server instance.
     """
     ...

pulumi_vsphere/get_host.py

@@ -85,6 +85,7 @@ def get_host(datacenter_id: Optional[str] = None,
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -93,6 +94,7 @@ def get_host(datacenter_id: Optional[str] = None,
     host = vsphere.get_host(name="esxi-01.example.com",
         datacenter_id=datacenter.id)
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param str datacenter_id: The managed object reference ID
@@ -127,6 +129,7 @@ def get_host_output(datacenter_id: Optional[pulumi.Input[str]] = None,
 
     ## Example Usage
 
+    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -135,6 +138,7 @@ def get_host_output(datacenter_id: Optional[pulumi.Input[str]] = None,
     host = vsphere.get_host(name="esxi-01.example.com",
         datacenter_id=datacenter.id)
     ```
+    <!--End PulumiCodeChooser -->
 
 
     :param str datacenter_id: The managed object reference ID