pulumi-vsphere 4.13.2__py3-none-any.whl → 4.14.0__py3-none-any.whl

pulumi_vsphere/license.py

@@ -24,8 +24,10 @@ class LicenseArgs:
                  labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]]] = None):
         """
         The set of arguments for constructing a License resource.
-        :param pulumi.Input[builtins.str] license_key: The license key to add.
-        :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] labels: A map of key/value pairs to be attached as labels (tags) to the license key.
+        :param pulumi.Input[builtins.str] license_key: The license key value.
+        :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] labels: A map of labels to be applied to the license key.
+               
+               > **NOTE:** Labels are not allowed for unmanaged ESX hosts.
         """
         pulumi.set(__self__, "license_key", license_key)
         if labels is not None:
@@ -35,7 +37,7 @@ class LicenseArgs:
     @pulumi.getter(name="licenseKey")
     def license_key(self) -> pulumi.Input[builtins.str]:
         """
-        The license key to add.
+        The license key value.
         """
         return pulumi.get(self, "license_key")
 
@@ -47,7 +49,9 @@ class LicenseArgs:
     @pulumi.getter
     def labels(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]]]:
         """
-        A map of key/value pairs to be attached as labels (tags) to the license key.
+        A map of labels to be applied to the license key.
+
+        > **NOTE:** Labels are not allowed for unmanaged ESX hosts.
         """
         return pulumi.get(self, "labels")
 
@@ -68,11 +72,13 @@ class _LicenseState:
         """
         Input properties used for looking up and filtering License resources.
         :param pulumi.Input[builtins.str] edition_key: The product edition of the license key.
-        :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] labels: A map of key/value pairs to be attached as labels (tags) to the license key.
-        :param pulumi.Input[builtins.str] license_key: The license key to add.
-        :param pulumi.Input[builtins.str] name: The display name for the license.
-        :param pulumi.Input[builtins.int] total: Total number of units (example: CPUs) contained in the license.
-        :param pulumi.Input[builtins.int] used: The number of units (example: CPUs) assigned to this license.
+        :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] labels: A map of labels to be applied to the license key.
+               
+               > **NOTE:** Labels are not allowed for unmanaged ESX hosts.
+        :param pulumi.Input[builtins.str] license_key: The license key value.
+        :param pulumi.Input[builtins.str] name: The display name for the license key.
+        :param pulumi.Input[builtins.int] total: The total number of units contained in the license key.
+        :param pulumi.Input[builtins.int] used: The number of units assigned to this license key.
         """
         if edition_key is not None:
             pulumi.set(__self__, "edition_key", edition_key)
@@ -103,7 +109,9 @@ class _LicenseState:
     @pulumi.getter
     def labels(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]]]:
         """
-        A map of key/value pairs to be attached as labels (tags) to the license key.
+        A map of labels to be applied to the license key.
+
+        > **NOTE:** Labels are not allowed for unmanaged ESX hosts.
         """
         return pulumi.get(self, "labels")
 
@@ -115,7 +123,7 @@ class _LicenseState:
     @pulumi.getter(name="licenseKey")
     def license_key(self) -> Optional[pulumi.Input[builtins.str]]:
         """
-        The license key to add.
+        The license key value.
         """
         return pulumi.get(self, "license_key")
 
@@ -127,7 +135,7 @@ class _LicenseState:
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[builtins.str]]:
         """
-        The display name for the license.
+        The display name for the license key.
         """
         return pulumi.get(self, "name")
 
@@ -139,7 +147,7 @@ class _LicenseState:
     @pulumi.getter
     def total(self) -> Optional[pulumi.Input[builtins.int]]:
         """
-        Total number of units (example: CPUs) contained in the license.
+        The total number of units contained in the license key.
         """
         return pulumi.get(self, "total")
 
@@ -151,7 +159,7 @@ class _LicenseState:
     @pulumi.getter
     def used(self) -> Optional[pulumi.Input[builtins.int]]:
         """
-        The number of units (example: CPUs) assigned to this license.
+        The number of units assigned to this license key.
         """
         return pulumi.get(self, "used")
 
@@ -160,6 +168,7 @@ class _LicenseState:
         pulumi.set(self, "used", value)
 
 
+@pulumi.type_token("vsphere:index/license:License")
 class License(pulumi.CustomResource):
     @overload
     def __init__(__self__,
@@ -171,10 +180,25 @@ class License(pulumi.CustomResource):
         """
         Provides a VMware vSphere license resource. This can be used to add and remove license keys.
 
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        license_key = vsphere.License("licenseKey",
+            license_key="00000-00000-00000-00000-00000",
+            labels={
+                "VpxClientLicenseLabel": "example",
+            })
+        ```
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] labels: A map of key/value pairs to be attached as labels (tags) to the license key.
-        :param pulumi.Input[builtins.str] license_key: The license key to add.
+        :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] labels: A map of labels to be applied to the license key.
+               
+               > **NOTE:** Labels are not allowed for unmanaged ESX hosts.
+        :param pulumi.Input[builtins.str] license_key: The license key value.
         """
         ...
     @overload
@@ -185,6 +209,19 @@ class License(pulumi.CustomResource):
         """
         Provides a VMware vSphere license resource. This can be used to add and remove license keys.
 
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        license_key = vsphere.License("licenseKey",
+            license_key="00000-00000-00000-00000-00000",
+            labels={
+                "VpxClientLicenseLabel": "example",
+            })
+        ```
+
         :param str resource_name: The name of the resource.
         :param LicenseArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -243,11 +280,13 @@ class License(pulumi.CustomResource):
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[builtins.str] edition_key: The product edition of the license key.
-        :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] labels: A map of key/value pairs to be attached as labels (tags) to the license key.
-        :param pulumi.Input[builtins.str] license_key: The license key to add.
-        :param pulumi.Input[builtins.str] name: The display name for the license.
-        :param pulumi.Input[builtins.int] total: Total number of units (example: CPUs) contained in the license.
-        :param pulumi.Input[builtins.int] used: The number of units (example: CPUs) assigned to this license.
+        :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] labels: A map of labels to be applied to the license key.
+               
+               > **NOTE:** Labels are not allowed for unmanaged ESX hosts.
+        :param pulumi.Input[builtins.str] license_key: The license key value.
+        :param pulumi.Input[builtins.str] name: The display name for the license key.
+        :param pulumi.Input[builtins.int] total: The total number of units contained in the license key.
+        :param pulumi.Input[builtins.int] used: The number of units assigned to this license key.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -273,7 +312,9 @@ class License(pulumi.CustomResource):
     @pulumi.getter
     def labels(self) -> pulumi.Output[Optional[Mapping[str, builtins.str]]]:
         """
-        A map of key/value pairs to be attached as labels (tags) to the license key.
+        A map of labels to be applied to the license key.
+
+        > **NOTE:** Labels are not allowed for unmanaged ESX hosts.
         """
         return pulumi.get(self, "labels")
 
@@ -281,7 +322,7 @@ class License(pulumi.CustomResource):
     @pulumi.getter(name="licenseKey")
     def license_key(self) -> pulumi.Output[builtins.str]:
         """
-        The license key to add.
+        The license key value.
         """
         return pulumi.get(self, "license_key")
 
@@ -289,7 +330,7 @@ class License(pulumi.CustomResource):
     @pulumi.getter
     def name(self) -> pulumi.Output[builtins.str]:
         """
-        The display name for the license.
+        The display name for the license key.
         """
         return pulumi.get(self, "name")
 
@@ -297,7 +338,7 @@ class License(pulumi.CustomResource):
     @pulumi.getter
     def total(self) -> pulumi.Output[builtins.int]:
         """
-        Total number of units (example: CPUs) contained in the license.
+        The total number of units contained in the license key.
         """
         return pulumi.get(self, "total")
 
@@ -305,7 +346,7 @@ class License(pulumi.CustomResource):
     @pulumi.getter
     def used(self) -> pulumi.Output[builtins.int]:
         """
-        The number of units (example: CPUs) assigned to this license.
+        The number of units assigned to this license key.
         """
         return pulumi.get(self, "used")
 

pulumi_vsphere/nas_datastore.py

@@ -626,6 +626,7 @@ class _NasDatastoreState:
         pulumi.set(self, "url", value)
 
 
+@pulumi.type_token("vsphere:index/nasDatastore:NasDatastore")
 class NasDatastore(pulumi.CustomResource):
     @overload
     def __init__(__self__,
@@ -653,12 +654,43 @@ class NasDatastore(pulumi.CustomResource):
         multiple hosts, you must specify each host that you want to add in the
         `host_system_ids` argument.
 
+        ## Example Usage
+
+        The following example would set up a NFS v3 share on 3 hosts connected through
+        vCenter in the same datacenter - `esxi1`, `esxi2`, and `esxi3`. The remote host
+        is named `nfs` and has `/export/test` exported.
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        config = pulumi.Config()
+        hosts = config.get_object("hosts")
+        if hosts is None:
+            hosts = [
+                "esxi-01.example.com",
+                "esxi-02.example.com",
+                "esxi-03.example.com",
+            ]
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        hosts_get_host = [vsphere.get_host(name=hosts[__index],
+            datacenter_id=datacenter.id) for __index in range(len(hosts))]
+        datastore = vsphere.NasDatastore("datastore",
+            name="test",
+            host_system_ids=[[__item["id"] for __item in esxi_hosts]],
+            type="NFS",
+            remote_hosts=["nfs"],
+            remote_path="/export/test")
+        ```
+
         ## Import
 
         An existing NAS datastore can be imported into this resource via
 
         its managed object ID, via the following command:
 
+        [docs-import]: https://developer.hashicorp.com/terraform/cli/import
+
         ```sh
         $ pulumi import vsphere:index/nasDatastore:NasDatastore datastore datastore-123
         ```
@@ -732,12 +764,43 @@ class NasDatastore(pulumi.CustomResource):
         multiple hosts, you must specify each host that you want to add in the
         `host_system_ids` argument.
 
+        ## Example Usage
+
+        The following example would set up a NFS v3 share on 3 hosts connected through
+        vCenter in the same datacenter - `esxi1`, `esxi2`, and `esxi3`. The remote host
+        is named `nfs` and has `/export/test` exported.
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        config = pulumi.Config()
+        hosts = config.get_object("hosts")
+        if hosts is None:
+            hosts = [
+                "esxi-01.example.com",
+                "esxi-02.example.com",
+                "esxi-03.example.com",
+            ]
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        hosts_get_host = [vsphere.get_host(name=hosts[__index],
+            datacenter_id=datacenter.id) for __index in range(len(hosts))]
+        datastore = vsphere.NasDatastore("datastore",
+            name="test",
+            host_system_ids=[[__item["id"] for __item in esxi_hosts]],
+            type="NFS",
+            remote_hosts=["nfs"],
+            remote_path="/export/test")
+        ```
+
         ## Import
 
         An existing NAS datastore can be imported into this resource via
 
         its managed object ID, via the following command:
 
+        [docs-import]: https://developer.hashicorp.com/terraform/cli/import
+
         ```sh
         $ pulumi import vsphere:index/nasDatastore:NasDatastore datastore datastore-123
         ```

pulumi_vsphere/offline_software_depot.py

@@ -82,6 +82,7 @@ class _OfflineSoftwareDepotState:
         pulumi.set(self, "location", value)
 
 
+@pulumi.type_token("vsphere:index/offlineSoftwareDepot:OfflineSoftwareDepot")
 class OfflineSoftwareDepot(pulumi.CustomResource):
     @overload
     def __init__(__self__,
@@ -94,6 +95,8 @@ class OfflineSoftwareDepot(pulumi.CustomResource):
 
         ## Example Usage
 
+        ### S
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[builtins.str] location: The URL where the depot source is hosted.
@@ -109,6 +112,8 @@ class OfflineSoftwareDepot(pulumi.CustomResource):
 
         ## Example Usage
 
+        ### S
+
         :param str resource_name: The name of the resource.
         :param OfflineSoftwareDepotArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.

pulumi_vsphere/outputs.py

@@ -3674,7 +3674,10 @@ class GetGuestOsCustomizationSpecWindowsOptionResult(dict):
                  computer_name: builtins.str,
                  domain_admin_user: builtins.str,
                  domain_ou: builtins.str,
+                 full_name: builtins.str,
                  join_domain: builtins.str,
+                 organization_name: builtins.str,
+                 product_key: builtins.str,
                  run_once_command_lists: Sequence[builtins.str],
                  time_zone: builtins.int,
                  workgroup: builtins.str,
@@ -3686,7 +3689,10 @@ class GetGuestOsCustomizationSpecWindowsOptionResult(dict):
         :param builtins.str computer_name: The hostname for this virtual machine.
         :param builtins.str domain_admin_user: The user account of the domain administrator used to join this virtual machine to the domain.
         :param builtins.str domain_ou: The MachineObjectOU which specifies the full LDAP path name of the OU to which the virtual machine belongs.
+        :param builtins.str full_name: The full name of the user of this virtual machine.
         :param builtins.str join_domain: The Active Directory domain for the virtual machine to join.
+        :param builtins.str organization_name: The organization name this virtual machine is being installed for.
+        :param builtins.str product_key: The product key for this virtual machine.
         :param Sequence[builtins.str] run_once_command_lists: A list of commands to run at first user logon, after guest customization.
         :param builtins.int time_zone: The new time zone for the virtual machine. This is a sysprep-dictated timezone code.
         :param builtins.str workgroup: The workgroup for this virtual machine if not joining an Active Directory domain.
@@ -3698,7 +3704,10 @@ class GetGuestOsCustomizationSpecWindowsOptionResult(dict):
         pulumi.set(__self__, "computer_name", computer_name)
         pulumi.set(__self__, "domain_admin_user", domain_admin_user)
         pulumi.set(__self__, "domain_ou", domain_ou)
+        pulumi.set(__self__, "full_name", full_name)
         pulumi.set(__self__, "join_domain", join_domain)
+        pulumi.set(__self__, "organization_name", organization_name)
+        pulumi.set(__self__, "product_key", product_key)
         pulumi.set(__self__, "run_once_command_lists", run_once_command_lists)
         pulumi.set(__self__, "time_zone", time_zone)
         pulumi.set(__self__, "workgroup", workgroup)
@@ -3753,6 +3762,14 @@ class GetGuestOsCustomizationSpecWindowsOptionResult(dict):
         """
         return pulumi.get(self, "domain_ou")
 
+    @property
+    @pulumi.getter(name="fullName")
+    def full_name(self) -> builtins.str:
+        """
+        The full name of the user of this virtual machine.
+        """
+        return pulumi.get(self, "full_name")
+
     @property
     @pulumi.getter(name="joinDomain")
     def join_domain(self) -> builtins.str:
@@ -3761,6 +3778,22 @@ class GetGuestOsCustomizationSpecWindowsOptionResult(dict):
         """
         return pulumi.get(self, "join_domain")
 
+    @property
+    @pulumi.getter(name="organizationName")
+    def organization_name(self) -> builtins.str:
+        """
+        The organization name this virtual machine is being installed for.
+        """
+        return pulumi.get(self, "organization_name")
+
+    @property
+    @pulumi.getter(name="productKey")
+    def product_key(self) -> builtins.str:
+        """
+        The product key for this virtual machine.
+        """
+        return pulumi.get(self, "product_key")
+
     @property
     @pulumi.getter(name="runOnceCommandLists")
     def run_once_command_lists(self) -> Sequence[builtins.str]:

pulumi_vsphere/provider.py

@@ -247,6 +247,7 @@ class ProviderArgs:
         pulumi.set(self, "vsphere_server", value)
 
 
+@pulumi.type_token("pulumi:providers:vsphere")
 class Provider(pulumi.ProviderResource):
     @overload
     def __init__(__self__,
@@ -437,3 +438,23 @@ class Provider(pulumi.ProviderResource):
         """
         return pulumi.get(self, "vsphere_server")
 
+    @pulumi.output_type
+    class TerraformConfigResult:
+        def __init__(__self__, result=None):
+            if result and not isinstance(result, dict):
+                raise TypeError("Expected argument 'result' to be a dict")
+            pulumi.set(__self__, "result", result)
+
+        @property
+        @pulumi.getter
+        def result(self) -> Mapping[str, Any]:
+            return pulumi.get(self, "result")
+
+    def terraform_config(__self__) -> pulumi.Output['Provider.TerraformConfigResult']:
+        """
+        This function returns a Terraform config object with terraform-namecased keys,to be used with the Terraform Module Provider.
+        """
+        __args__ = dict()
+        __args__['__self__'] = __self__
+        return pulumi.runtime.call('pulumi:providers:vsphere/terraformConfig', __args__, res=__self__, typ=Provider.TerraformConfigResult)
+

pulumi_vsphere/pulumi-plugin.json

@@ -1,5 +1,5 @@
 {
   "resource": true,
   "name": "vsphere",
-  "version": "4.13.2"
+  "version": "4.14.0"
 }