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

pulumi_vsphere/get_host_pci_device.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__ = [
@@ -41,40 +46,40 @@ class GetHostPciDeviceResult:
             raise TypeError("Expected argument 'vendor_id' to be a str")
         pulumi.set(__self__, "vendor_id", vendor_id)
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="classId")
-    def class_id(self) -> Optional[str]:
+    def class_id(self) -> Optional[_builtins.str]:
         return pulumi.get(self, "class_id")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="hostId")
-    def host_id(self) -> str:
+    def host_id(self) -> _builtins.str:
         return pulumi.get(self, "host_id")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def id(self) -> str:
+    def id(self) -> _builtins.str:
         """
         The provider-assigned unique ID for this managed resource.
         """
         return pulumi.get(self, "id")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def name(self) -> str:
+    def name(self) -> _builtins.str:
         """
         The name of the PCI device.
         """
         return pulumi.get(self, "name")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="nameRegex")
-    def name_regex(self) -> Optional[str]:
+    def name_regex(self) -> Optional[_builtins.str]:
         return pulumi.get(self, "name_regex")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="vendorId")
-    def vendor_id(self) -> Optional[str]:
+    def vendor_id(self) -> Optional[_builtins.str]:
         return pulumi.get(self, "vendor_id")
 
 
@@ -92,10 +97,10 @@ class AwaitableGetHostPciDeviceResult(GetHostPciDeviceResult):
             vendor_id=self.vendor_id)
 
 
-def get_host_pci_device(class_id: Optional[str] = None,
-                        host_id: Optional[str] = None,
-                        name_regex: Optional[str] = None,
-                        vendor_id: Optional[str] = None,
+def get_host_pci_device(class_id: Optional[_builtins.str] = None,
+                        host_id: Optional[_builtins.str] = None,
+                        name_regex: Optional[_builtins.str] = None,
+                        vendor_id: Optional[_builtins.str] = None,
                         opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetHostPciDeviceResult:
     """
     The `get_host_pci_device` data source can be used to discover the device ID
@@ -103,6 +108,7 @@ def get_host_pci_device(class_id: Optional[str] = None,
     `VirtualMachine`'s `pci_device_id`.
 
     ## Example Usage
+
     ### With Vendor ID And Class ID
 
     ```python
@@ -116,18 +122,31 @@ def get_host_pci_device(class_id: Optional[str] = None,
         class_id="123",
         vendor_id="456")
     ```
+
     ### With Name Regular Expression
 
+    ```python
+    import pulumi
+    import pulumi_vsphere as vsphere
 
-    :param str class_id: The hexadecimal PCI device class ID
+    datacenter = vsphere.get_datacenter(name="dc-01")
+    host = vsphere.get_host(name="esxi-01.example.com",
+       datacenter_id=datacenter.id)
+    dev = vsphere.get_host_pci_device(host_id=host.id,
+       name_regex="MMC")
+    ```
+
+
+    :param _builtins.str class_id: The hexadecimal PCI device class ID
            
            [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 name_regex: A regular expression that will be used to match the
+    :param _builtins.str host_id: The [managed object reference ID][docs-about-morefs] of
+           a host.
+    :param _builtins.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.
+    :param _builtins.str vendor_id: The hexadecimal PCI device vendor ID.
     """
     __args__ = dict()
     __args__['classId'] = class_id
@@ -144,20 +163,18 @@ 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]:
+def get_host_pci_device_output(class_id: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+                               host_id: Optional[pulumi.Input[_builtins.str]] = None,
+                               name_regex: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+                               vendor_id: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+                               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
     `VirtualMachine`'s `pci_device_id`.
 
     ## Example Usage
+
     ### With Vendor ID And Class ID
 
     ```python
@@ -171,17 +188,43 @@ def get_host_pci_device_output(class_id: Optional[pulumi.Input[Optional[str]]] =
         class_id="123",
         vendor_id="456")
     ```
+
     ### With Name Regular Expression
 
+    ```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)
+    dev = vsphere.get_host_pci_device(host_id=host.id,
+       name_regex="MMC")
+    ```
+
 
-    :param str class_id: The hexadecimal PCI device class ID
+    :param _builtins.str class_id: The hexadecimal PCI device class ID
            
            [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 name_regex: A regular expression that will be used to match the
+    :param _builtins.str host_id: The [managed object reference ID][docs-about-morefs] of
+           a host.
+    :param _builtins.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.
+    :param _builtins.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

@@ -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__ = [
@@ -35,27 +40,27 @@ class GetHostThumbprintResult:
             raise TypeError("Expected argument 'port' to be a str")
         pulumi.set(__self__, "port", port)
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def address(self) -> str:
+    def address(self) -> _builtins.str:
         return pulumi.get(self, "address")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def id(self) -> str:
+    def id(self) -> _builtins.str:
         """
         The provider-assigned unique ID for this managed resource.
         """
         return pulumi.get(self, "id")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def insecure(self) -> Optional[bool]:
+    def insecure(self) -> Optional[_builtins.bool]:
         return pulumi.get(self, "insecure")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def port(self) -> Optional[str]:
+    def port(self) -> Optional[_builtins.str]:
         return pulumi.get(self, "port")
 
 
@@ -71,15 +76,20 @@ class AwaitableGetHostThumbprintResult(GetHostThumbprintResult):
             port=self.port)
 
 
-def get_host_thumbprint(address: Optional[str] = None,
-                        insecure: Optional[bool] = None,
-                        port: Optional[str] = None,
+def get_host_thumbprint(address: Optional[_builtins.str] = None,
+                        insecure: Optional[_builtins.bool] = None,
+                        port: Optional[_builtins.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
 
@@ -91,11 +101,10 @@ def get_host_thumbprint(address: Optional[str] = None,
     ```
 
 
-    :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
+    :param _builtins.str address: The address of the ESXi host to retrieve the thumbprint
+           from.
+    :param _builtins.bool insecure: Disables SSL certificate verification. Default: `false`
+    :param _builtins.str port: The port to use connecting to the ESXi host. Default: 443
     """
     __args__ = dict()
     __args__['address'] = address
@@ -109,18 +118,20 @@ def get_host_thumbprint(address: Optional[str] = None,
         id=pulumi.get(__ret__, 'id'),
         insecure=pulumi.get(__ret__, 'insecure'),
         port=pulumi.get(__ret__, 'port'))
+def get_host_thumbprint_output(address: Optional[pulumi.Input[_builtins.str]] = None,
+                               insecure: Optional[pulumi.Input[Optional[_builtins.bool]]] = None,
+                               port: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+                               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 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.
 
-@_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]:
-    """
-    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.
+    * 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
 
@@ -132,10 +143,19 @@ 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 bool insecure: Disables SSL certificate verification.
-           Default: `false`
-    :param str port: The port to use connecting to the ESXi host. Default: 443
+    :param _builtins.str address: The address of the ESXi host to retrieve the thumbprint
+           from.
+    :param _builtins.bool insecure: Disables SSL certificate verification. Default: `false`
+    :param _builtins.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 pulumi-language-python. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+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
+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)
+
+    @_builtins.property
+    @pulumi.getter(name="hostId")
+    def host_id(self) -> _builtins.str:
+        """
+        The [managed objectID][docs-about-morefs] of the ESXi host.
+        """
+        return pulumi.get(self, "host_id")
+
+    @_builtins.property
+    @pulumi.getter
+    def id(self) -> _builtins.str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @_builtins.property
+    @pulumi.getter(name="nameRegex")
+    def name_regex(self) -> Optional[_builtins.str]:
+        """
+        (Optional) A regular expression that will be used to match the
+        host vGPU profile name.
+        """
+        return pulumi.get(self, "name_regex")
+
+    @_builtins.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[_builtins.str] = None,
+                          name_regex: Optional[_builtins.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 _builtins.str host_id: The [managed object reference ID][docs-about-morefs] of
+           a host.
+    :param _builtins.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[_builtins.str]] = None,
+                                 name_regex: Optional[pulumi.Input[Optional[_builtins.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 _builtins.str host_id: The [managed object reference ID][docs-about-morefs] of
+           a host.
+    :param _builtins.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')))