pulumi-vsphere 4.10.0a1710160860__py3-none-any.whl → 4.13.0a1736836157__py3-none-any.whl

pulumi_vsphere/get_host_pci_device.py

@@ -4,9 +4,14 @@
 
 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__ = [
@@ -106,7 +111,6 @@ def get_host_pci_device(class_id: Optional[str] = None,
 
     ### With Vendor ID And Class ID
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -118,22 +122,19 @@ def get_host_pci_device(class_id: Optional[str] = None,
         class_id="123",
         vendor_id="456")
     ```
-    <!--End PulumiCodeChooser -->
 
     ### With Name Regular Expression
 
-     <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     datacenter = vsphere.get_datacenter(name="dc-01")
     host = vsphere.get_host(name="esxi-01.example.com",
-        datacenter_id=datacenter.id)
+       datacenter_id=datacenter.id)
     dev = vsphere.get_host_pci_device(host_id=host.id,
-        name_regex="MMC")
+       name_regex="MMC")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str class_id: The hexadecimal PCI device class ID
@@ -141,7 +142,8 @@ 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.
@@ -161,14 +163,11 @@ def get_host_pci_device(class_id: Optional[str] = None,
         name=pulumi.get(__ret__, 'name'),
         name_regex=pulumi.get(__ret__, 'name_regex'),
         vendor_id=pulumi.get(__ret__, 'vendor_id'))
-
-
-@_utilities.lift_output_func(get_host_pci_device)
 def get_host_pci_device_output(class_id: Optional[pulumi.Input[Optional[str]]] = None,
                                host_id: Optional[pulumi.Input[str]] = None,
                                name_regex: Optional[pulumi.Input[Optional[str]]] = None,
                                vendor_id: Optional[pulumi.Input[Optional[str]]] = None,
-                               opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetHostPciDeviceResult]:
+                               opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetHostPciDeviceResult]:
     """
     The `get_host_pci_device` data source can be used to discover the device ID
     of a vSphere host's PCI device. This can then be used with
@@ -178,7 +177,6 @@ def get_host_pci_device_output(class_id: Optional[pulumi.Input[Optional[str]]] =
 
     ### With Vendor ID And Class ID
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -190,22 +188,19 @@ def get_host_pci_device_output(class_id: Optional[pulumi.Input[Optional[str]]] =
         class_id="123",
         vendor_id="456")
     ```
-    <!--End PulumiCodeChooser -->
 
     ### With Name Regular Expression
 
-     <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     datacenter = vsphere.get_datacenter(name="dc-01")
     host = vsphere.get_host(name="esxi-01.example.com",
-        datacenter_id=datacenter.id)
+       datacenter_id=datacenter.id)
     dev = vsphere.get_host_pci_device(host_id=host.id,
-        name_regex="MMC")
+       name_regex="MMC")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str class_id: The hexadecimal PCI device class ID
@@ -213,9 +208,23 @@ 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.
     """
-    ...
+    __args__ = dict()
+    __args__['classId'] = class_id
+    __args__['hostId'] = host_id
+    __args__['nameRegex'] = name_regex
+    __args__['vendorId'] = vendor_id
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('vsphere:index/getHostPciDevice:getHostPciDevice', __args__, opts=opts, typ=GetHostPciDeviceResult)
+    return __ret__.apply(lambda __response__: GetHostPciDeviceResult(
+        class_id=pulumi.get(__response__, 'class_id'),
+        host_id=pulumi.get(__response__, 'host_id'),
+        id=pulumi.get(__response__, 'id'),
+        name=pulumi.get(__response__, 'name'),
+        name_regex=pulumi.get(__response__, 'name_regex'),
+        vendor_id=pulumi.get(__response__, 'vendor_id')))

pulumi_vsphere/get_host_thumbprint.py

@@ -4,9 +4,14 @@
 
 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__ = [
@@ -76,27 +81,29 @@ 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 to a
+    cluster or a vCenter Server instance.
+
+    * If the ESXi host is using a certificate chain, the first one returned will be
+    used to generate the thumbprint.
+
+    * If the ESXi host has a certificate issued by a certificate authority, ensure
+    that the the certificate authority is trusted on the system running the plan.
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     thumbprint = vsphere.get_host_thumbprint(address="esxi-01.example.com")
     ```
-    <!--End PulumiCodeChooser -->
 
 
-    :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 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
     """
     __args__ = dict()
@@ -111,35 +118,44 @@ def get_host_thumbprint(address: Optional[str] = None,
         id=pulumi.get(__ret__, 'id'),
         insecure=pulumi.get(__ret__, 'insecure'),
         port=pulumi.get(__ret__, 'port'))
-
-
-@_utilities.lift_output_func(get_host_thumbprint)
 def get_host_thumbprint_output(address: Optional[pulumi.Input[str]] = None,
                                insecure: Optional[pulumi.Input[Optional[bool]]] = None,
                                port: Optional[pulumi.Input[Optional[str]]] = None,
-                               opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetHostThumbprintResult]:
+                               opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = 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 to a
+    cluster or a vCenter Server instance.
+
+    * If the ESXi host is using a certificate chain, the first one returned will be
+    used to generate the thumbprint.
+
+    * If the ESXi host has a certificate issued by a certificate authority, ensure
+    that the the certificate authority is trusted on the system running the plan.
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     thumbprint = vsphere.get_host_thumbprint(address="esxi-01.example.com")
     ```
-    <!--End PulumiCodeChooser -->
 
 
-    :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 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
     """
-    ...
+    __args__ = dict()
+    __args__['address'] = address
+    __args__['insecure'] = insecure
+    __args__['port'] = port
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('vsphere:index/getHostThumbprint:getHostThumbprint', __args__, opts=opts, typ=GetHostThumbprintResult)
+    return __ret__.apply(lambda __response__: GetHostThumbprintResult(
+        address=pulumi.get(__response__, 'address'),
+        id=pulumi.get(__response__, 'id'),
+        insecure=pulumi.get(__response__, 'insecure'),
+        port=pulumi.get(__response__, 'port')))

pulumi_vsphere/get_host_vgpu_profile.py

@@ -0,0 +1,195 @@
+# coding=utf-8
+# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+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
+
+__all__ = [
+    'GetHostVgpuProfileResult',
+    'AwaitableGetHostVgpuProfileResult',
+    'get_host_vgpu_profile',
+    'get_host_vgpu_profile_output',
+]
+
+@pulumi.output_type
+class GetHostVgpuProfileResult:
+    """
+    A collection of values returned by getHostVgpuProfile.
+    """
+    def __init__(__self__, host_id=None, id=None, name_regex=None, vgpu_profiles=None):
+        if host_id and not isinstance(host_id, str):
+            raise TypeError("Expected argument 'host_id' to be a str")
+        pulumi.set(__self__, "host_id", host_id)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if name_regex and not isinstance(name_regex, str):
+            raise TypeError("Expected argument 'name_regex' to be a str")
+        pulumi.set(__self__, "name_regex", name_regex)
+        if vgpu_profiles and not isinstance(vgpu_profiles, list):
+            raise TypeError("Expected argument 'vgpu_profiles' to be a list")
+        pulumi.set(__self__, "vgpu_profiles", vgpu_profiles)
+
+    @property
+    @pulumi.getter(name="hostId")
+    def host_id(self) -> str:
+        """
+        The [managed objectID][docs-about-morefs] of the ESXi host.
+        """
+        return pulumi.get(self, "host_id")
+
+    @property
+    @pulumi.getter
+    def id(self) -> str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter(name="nameRegex")
+    def name_regex(self) -> Optional[str]:
+        """
+        (Optional) A regular expression that will be used to match the
+        host vGPU profile name.
+        """
+        return pulumi.get(self, "name_regex")
+
+    @property
+    @pulumi.getter(name="vgpuProfiles")
+    def vgpu_profiles(self) -> Sequence['outputs.GetHostVgpuProfileVgpuProfileResult']:
+        """
+        The list of available vGPU profiles on the ESXi host.
+        This may be and empty array if no vGPU profile are identified.
+        """
+        return pulumi.get(self, "vgpu_profiles")
+
+
+class AwaitableGetHostVgpuProfileResult(GetHostVgpuProfileResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetHostVgpuProfileResult(
+            host_id=self.host_id,
+            id=self.id,
+            name_regex=self.name_regex,
+            vgpu_profiles=self.vgpu_profiles)
+
+
+def get_host_vgpu_profile(host_id: Optional[str] = None,
+                          name_regex: Optional[str] = None,
+                          opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetHostVgpuProfileResult:
+    """
+    The `get_host_vgpu_profile` data source can be used to discover the
+    available vGPU profiles of a vSphere host.
+
+    ## Example Usage
+
+    ### To Return All VGPU Profiles
+
+    ```python
+    import pulumi
+    import pulumi_vsphere as vsphere
+
+    datacenter = vsphere.get_datacenter(name="dc-01")
+    host = vsphere.get_host(name="esxi-01.example.com",
+        datacenter_id=datacenter.id)
+    vgpu_profile = vsphere.get_host_vgpu_profile(host_id=host.id)
+    ```
+
+    ### With VGPU Profile Name_regex
+
+    ```python
+    import pulumi
+    import pulumi_vsphere as vsphere
+
+    datacenter = vsphere.get_datacenter(name="dc-01")
+    host = vsphere.get_host(name="esxi-01.example.com",
+        datacenter_id=datacenter.id)
+    vgpu_profile = vsphere.get_host_vgpu_profile(host_id=host.id,
+        name_regex="a100")
+    ```
+
+
+    :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.
+           
+           [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
+    """
+    __args__ = dict()
+    __args__['hostId'] = host_id
+    __args__['nameRegex'] = name_regex
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('vsphere:index/getHostVgpuProfile:getHostVgpuProfile', __args__, opts=opts, typ=GetHostVgpuProfileResult).value
+
+    return AwaitableGetHostVgpuProfileResult(
+        host_id=pulumi.get(__ret__, 'host_id'),
+        id=pulumi.get(__ret__, 'id'),
+        name_regex=pulumi.get(__ret__, 'name_regex'),
+        vgpu_profiles=pulumi.get(__ret__, 'vgpu_profiles'))
+def get_host_vgpu_profile_output(host_id: Optional[pulumi.Input[str]] = None,
+                                 name_regex: Optional[pulumi.Input[Optional[str]]] = None,
+                                 opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetHostVgpuProfileResult]:
+    """
+    The `get_host_vgpu_profile` data source can be used to discover the
+    available vGPU profiles of a vSphere host.
+
+    ## Example Usage
+
+    ### To Return All VGPU Profiles
+
+    ```python
+    import pulumi
+    import pulumi_vsphere as vsphere
+
+    datacenter = vsphere.get_datacenter(name="dc-01")
+    host = vsphere.get_host(name="esxi-01.example.com",
+        datacenter_id=datacenter.id)
+    vgpu_profile = vsphere.get_host_vgpu_profile(host_id=host.id)
+    ```
+
+    ### With VGPU Profile Name_regex
+
+    ```python
+    import pulumi
+    import pulumi_vsphere as vsphere
+
+    datacenter = vsphere.get_datacenter(name="dc-01")
+    host = vsphere.get_host(name="esxi-01.example.com",
+        datacenter_id=datacenter.id)
+    vgpu_profile = vsphere.get_host_vgpu_profile(host_id=host.id,
+        name_regex="a100")
+    ```
+
+
+    :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.
+           
+           [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
+    """
+    __args__ = dict()
+    __args__['hostId'] = host_id
+    __args__['nameRegex'] = name_regex
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('vsphere:index/getHostVgpuProfile:getHostVgpuProfile', __args__, opts=opts, typ=GetHostVgpuProfileResult)
+    return __ret__.apply(lambda __response__: GetHostVgpuProfileResult(
+        host_id=pulumi.get(__response__, 'host_id'),
+        id=pulumi.get(__response__, 'id'),
+        name_regex=pulumi.get(__response__, 'name_regex'),
+        vgpu_profiles=pulumi.get(__response__, 'vgpu_profiles')))

pulumi_vsphere/get_license.py

@@ -4,9 +4,14 @@
 
 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__ = [
@@ -61,7 +66,8 @@ 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")
 
@@ -118,14 +124,12 @@ def get_license(license_key: Optional[str] = None,
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     license = vsphere.get_license(license_key="00000-00000-00000-00000-00000")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str license_key: The license key.
@@ -143,27 +147,33 @@ def get_license(license_key: Optional[str] = None,
         name=pulumi.get(__ret__, 'name'),
         total=pulumi.get(__ret__, 'total'),
         used=pulumi.get(__ret__, 'used'))
-
-
-@_utilities.lift_output_func(get_license)
 def get_license_output(license_key: Optional[pulumi.Input[str]] = None,
-                       opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetLicenseResult]:
+                       opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetLicenseResult]:
     """
     The `License` data source can be used to get the general attributes of
     a license keys from a vCenter Server instance.
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     license = vsphere.get_license(license_key="00000-00000-00000-00000-00000")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str license_key: The license key.
     """
-    ...
+    __args__ = dict()
+    __args__['licenseKey'] = license_key
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('vsphere:index/getLicense:getLicense', __args__, opts=opts, typ=GetLicenseResult)
+    return __ret__.apply(lambda __response__: GetLicenseResult(
+        edition_key=pulumi.get(__response__, 'edition_key'),
+        id=pulumi.get(__response__, 'id'),
+        labels=pulumi.get(__response__, 'labels'),
+        license_key=pulumi.get(__response__, 'license_key'),
+        name=pulumi.get(__response__, 'name'),
+        total=pulumi.get(__response__, 'total'),
+        used=pulumi.get(__response__, 'used')))