pulumi-vsphere 4.10.0a1710160860__py3-none-any.whl → 4.10.1__py3-none-any.whl

pulumi_vsphere/get_dynamic.py

@@ -84,16 +84,15 @@ def get_dynamic(filters: Optional[Sequence[str]] = None,
 
     ## 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=data["vsphere_tag_category"]["cat"]["id"])
+        category_id=cat["id"])
     tag2 = vsphere.get_tag(name="SecondTag",
-        category_id=data["vsphere_tag_category"]["cat"]["id"])
+        category_id=cat["id"])
     dyn = vsphere.get_dynamic(filters=[
             tag1.id,
             tag1.id,
@@ -101,7 +100,6 @@ 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
@@ -140,16 +138,15 @@ def get_dynamic_output(filters: Optional[pulumi.Input[Sequence[str]]] = None,
 
     ## 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=data["vsphere_tag_category"]["cat"]["id"])
+        category_id=cat["id"])
     tag2 = vsphere.get_tag(name="SecondTag",
-        category_id=data["vsphere_tag_category"]["cat"]["id"])
+        category_id=cat["id"])
     dyn = vsphere.get_dynamic(filters=[
             tag1.id,
             tag1.id,
@@ -157,7 +154,6 @@ 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

pulumi_vsphere/get_folder.py

@@ -61,14 +61,12 @@ def get_folder(path: Optional[str] = None,
 
     ## 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
@@ -96,14 +94,12 @@ def get_folder_output(path: Optional[pulumi.Input[str]] = None,
 
     ## 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

@@ -124,14 +124,12 @@ def get_guest_os_customization(name: Optional[str] = None,
 
     ## 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.
@@ -162,14 +160,12 @@ def get_guest_os_customization_output(name: Optional[pulumi.Input[str]] = None,
 
     ## 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.

pulumi_vsphere/get_host.py

@@ -85,7 +85,6 @@ def get_host(datacenter_id: Optional[str] = None,
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -94,7 +93,6 @@ 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
@@ -129,7 +127,6 @@ def get_host_output(datacenter_id: Optional[pulumi.Input[str]] = None,
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -138,7 +135,6 @@ 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

pulumi_vsphere/get_host_pci_device.py

@@ -106,7 +106,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 +117,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
@@ -178,7 +174,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 +185,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

pulumi_vsphere/get_host_thumbprint.py

@@ -83,14 +83,12 @@ def get_host_thumbprint(address: Optional[str] = None,
 
     ## 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
@@ -126,14 +124,12 @@ def get_host_thumbprint_output(address: Optional[pulumi.Input[str]] = None,
 
     ## 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

pulumi_vsphere/get_host_vgpu_profile.py

@@ -0,0 +1,182 @@
+# 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 pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+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'))
+
+
+@_utilities.lift_output_func(get_host_vgpu_profile)
+def get_host_vgpu_profile_output(host_id: Optional[pulumi.Input[str]] = None,
+                                 name_regex: Optional[pulumi.Input[Optional[str]]] = None,
+                                 opts: Optional[pulumi.InvokeOptions] = 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
+    """
+    ...

pulumi_vsphere/get_license.py

@@ -118,14 +118,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.
@@ -154,14 +152,12 @@ def get_license_output(license_key: Optional[pulumi.Input[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.

pulumi_vsphere/get_network.py

@@ -99,7 +99,6 @@ def get_network(datacenter_id: Optional[str] = None,
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -108,7 +107,6 @@ def get_network(datacenter_id: Optional[str] = None,
     network = vsphere.get_network(name="VM Network",
         datacenter_id=datacenter.id)
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str datacenter_id: The managed object reference ID
@@ -150,7 +148,6 @@ def get_network_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] = No
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -159,7 +156,6 @@ def get_network_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] = No
     network = vsphere.get_network(name="VM Network",
         datacenter_id=datacenter.id)
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str datacenter_id: The managed object reference ID

pulumi_vsphere/get_policy.py

@@ -65,7 +65,6 @@ def get_policy(name: Optional[str] = None,
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -73,7 +72,6 @@ def get_policy(name: Optional[str] = None,
     prod_platinum_replicated = vsphere.get_policy(name="prod_platinum_replicated")
     dev_silver_nonreplicated = vsphere.get_policy(name="dev_silver_nonreplicated")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str name: The name of the storage policy.
@@ -101,7 +99,6 @@ def get_policy_output(name: Optional[pulumi.Input[str]] = None,
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -109,7 +106,6 @@ def get_policy_output(name: Optional[pulumi.Input[str]] = None,
     prod_platinum_replicated = vsphere.get_policy(name="prod_platinum_replicated")
     dev_silver_nonreplicated = vsphere.get_policy(name="dev_silver_nonreplicated")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str name: The name of the storage policy.

pulumi_vsphere/get_resource_pool.py

@@ -73,7 +73,6 @@ def get_resource_pool(datacenter_id: Optional[str] = None,
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -82,7 +81,6 @@ def get_resource_pool(datacenter_id: Optional[str] = None,
     pool = vsphere.get_resource_pool(name="resource-pool-01",
         datacenter_id=datacenter.id)
     ```
-    <!--End PulumiCodeChooser -->
 
     ### Specifying the Root Resource Pool for a Standalone ESXi Host
 
@@ -94,15 +92,13 @@ def get_resource_pool(datacenter_id: Optional[str] = None,
     explicitly created. This resource pool is referred to as the
     _root resource pool_ and can be looked up by specifying the path.
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     pool = vsphere.get_resource_pool(name="esxi-01.example.com/Resources",
-        datacenter_id=data["vsphere_datacenter"]["datacenter"]["id"])
+        datacenter_id=datacenter["id"])
     ```
-    <!--End PulumiCodeChooser -->
 
     For more information on the root resource pool, see [Managing Resource Pools][vmware-docs-resource-pools] in the vSphere documentation.
 
@@ -145,7 +141,6 @@ def get_resource_pool_output(datacenter_id: Optional[pulumi.Input[Optional[str]]
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -154,7 +149,6 @@ def get_resource_pool_output(datacenter_id: Optional[pulumi.Input[Optional[str]]
     pool = vsphere.get_resource_pool(name="resource-pool-01",
         datacenter_id=datacenter.id)
     ```
-    <!--End PulumiCodeChooser -->
 
     ### Specifying the Root Resource Pool for a Standalone ESXi Host
 
@@ -166,15 +160,13 @@ def get_resource_pool_output(datacenter_id: Optional[pulumi.Input[Optional[str]]
     explicitly created. This resource pool is referred to as the
     _root resource pool_ and can be looked up by specifying the path.
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     pool = vsphere.get_resource_pool(name="esxi-01.example.com/Resources",
-        datacenter_id=data["vsphere_datacenter"]["datacenter"]["id"])
+        datacenter_id=datacenter["id"])
     ```
-    <!--End PulumiCodeChooser -->
 
     For more information on the root resource pool, see [Managing Resource Pools][vmware-docs-resource-pools] in the vSphere documentation.
 

pulumi_vsphere/get_role.py

@@ -100,14 +100,12 @@ def get_role(description: Optional[str] = None,
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     terraform_role = vsphere.get_role(label="Terraform to vSphere Integration Role")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str description: The description of the role.
@@ -142,14 +140,12 @@ def get_role_output(description: Optional[pulumi.Input[Optional[str]]] = None,
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     terraform_role = vsphere.get_role(label="Terraform to vSphere Integration Role")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str description: The description of the role.

pulumi_vsphere/get_tag.py

@@ -86,7 +86,6 @@ def get_tag(category_id: Optional[str] = None,
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -95,7 +94,6 @@ def get_tag(category_id: Optional[str] = None,
     tag = vsphere.get_tag(name="example-tag",
         category_id=category.id)
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str category_id: The ID of the tag category in which the tag is
@@ -131,7 +129,6 @@ def get_tag_output(category_id: Optional[pulumi.Input[str]] = None,
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
@@ -140,7 +137,6 @@ def get_tag_output(category_id: Optional[pulumi.Input[str]] = None,
     tag = vsphere.get_tag(name="example-tag",
         category_id=category.id)
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str category_id: The ID of the tag category in which the tag is

pulumi_vsphere/get_tag_category.py

@@ -94,14 +94,12 @@ def get_tag_category(name: Optional[str] = None,
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     category = vsphere.get_tag_category(name="example-category")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str name: The name of the tag category.
@@ -134,14 +132,12 @@ def get_tag_category_output(name: Optional[pulumi.Input[str]] = None,
 
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_vsphere as vsphere
 
     category = vsphere.get_tag_category(name="example-category")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str name: The name of the tag category.