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

pulumi_vsphere/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__ = ['LicenseArgs', 'License']
@@ -165,22 +170,6 @@ class License(pulumi.CustomResource):
         """
         Provides a VMware vSphere license resource. This can be used to add and remove license keys.
 
-        ## Example Usage
-
-        <!--Start PulumiCodeChooser -->
-        ```python
-        import pulumi
-        import pulumi_vsphere as vsphere
-
-        license_key = vsphere.License("licenseKey",
-            labels={
-                "VpxClientLicenseLabel": "Hello World",
-                "Workflow": "Hello World",
-            },
-            license_key="452CQ-2EK54-K8742-00000-00000")
-        ```
-        <!--End PulumiCodeChooser -->
-
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: A map of key/value pairs to be attached as labels (tags) to the license key.
@@ -195,22 +184,6 @@ class License(pulumi.CustomResource):
         """
         Provides a VMware vSphere license resource. This can be used to add and remove license keys.
 
-        ## Example Usage
-
-        <!--Start PulumiCodeChooser -->
-        ```python
-        import pulumi
-        import pulumi_vsphere as vsphere
-
-        license_key = vsphere.License("licenseKey",
-            labels={
-                "VpxClientLicenseLabel": "Hello World",
-                "Workflow": "Hello World",
-            },
-            license_key="452CQ-2EK54-K8742-00000-00000")
-        ```
-        <!--End PulumiCodeChooser -->
-
         :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.

pulumi_vsphere/nas_datastore.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__ = ['NasDatastoreArgs', 'NasDatastore']
@@ -30,7 +35,7 @@ class NasDatastoreArgs:
         :param pulumi.Input[Sequence[pulumi.Input[str]]] host_system_ids: The managed object IDs of
                the hosts to mount the datastore on.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] remote_hosts: The hostnames or IP addresses of the remote
-               server or servers. Only one element should be present for NFS v3 but multiple
+               servers. Only one element should be present for NFS v3 but multiple
                can be present for NFS v4.1. Forces a new resource if changed.
         :param pulumi.Input[str] remote_path: The remote path of the mount point. Forces a new
                resource if changed.
@@ -104,7 +109,7 @@ class NasDatastoreArgs:
     def remote_hosts(self) -> pulumi.Input[Sequence[pulumi.Input[str]]]:
         """
         The hostnames or IP addresses of the remote
-        server or servers. Only one element should be present for NFS v3 but multiple
+        servers. Only one element should be present for NFS v3 but multiple
         can be present for NFS v4.1. Forces a new resource if changed.
         """
         return pulumi.get(self, "remote_hosts")
@@ -303,7 +308,7 @@ class _NasDatastoreState:
         :param pulumi.Input[bool] protocol_endpoint: Indicates that this NAS volume is a protocol endpoint.
                This field is only populated if the host supports virtual datastores.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] remote_hosts: The hostnames or IP addresses of the remote
-               server or servers. Only one element should be present for NFS v3 but multiple
+               servers. Only one element should be present for NFS v3 but multiple
                can be present for NFS v4.1. Forces a new resource if changed.
         :param pulumi.Input[str] remote_path: The remote path of the mount point. Forces a new
                resource if changed.
@@ -529,7 +534,7 @@ class _NasDatastoreState:
     def remote_hosts(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
         The hostnames or IP addresses of the remote
-        server or servers. Only one element should be present for NFS v3 but multiple
+        servers. Only one element should be present for NFS v3 but multiple
         can be present for NFS v4.1. Forces a new resource if changed.
         """
         return pulumi.get(self, "remote_hosts")
@@ -638,7 +643,37 @@ class NasDatastore(pulumi.CustomResource):
                  type: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Create a NasDatastore resource with the given unique name, props, and options.
+        The `NasDatastore` resource can be used to create and manage NAS
+        datastores on an ESXi host or a set of hosts. The resource supports mounting
+        NFS v3 and v4.1 shares to be used as datastores.
+
+        > **NOTE:** Unlike `VmfsDatastore`, a NAS
+        datastore is only mounted on the hosts you choose to mount it on. To mount on
+        multiple hosts, you must specify each host that you want to add in the
+        `host_system_ids` argument.
+
+        ## Import
+
+        An existing NAS datastore can be imported into this resource via
+
+        its managed object ID, via the following command:
+
+        ```sh
+        $ pulumi import vsphere:index/nasDatastore:NasDatastore datastore datastore-123
+        ```
+
+        You need a tool like [`govc`][ext-govc] that can display managed object IDs.
+
+        [ext-govc]: https://github.com/vmware/govmomi/tree/master/govc
+
+        In the case of govc, you can locate a managed object ID from an inventory path
+
+        by doing the following:
+
+        $ govc ls -i /dc/datastore/terraform-test
+
+        Datastore:datastore-123
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] access_mode: Access mode for the mount point. Can be one of
@@ -665,7 +700,7 @@ class NasDatastore(pulumi.CustomResource):
         :param pulumi.Input[str] name: The name of the datastore. Forces a new resource if
                changed.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] remote_hosts: The hostnames or IP addresses of the remote
-               server or servers. Only one element should be present for NFS v3 but multiple
+               servers. Only one element should be present for NFS v3 but multiple
                can be present for NFS v4.1. Forces a new resource if changed.
         :param pulumi.Input[str] remote_path: The remote path of the mount point. Forces a new
                resource if changed.
@@ -687,7 +722,37 @@ class NasDatastore(pulumi.CustomResource):
                  args: NasDatastoreArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a NasDatastore resource with the given unique name, props, and options.
+        The `NasDatastore` resource can be used to create and manage NAS
+        datastores on an ESXi host or a set of hosts. The resource supports mounting
+        NFS v3 and v4.1 shares to be used as datastores.
+
+        > **NOTE:** Unlike `VmfsDatastore`, a NAS
+        datastore is only mounted on the hosts you choose to mount it on. To mount on
+        multiple hosts, you must specify each host that you want to add in the
+        `host_system_ids` argument.
+
+        ## Import
+
+        An existing NAS datastore can be imported into this resource via
+
+        its managed object ID, via the following command:
+
+        ```sh
+        $ pulumi import vsphere:index/nasDatastore:NasDatastore datastore datastore-123
+        ```
+
+        You need a tool like [`govc`][ext-govc] that can display managed object IDs.
+
+        [ext-govc]: https://github.com/vmware/govmomi/tree/master/govc
+
+        In the case of govc, you can locate a managed object ID from an inventory path
+
+        by doing the following:
+
+        $ govc ls -i /dc/datastore/terraform-test
+
+        Datastore:datastore-123
+
         :param str resource_name: The name of the resource.
         :param NasDatastoreArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -817,7 +882,7 @@ class NasDatastore(pulumi.CustomResource):
         :param pulumi.Input[bool] protocol_endpoint: Indicates that this NAS volume is a protocol endpoint.
                This field is only populated if the host supports virtual datastores.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] remote_hosts: The hostnames or IP addresses of the remote
-               server or servers. Only one element should be present for NFS v3 but multiple
+               servers. Only one element should be present for NFS v3 but multiple
                can be present for NFS v4.1. Forces a new resource if changed.
         :param pulumi.Input[str] remote_path: The remote path of the mount point. Forces a new
                resource if changed.
@@ -981,7 +1046,7 @@ class NasDatastore(pulumi.CustomResource):
     def remote_hosts(self) -> pulumi.Output[Sequence[str]]:
         """
         The hostnames or IP addresses of the remote
-        server or servers. Only one element should be present for NFS v3 but multiple
+        servers. Only one element should be present for NFS v3 but multiple
         can be present for NFS v4.1. Forces a new resource if changed.
         """
         return pulumi.get(self, "remote_hosts")

pulumi_vsphere/offline_software_depot.py

@@ -0,0 +1,185 @@
+# 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
+from ._inputs import *
+
+__all__ = ['OfflineSoftwareDepotArgs', 'OfflineSoftwareDepot']
+
+@pulumi.input_type
+class OfflineSoftwareDepotArgs:
+    def __init__(__self__, *,
+                 location: pulumi.Input[str]):
+        """
+        The set of arguments for constructing a OfflineSoftwareDepot resource.
+        :param pulumi.Input[str] location: The URL where the depot source is hosted.
+        """
+        pulumi.set(__self__, "location", location)
+
+    @property
+    @pulumi.getter
+    def location(self) -> pulumi.Input[str]:
+        """
+        The URL where the depot source is hosted.
+        """
+        return pulumi.get(self, "location")
+
+    @location.setter
+    def location(self, value: pulumi.Input[str]):
+        pulumi.set(self, "location", value)
+
+
+@pulumi.input_type
+class _OfflineSoftwareDepotState:
+    def __init__(__self__, *,
+                 components: Optional[pulumi.Input[Sequence[pulumi.Input['OfflineSoftwareDepotComponentArgs']]]] = None,
+                 location: Optional[pulumi.Input[str]] = None):
+        """
+        Input properties used for looking up and filtering OfflineSoftwareDepot resources.
+        :param pulumi.Input[Sequence[pulumi.Input['OfflineSoftwareDepotComponentArgs']]] components: The list of custom components in the depot.
+        :param pulumi.Input[str] location: The URL where the depot source is hosted.
+        """
+        if components is not None:
+            pulumi.set(__self__, "components", components)
+        if location is not None:
+            pulumi.set(__self__, "location", location)
+
+    @property
+    @pulumi.getter
+    def components(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['OfflineSoftwareDepotComponentArgs']]]]:
+        """
+        The list of custom components in the depot.
+        """
+        return pulumi.get(self, "components")
+
+    @components.setter
+    def components(self, value: Optional[pulumi.Input[Sequence[pulumi.Input['OfflineSoftwareDepotComponentArgs']]]]):
+        pulumi.set(self, "components", value)
+
+    @property
+    @pulumi.getter
+    def location(self) -> Optional[pulumi.Input[str]]:
+        """
+        The URL where the depot source is hosted.
+        """
+        return pulumi.get(self, "location")
+
+    @location.setter
+    def location(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "location", value)
+
+
+class OfflineSoftwareDepot(pulumi.CustomResource):
+    @overload
+    def __init__(__self__,
+                 resource_name: str,
+                 opts: Optional[pulumi.ResourceOptions] = None,
+                 location: Optional[pulumi.Input[str]] = None,
+                 __props__=None):
+        """
+        Provides a VMware vSphere offline software depot resource.
+
+        ## Example Usage
+
+        :param str resource_name: The name of the resource.
+        :param pulumi.ResourceOptions opts: Options for the resource.
+        :param pulumi.Input[str] location: The URL where the depot source is hosted.
+        """
+        ...
+    @overload
+    def __init__(__self__,
+                 resource_name: str,
+                 args: OfflineSoftwareDepotArgs,
+                 opts: Optional[pulumi.ResourceOptions] = None):
+        """
+        Provides a VMware vSphere offline software depot resource.
+
+        ## Example Usage
+
+        :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.
+        """
+        ...
+    def __init__(__self__, resource_name: str, *args, **kwargs):
+        resource_args, opts = _utilities.get_resource_args_opts(OfflineSoftwareDepotArgs, pulumi.ResourceOptions, *args, **kwargs)
+        if resource_args is not None:
+            __self__._internal_init(resource_name, opts, **resource_args.__dict__)
+        else:
+            __self__._internal_init(resource_name, *args, **kwargs)
+
+    def _internal_init(__self__,
+                 resource_name: str,
+                 opts: Optional[pulumi.ResourceOptions] = None,
+                 location: Optional[pulumi.Input[str]] = None,
+                 __props__=None):
+        opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
+        if not isinstance(opts, pulumi.ResourceOptions):
+            raise TypeError('Expected resource options to be a ResourceOptions instance')
+        if opts.id is None:
+            if __props__ is not None:
+                raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
+            __props__ = OfflineSoftwareDepotArgs.__new__(OfflineSoftwareDepotArgs)
+
+            if location is None and not opts.urn:
+                raise TypeError("Missing required property 'location'")
+            __props__.__dict__["location"] = location
+            __props__.__dict__["components"] = None
+        super(OfflineSoftwareDepot, __self__).__init__(
+            'vsphere:index/offlineSoftwareDepot:OfflineSoftwareDepot',
+            resource_name,
+            __props__,
+            opts)
+
+    @staticmethod
+    def get(resource_name: str,
+            id: pulumi.Input[str],
+            opts: Optional[pulumi.ResourceOptions] = None,
+            components: Optional[pulumi.Input[Sequence[pulumi.Input[Union['OfflineSoftwareDepotComponentArgs', 'OfflineSoftwareDepotComponentArgsDict']]]]] = None,
+            location: Optional[pulumi.Input[str]] = None) -> 'OfflineSoftwareDepot':
+        """
+        Get an existing OfflineSoftwareDepot resource's state with the given name, id, and optional extra
+        properties used to qualify the lookup.
+
+        :param str resource_name: The unique name of the resulting resource.
+        :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[Sequence[pulumi.Input[Union['OfflineSoftwareDepotComponentArgs', 'OfflineSoftwareDepotComponentArgsDict']]]] components: The list of custom components in the depot.
+        :param pulumi.Input[str] location: The URL where the depot source is hosted.
+        """
+        opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
+
+        __props__ = _OfflineSoftwareDepotState.__new__(_OfflineSoftwareDepotState)
+
+        __props__.__dict__["components"] = components
+        __props__.__dict__["location"] = location
+        return OfflineSoftwareDepot(resource_name, opts=opts, __props__=__props__)
+
+    @property
+    @pulumi.getter
+    def components(self) -> pulumi.Output[Sequence['outputs.OfflineSoftwareDepotComponent']]:
+        """
+        The list of custom components in the depot.
+        """
+        return pulumi.get(self, "components")
+
+    @property
+    @pulumi.getter
+    def location(self) -> pulumi.Output[str]:
+        """
+        The URL where the depot source is hosted.
+        """
+        return pulumi.get(self, "location")
+