pulumi-vsphere 4.10.3a1723624830__py3-none-any.whl → 4.11.0a1__py3-none-any.whl

pulumi_vsphere/get_dynamic.py

@@ -78,10 +78,9 @@ 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
 
@@ -105,11 +104,11 @@ def get_dynamic(filters: Optional[Sequence[str]] = None,
 
     :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,10 +132,9 @@ 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
 
@@ -160,10 +158,10 @@ def get_dynamic_output(filters: Optional[pulumi.Input[Sequence[str]]] = None,
 
     :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_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,22 @@ 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
+
+    ```python
+    import pulumi
+    import pulumi_vsphere as vsphere
+
+    gosc1 = vsphere.get_guest_os_customization(name="linux-spec")
+    ```
 
 
-    :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 +153,21 @@ 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
+
+    ```python
+    import pulumi
+    import pulumi_vsphere as vsphere
+
+    gosc1 = vsphere.get_guest_os_customization(name="linux-spec")
+    ```
 
 
-    :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_base_images.py

@@ -58,8 +58,8 @@ class AwaitableGetHostBaseImagesResult(GetHostBaseImagesResult):
 
 def get_host_base_images(opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetHostBaseImagesResult:
     """
-    The `get_host_base_images` data source can be used to get the list of ESXi
-    base images available for cluster software management.
+    The `get_host_base_images` data source can be used to get the list of ESXi base images available
+    for cluster software management.
 
     ## Example Usage
 
@@ -67,7 +67,7 @@ def get_host_base_images(opts: Optional[pulumi.InvokeOptions] = None) -> Awaitab
     import pulumi
     import pulumi_vsphere as vsphere
 
-    base_images = vsphere.get_host_base_images()
+    baseimages = vsphere.get_host_base_images()
     ```
     """
     __args__ = dict()
@@ -82,8 +82,8 @@ def get_host_base_images(opts: Optional[pulumi.InvokeOptions] = None) -> Awaitab
 @_utilities.lift_output_func(get_host_base_images)
 def get_host_base_images_output(opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetHostBaseImagesResult]:
     """
-    The `get_host_base_images` data source can be used to get the list of ESXi
-    base images available for cluster software management.
+    The `get_host_base_images` data source can be used to get the list of ESXi base images available
+    for cluster software management.
 
     ## Example Usage
 
@@ -91,7 +91,7 @@ def get_host_base_images_output(opts: Optional[pulumi.InvokeOptions] = None) ->
     import pulumi
     import pulumi_vsphere as vsphere
 
-    base_images = vsphere.get_host_base_images()
+    baseimages = vsphere.get_host_base_images()
     ```
     """
     ...

pulumi_vsphere/get_host_pci_device.py

@@ -137,8 +137,7 @@ def get_host_pci_device(class_id: Optional[str] = None,
            [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
            
            > **NOTE:** `name_regex`, `vendor_id`, and `class_id` can all be used together.
-    :param str host_id: The [managed object reference ID][docs-about-morefs] of
-           a host.
+    :param str host_id: The [managed object reference ID][docs-about-morefs] of a host.
     :param str name_regex: A regular expression that will be used to match the
            host PCI device name.
     :param str vendor_id: The hexadecimal PCI device vendor ID.
@@ -206,8 +205,7 @@ def get_host_pci_device_output(class_id: Optional[pulumi.Input[Optional[str]]] =
            [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
            
            > **NOTE:** `name_regex`, `vendor_id`, and `class_id` can all be used together.
-    :param str host_id: The [managed object reference ID][docs-about-morefs] of
-           a host.
+    :param str host_id: The [managed object reference ID][docs-about-morefs] of a host.
     :param str name_regex: A regular expression that will be used to match the
            host PCI device name.
     :param str vendor_id: The hexadecimal PCI device vendor ID.

pulumi_vsphere/get_host_thumbprint.py

@@ -76,10 +76,10 @@ def get_host_thumbprint(address: Optional[str] = None,
                         port: Optional[str] = None,
                         opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetHostThumbprintResult:
     """
-    The `vsphere_thumbprint` data source can be used to discover the host thumbprint
-    of an ESXi host. This can be used when adding the `Host` resource. If
-    the ESXi host is using a certificate chain, the first one returned will be used
-    to generate the thumbprint.
+    The `vsphere_thumbprint` data source can be used to discover the host
+    thumbprint of an ESXi host. This can be used when adding the `Host`
+    resource. If the ESXi host is using a certificate chain, the first one returned
+    will be used to generate the thumbprint.
 
     ## Example Usage
 
@@ -91,8 +91,8 @@ def get_host_thumbprint(address: Optional[str] = None,
     ```
 
 
-    :param str address: The address of the ESXi host to retrieve the thumbprint
-           from.
+    :param str address: The address of the ESXi host to retrieve the
+           thumbprint from.
     :param bool insecure: Disables SSL certificate verification.
            Default: `false`
     :param str port: The port to use connecting to the ESXi host. Default: 443
@@ -117,10 +117,10 @@ def get_host_thumbprint_output(address: Optional[pulumi.Input[str]] = None,
                                port: Optional[pulumi.Input[Optional[str]]] = None,
                                opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetHostThumbprintResult]:
     """
-    The `vsphere_thumbprint` data source can be used to discover the host thumbprint
-    of an ESXi host. This can be used when adding the `Host` resource. If
-    the ESXi host is using a certificate chain, the first one returned will be used
-    to generate the thumbprint.
+    The `vsphere_thumbprint` data source can be used to discover the host
+    thumbprint of an ESXi host. This can be used when adding the `Host`
+    resource. If the ESXi host is using a certificate chain, the first one returned
+    will be used to generate the thumbprint.
 
     ## Example Usage
 
@@ -132,8 +132,8 @@ def get_host_thumbprint_output(address: Optional[pulumi.Input[str]] = None,
     ```
 
 
-    :param str address: The address of the ESXi host to retrieve the thumbprint
-           from.
+    :param str address: The address of the ESXi host to retrieve the
+           thumbprint from.
     :param bool insecure: Disables SSL certificate verification.
            Default: `false`
     :param str port: The port to use connecting to the ESXi host. Default: 443

pulumi_vsphere/get_host_vgpu_profile.py

@@ -118,8 +118,7 @@ def get_host_vgpu_profile(host_id: Optional[str] = None,
     ```
 
 
-    :param str host_id: The [managed object reference ID][docs-about-morefs] of
-           a host.
+    :param str host_id: The [managed object reference ID][docs-about-morefs] of a host.
     :param str name_regex: A regular expression that will be used to match the
            host vGPU profile name.
            
@@ -174,8 +173,7 @@ def get_host_vgpu_profile_output(host_id: Optional[pulumi.Input[str]] = None,
     ```
 
 
-    :param str host_id: The [managed object reference ID][docs-about-morefs] of
-           a host.
+    :param str host_id: The [managed object reference ID][docs-about-morefs] of a host.
     :param str name_regex: A regular expression that will be used to match the
            host vGPU profile name.
            

pulumi_vsphere/get_license.py

@@ -61,8 +61,7 @@ class GetLicenseResult:
     @pulumi.getter
     def labels(self) -> Mapping[str, str]:
         """
-        A map of key/value pairs attached as labels (tags) to the license
-        key.
+        A map of key/value pairs attached as labels (tags) to the license key.
         """
         return pulumi.get(self, "labels")
 

pulumi_vsphere/get_network.py

@@ -91,11 +91,11 @@ def get_network(datacenter_id: Optional[str] = None,
                 name: Optional[str] = None,
                 opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetNetworkResult:
     """
-    The `get_network` data source can be used to discover the ID of a network in
-    vSphere. This can be any network that can be used as the backing for a network
-    interface for `VirtualMachine` or any other vSphere resource that
-    requires a network. This includes standard (host-based) port groups, distributed
-    port groups, or opaque networks such as those managed by NSX.
+    The `get_network` data source can be used to discover the ID of a network
+    in vSphere. This can be any network that can be used as the backing for a
+    network interface for `VirtualMachine` or any other vSphere resource
+    that requires a network. This includes standard (host-based) port groups,
+    distributed port groups, or opaque networks such as those managed by NSX.
 
     ## Example Usage
 
@@ -115,8 +115,8 @@ def get_network(datacenter_id: Optional[str] = None,
            use the `id` attribute from an empty `Datacenter` data source.
     :param str distributed_virtual_switch_uuid: For distributed port group type
            network objects, the ID of the distributed virtual switch for which the port
-           group belongs. It is useful to differentiate port groups with same name using
-           the distributed virtual switch ID.
+           group belongs. It is useful to differentiate port groups with same name
+           using the distributed virtual switch ID.
     :param str name: The name of the network. This can be a name or path.
     """
     __args__ = dict()
@@ -140,11 +140,11 @@ def get_network_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] = No
                        name: Optional[pulumi.Input[str]] = None,
                        opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetNetworkResult]:
     """
-    The `get_network` data source can be used to discover the ID of a network in
-    vSphere. This can be any network that can be used as the backing for a network
-    interface for `VirtualMachine` or any other vSphere resource that
-    requires a network. This includes standard (host-based) port groups, distributed
-    port groups, or opaque networks such as those managed by NSX.
+    The `get_network` data source can be used to discover the ID of a network
+    in vSphere. This can be any network that can be used as the backing for a
+    network interface for `VirtualMachine` or any other vSphere resource
+    that requires a network. This includes standard (host-based) port groups,
+    distributed port groups, or opaque networks such as those managed by NSX.
 
     ## Example Usage
 
@@ -164,8 +164,8 @@ def get_network_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] = No
            use the `id` attribute from an empty `Datacenter` data source.
     :param str distributed_virtual_switch_uuid: For distributed port group type
            network objects, the ID of the distributed virtual switch for which the port
-           group belongs. It is useful to differentiate port groups with same name using
-           the distributed virtual switch ID.
+           group belongs. It is useful to differentiate port groups with same name
+           using the distributed virtual switch ID.
     :param str name: The name of the network. This can be a name or path.
     """
     ...

pulumi_vsphere/get_resource_pool.py

@@ -89,8 +89,8 @@ def get_resource_pool(datacenter_id: Optional[str] = None,
     data source.
 
     All compute resources in vSphere have a resource pool, even if one has not been
-    explicitly created. This resource pool is referred to as the _root resource
-    pool_ and can be looked up by specifying the path.
+    explicitly created. This resource pool is referred to as the
+    _root resource pool_ and can be looked up by specifying the path.
 
     ```python
     import pulumi
@@ -100,11 +100,9 @@ def get_resource_pool(datacenter_id: Optional[str] = None,
         datacenter_id=datacenter["id"])
     ```
 
-    For more information on the root resource pool, see
-    [Managing Resource Pools][vmware-docs-resource-pools] in the vSphere
-    documentation.
+    For more information on the root resource pool, see [Managing Resource Pools][vmware-docs-resource-pools] in the vSphere documentation.
 
-    [vmware-docs-resource-pools]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-resource-management/GUID-60077B40-66FF-4625-934A-641703ED7601.html
+    [vmware-docs-resource-pools]: https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.resmgmt.doc/GUID-60077B40-66FF-4625-934A-641703ED7601.html
 
 
     :param str datacenter_id: The managed object reference ID
@@ -159,8 +157,8 @@ def get_resource_pool_output(datacenter_id: Optional[pulumi.Input[Optional[str]]
     data source.
 
     All compute resources in vSphere have a resource pool, even if one has not been
-    explicitly created. This resource pool is referred to as the _root resource
-    pool_ and can be looked up by specifying the path.
+    explicitly created. This resource pool is referred to as the
+    _root resource pool_ and can be looked up by specifying the path.
 
     ```python
     import pulumi
@@ -170,11 +168,9 @@ def get_resource_pool_output(datacenter_id: Optional[pulumi.Input[Optional[str]]
         datacenter_id=datacenter["id"])
     ```
 
-    For more information on the root resource pool, see
-    [Managing Resource Pools][vmware-docs-resource-pools] in the vSphere
-    documentation.
+    For more information on the root resource pool, see [Managing Resource Pools][vmware-docs-resource-pools] in the vSphere documentation.
 
-    [vmware-docs-resource-pools]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-resource-management/GUID-60077B40-66FF-4625-934A-641703ED7601.html
+    [vmware-docs-resource-pools]: https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.resmgmt.doc/GUID-60077B40-66FF-4625-934A-641703ED7601.html
 
 
     :param str datacenter_id: The managed object reference ID

pulumi_vsphere/get_role.py

@@ -95,8 +95,8 @@ def get_role(description: Optional[str] = None,
              role_privileges: Optional[Sequence[str]] = None,
              opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetRoleResult:
     """
-    The `Role` data source can be used to discover the `id` and privileges
-    associated with a role given its name or display label.
+    The `Role` data source can be used to discover the `id` and privileges associated
+    with a role given its name or display label.
 
     ## Example Usage
 
@@ -135,8 +135,8 @@ def get_role_output(description: Optional[pulumi.Input[Optional[str]]] = None,
                     role_privileges: Optional[pulumi.Input[Optional[Sequence[str]]]] = None,
                     opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetRoleResult]:
     """
-    The `Role` data source can be used to discover the `id` and privileges
-    associated with a role given its name or display label.
+    The `Role` data source can be used to discover the `id` and privileges associated
+    with a role given its name or display label.
 
     ## Example Usage