pulumi-vsphere 4.9.0a1698129503__py3-none-any.whl → 4.9.0a1698198425__py3-none-any.whl

pulumi_vsphere/get_host_thumbprint.py

@@ -81,15 +81,6 @@ def get_host_thumbprint(address: Optional[str] = None,
     resource. If the ESXi host is using a certificate chain, the first one returned
     will be used to generate the thumbprint.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    thumbprint = vsphere.get_host_thumbprint(address="esxi-01.example.com")
-    ```
-
 
     :param str address: The address of the ESXi host to retrieve the
            thumbprint from.
@@ -122,15 +113,6 @@ def get_host_thumbprint_output(address: Optional[pulumi.Input[str]] = None,
     resource. If the ESXi host is using a certificate chain, the first one returned
     will be used to generate the thumbprint.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    thumbprint = vsphere.get_host_thumbprint(address="esxi-01.example.com")
-    ```
-
 
     :param str address: The address of the ESXi host to retrieve the
            thumbprint from.

pulumi_vsphere/get_license.py

@@ -116,15 +116,6 @@ def get_license(license_key: Optional[str] = None,
     The `License` data source can be used to get the general attributes of
     a license keys from a vCenter Server instance.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    license = vsphere.get_license(license_key="00000-00000-00000-00000-00000")
-    ```
-
 
     :param str license_key: The license key.
     """
@@ -150,15 +141,6 @@ def get_license_output(license_key: Optional[pulumi.Input[str]] = None,
     The `License` data source can be used to get the general attributes of
     a license keys from a vCenter Server instance.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    license = vsphere.get_license(license_key="00000-00000-00000-00000-00000")
-    ```
-
 
     :param str license_key: The license key.
     """

pulumi_vsphere/get_network.py

@@ -97,17 +97,6 @@ def get_network(datacenter_id: Optional[str] = None,
     that requires a network. This includes standard (host-based) port groups,
     distributed port groups, or opaque networks such as those managed by NSX.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    datacenter = vsphere.get_datacenter(name="dc-01")
-    network = vsphere.get_network(name="VM Network",
-        datacenter_id=datacenter.id)
-    ```
-
 
     :param str datacenter_id: The managed object reference ID
            of the datacenter the network is located in. This can be omitted if the
@@ -146,17 +135,6 @@ def get_network_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] = No
     that requires a network. This includes standard (host-based) port groups,
     distributed port groups, or opaque networks such as those managed by NSX.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    datacenter = vsphere.get_datacenter(name="dc-01")
-    network = vsphere.get_network(name="VM Network",
-        datacenter_id=datacenter.id)
-    ```
-
 
     :param str datacenter_id: The managed object reference ID
            of the datacenter the network is located in. This can be omitted if the

pulumi_vsphere/get_policy.py

@@ -63,16 +63,6 @@ def get_policy(name: Optional[str] = None,
     > **NOTE:** Storage policies are not supported on direct ESXi hosts and
     requires vCenter Server.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    prod_platinum_replicated = vsphere.get_policy(name="prod_platinum_replicated")
-    dev_silver_nonreplicated = vsphere.get_policy(name="dev_silver_nonreplicated")
-    ```
-
 
     :param str name: The name of the storage policy.
     """
@@ -97,16 +87,6 @@ def get_policy_output(name: Optional[pulumi.Input[str]] = None,
     > **NOTE:** Storage policies are not supported on direct ESXi hosts and
     requires vCenter Server.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    prod_platinum_replicated = vsphere.get_policy(name="prod_platinum_replicated")
-    dev_silver_nonreplicated = vsphere.get_policy(name="dev_silver_nonreplicated")
-    ```
-
 
     :param str name: The name of the storage policy.
     """

pulumi_vsphere/get_resource_pool.py

@@ -71,38 +71,6 @@ def get_resource_pool(datacenter_id: Optional[str] = None,
     that you want to use to create virtual machines in using the
     `VirtualMachine` resource.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    datacenter = vsphere.get_datacenter(name="dc-01")
-    pool = vsphere.get_resource_pool(name="resource-pool-01",
-        datacenter_id=datacenter.id)
-    ```
-    ### Specifying the Root Resource Pool for a Standalone ESXi Host
-
-    > **NOTE:** Returning the root resource pool for a cluster can be done
-    directly via the `ComputeCluster`
-    data source.
-
-    All compute resources in vSphere have a resource pool, even if one has not been
-    explicitly created. This resource pool is referred to as the
-    _root resource pool_ and can be looked up by specifying the path.
-
-    ```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"])
-    ```
-
-    For more information on the root resource pool, see [Managing Resource Pools][vmware-docs-resource-pools] in the vSphere documentation.
-
-    [vmware-docs-resource-pools]: https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.resmgmt.doc/GUID-60077B40-66FF-4625-934A-641703ED7601.html
-
 
     :param str datacenter_id: The managed object reference ID
            of the datacenter in which the resource pool is located. This can be omitted
@@ -138,38 +106,6 @@ def get_resource_pool_output(datacenter_id: Optional[pulumi.Input[Optional[str]]
     that you want to use to create virtual machines in using the
     `VirtualMachine` resource.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    datacenter = vsphere.get_datacenter(name="dc-01")
-    pool = vsphere.get_resource_pool(name="resource-pool-01",
-        datacenter_id=datacenter.id)
-    ```
-    ### Specifying the Root Resource Pool for a Standalone ESXi Host
-
-    > **NOTE:** Returning the root resource pool for a cluster can be done
-    directly via the `ComputeCluster`
-    data source.
-
-    All compute resources in vSphere have a resource pool, even if one has not been
-    explicitly created. This resource pool is referred to as the
-    _root resource pool_ and can be looked up by specifying the path.
-
-    ```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"])
-    ```
-
-    For more information on the root resource pool, see [Managing Resource Pools][vmware-docs-resource-pools] in the vSphere documentation.
-
-    [vmware-docs-resource-pools]: https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.resmgmt.doc/GUID-60077B40-66FF-4625-934A-641703ED7601.html
-
 
     :param str datacenter_id: The managed object reference ID
            of the datacenter in which the resource pool is located. This can be omitted

pulumi_vsphere/get_role.py

@@ -98,15 +98,6 @@ def get_role(description: Optional[str] = None,
     The `Role` data source can be used to discover the `id` and privileges associated
     with a role given its name or display label.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    terraform_role = vsphere.get_role(label="Terraform to vSphere Integration Role")
-    ```
-
 
     :param str description: The description of the role.
     :param str label: The label of the role.
@@ -138,15 +129,6 @@ def get_role_output(description: Optional[pulumi.Input[Optional[str]]] = None,
     The `Role` data source can be used to discover the `id` and privileges associated
     with a role given its name or display label.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    terraform_role = vsphere.get_role(label="Terraform to vSphere Integration Role")
-    ```
-
 
     :param str description: The description of the role.
     :param str label: The label of the role.

pulumi_vsphere/get_tag.py

@@ -84,17 +84,6 @@ def get_tag(category_id: Optional[str] = None,
     > **NOTE:** Tagging is not supported on direct ESXi hosts connections and
     requires vCenter Server.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    category = vsphere.get_tag_category(name="example-category")
-    tag = vsphere.get_tag(name="example-tag",
-        category_id=category.id)
-    ```
-
 
     :param str category_id: The ID of the tag category in which the tag is
            located.
@@ -127,17 +116,6 @@ def get_tag_output(category_id: Optional[pulumi.Input[str]] = None,
     > **NOTE:** Tagging is not supported on direct ESXi hosts connections and
     requires vCenter Server.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    category = vsphere.get_tag_category(name="example-category")
-    tag = vsphere.get_tag(name="example-tag",
-        category_id=category.id)
-    ```
-
 
     :param str category_id: The ID of the tag category in which the tag is
            located.

pulumi_vsphere/get_tag_category.py

@@ -92,15 +92,6 @@ def get_tag_category(name: Optional[str] = None,
     > **NOTE:** Tagging is not supported on direct ESXi hosts connections and
     requires vCenter Server.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    category = vsphere.get_tag_category(name="example-category")
-    ```
-
 
     :param str name: The name of the tag category.
     """
@@ -130,15 +121,6 @@ def get_tag_category_output(name: Optional[pulumi.Input[str]] = None,
     > **NOTE:** Tagging is not supported on direct ESXi hosts connections and
     requires vCenter Server.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    category = vsphere.get_tag_category(name="example-category")
-    ```
-
 
     :param str name: The name of the tag category.
     """

pulumi_vsphere/get_vapp_container.py

@@ -71,17 +71,6 @@ def get_vapp_container(datacenter_id: Optional[str] = None,
     that you want to use to create virtual machines in using the
     `VirtualMachine` resource.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    datacenter = vsphere.get_datacenter(name="dc-01")
-    pool = vsphere.get_vapp_container(name="vapp-container-01",
-        datacenter_id=datacenter.id)
-    ```
-
 
     :param str datacenter_id: The managed object reference ID
            of the datacenter in which the vApp container is located.
@@ -110,17 +99,6 @@ def get_vapp_container_output(datacenter_id: Optional[pulumi.Input[str]] = None,
     that you want to use to create virtual machines in using the
     `VirtualMachine` resource.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    datacenter = vsphere.get_datacenter(name="dc-01")
-    pool = vsphere.get_vapp_container(name="vapp-container-01",
-        datacenter_id=datacenter.id)
-    ```
-
 
     :param str datacenter_id: The managed object reference ID
            of the datacenter in which the vApp container is located.

pulumi_vsphere/get_virtual_machine.py

@@ -737,33 +737,6 @@ def get_virtual_machine(alternate_guest_name: Optional[str] = None,
     `VirtualMachine` resource. It also
     reads the guest ID so that can be supplied as well.
 
-    ## Example Usage
-
-    In the following example, a virtual machine template is returned by its
-    unique name within the `Datacenter`.
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    datacenter = vsphere.get_datacenter(name="dc-01")
-    template = vsphere.get_virtual_machine(name="ubuntu-server-template",
-        datacenter_id=datacenter.id)
-    ```
-    In the following example, each virtual machine template is returned by its
-    unique full path within the `Datacenter`.
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    datacenter = vsphere.get_datacenter(name="dc-01")
-    production_template = vsphere.get_virtual_machine(name="production/templates/ubuntu-server-template",
-        datacenter_id=datacenter.id)
-    development_template = vsphere.get_virtual_machine(name="development/templates/ubuntu-server-template",
-        datacenter_id=datacenter.id)
-    ```
-
 
     :param str alternate_guest_name: The alternate guest name of the virtual machine when
            `guest_id` is a non-specific operating system, like `otherGuest` or `otherGuest64`.
@@ -979,33 +952,6 @@ def get_virtual_machine_output(alternate_guest_name: Optional[pulumi.Input[Optio
     `VirtualMachine` resource. It also
     reads the guest ID so that can be supplied as well.
 
-    ## Example Usage
-
-    In the following example, a virtual machine template is returned by its
-    unique name within the `Datacenter`.
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    datacenter = vsphere.get_datacenter(name="dc-01")
-    template = vsphere.get_virtual_machine(name="ubuntu-server-template",
-        datacenter_id=datacenter.id)
-    ```
-    In the following example, each virtual machine template is returned by its
-    unique full path within the `Datacenter`.
-
-    ```python
-    import pulumi
-    import pulumi_vsphere as vsphere
-
-    datacenter = vsphere.get_datacenter(name="dc-01")
-    production_template = vsphere.get_virtual_machine(name="production/templates/ubuntu-server-template",
-        datacenter_id=datacenter.id)
-    development_template = vsphere.get_virtual_machine(name="development/templates/ubuntu-server-template",
-        datacenter_id=datacenter.id)
-    ```
-
 
     :param str alternate_guest_name: The alternate guest name of the virtual machine when
            `guest_id` is a non-specific operating system, like `otherGuest` or `otherGuest64`.

pulumi_vsphere/get_vmfs_disks.py

@@ -94,20 +94,6 @@ def get_vmfs_disks(filter: Optional[str] = None,
     `VmfsDatastore` resource to create VMFS
     datastores based off a set of discovered disks.
 
-    ## Example Usage
-
-    ```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)
-    vmfs_disks = vsphere.get_vmfs_disks(host_system_id=host.id,
-        rescan=True,
-        filter="mpx.vmhba1:C0:T[12]:L0")
-    ```
-
 
     :param str filter: A regular expression to filter the disks against. Only
            disks with canonical names that match will be included.
@@ -147,20 +133,6 @@ def get_vmfs_disks_output(filter: Optional[pulumi.Input[Optional[str]]] = None,
     `VmfsDatastore` resource to create VMFS
     datastores based off a set of discovered disks.
 
-    ## Example Usage
-
-    ```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)
-    vmfs_disks = vsphere.get_vmfs_disks(host_system_id=host.id,
-        rescan=True,
-        filter="mpx.vmhba1:C0:T[12]:L0")
-    ```
-
 
     :param str filter: A regular expression to filter the disks against. Only
            disks with canonical names that match will be included.

pulumi_vsphere/ha_vm_override.py

@@ -107,8 +107,8 @@ class HaVmOverrideArgs:
     @staticmethod
     def _configure(
              _setter: Callable[[Any, Any], None],
-             compute_cluster_id: pulumi.Input[str],
-             virtual_machine_id: pulumi.Input[str],
+             compute_cluster_id: Optional[pulumi.Input[str]] = None,
+             virtual_machine_id: Optional[pulumi.Input[str]] = None,
              ha_datastore_apd_recovery_action: Optional[pulumi.Input[str]] = None,
              ha_datastore_apd_response: Optional[pulumi.Input[str]] = None,
              ha_datastore_apd_response_delay: Optional[pulumi.Input[int]] = None,
@@ -122,7 +122,43 @@ class HaVmOverrideArgs:
              ha_vm_monitoring_use_cluster_defaults: Optional[pulumi.Input[bool]] = None,
              ha_vm_restart_priority: Optional[pulumi.Input[str]] = None,
              ha_vm_restart_timeout: Optional[pulumi.Input[int]] = None,
-             opts: Optional[pulumi.ResourceOptions]=None):
+             opts: Optional[pulumi.ResourceOptions] = None,
+             **kwargs):
+        if compute_cluster_id is None and 'computeClusterId' in kwargs:
+            compute_cluster_id = kwargs['computeClusterId']
+        if compute_cluster_id is None:
+            raise TypeError("Missing 'compute_cluster_id' argument")
+        if virtual_machine_id is None and 'virtualMachineId' in kwargs:
+            virtual_machine_id = kwargs['virtualMachineId']
+        if virtual_machine_id is None:
+            raise TypeError("Missing 'virtual_machine_id' argument")
+        if ha_datastore_apd_recovery_action is None and 'haDatastoreApdRecoveryAction' in kwargs:
+            ha_datastore_apd_recovery_action = kwargs['haDatastoreApdRecoveryAction']
+        if ha_datastore_apd_response is None and 'haDatastoreApdResponse' in kwargs:
+            ha_datastore_apd_response = kwargs['haDatastoreApdResponse']
+        if ha_datastore_apd_response_delay is None and 'haDatastoreApdResponseDelay' in kwargs:
+            ha_datastore_apd_response_delay = kwargs['haDatastoreApdResponseDelay']
+        if ha_datastore_pdl_response is None and 'haDatastorePdlResponse' in kwargs:
+            ha_datastore_pdl_response = kwargs['haDatastorePdlResponse']
+        if ha_host_isolation_response is None and 'haHostIsolationResponse' in kwargs:
+            ha_host_isolation_response = kwargs['haHostIsolationResponse']
+        if ha_vm_failure_interval is None and 'haVmFailureInterval' in kwargs:
+            ha_vm_failure_interval = kwargs['haVmFailureInterval']
+        if ha_vm_maximum_failure_window is None and 'haVmMaximumFailureWindow' in kwargs:
+            ha_vm_maximum_failure_window = kwargs['haVmMaximumFailureWindow']
+        if ha_vm_maximum_resets is None and 'haVmMaximumResets' in kwargs:
+            ha_vm_maximum_resets = kwargs['haVmMaximumResets']
+        if ha_vm_minimum_uptime is None and 'haVmMinimumUptime' in kwargs:
+            ha_vm_minimum_uptime = kwargs['haVmMinimumUptime']
+        if ha_vm_monitoring is None and 'haVmMonitoring' in kwargs:
+            ha_vm_monitoring = kwargs['haVmMonitoring']
+        if ha_vm_monitoring_use_cluster_defaults is None and 'haVmMonitoringUseClusterDefaults' in kwargs:
+            ha_vm_monitoring_use_cluster_defaults = kwargs['haVmMonitoringUseClusterDefaults']
+        if ha_vm_restart_priority is None and 'haVmRestartPriority' in kwargs:
+            ha_vm_restart_priority = kwargs['haVmRestartPriority']
+        if ha_vm_restart_timeout is None and 'haVmRestartTimeout' in kwargs:
+            ha_vm_restart_timeout = kwargs['haVmRestartTimeout']
+
         _setter("compute_cluster_id", compute_cluster_id)
         _setter("virtual_machine_id", virtual_machine_id)
         if ha_datastore_apd_recovery_action is not None:
@@ -483,7 +519,39 @@ class _HaVmOverrideState:
              ha_vm_restart_priority: Optional[pulumi.Input[str]] = None,
              ha_vm_restart_timeout: Optional[pulumi.Input[int]] = None,
              virtual_machine_id: Optional[pulumi.Input[str]] = None,
-             opts: Optional[pulumi.ResourceOptions]=None):
+             opts: Optional[pulumi.ResourceOptions] = None,
+             **kwargs):
+        if compute_cluster_id is None and 'computeClusterId' in kwargs:
+            compute_cluster_id = kwargs['computeClusterId']
+        if ha_datastore_apd_recovery_action is None and 'haDatastoreApdRecoveryAction' in kwargs:
+            ha_datastore_apd_recovery_action = kwargs['haDatastoreApdRecoveryAction']
+        if ha_datastore_apd_response is None and 'haDatastoreApdResponse' in kwargs:
+            ha_datastore_apd_response = kwargs['haDatastoreApdResponse']
+        if ha_datastore_apd_response_delay is None and 'haDatastoreApdResponseDelay' in kwargs:
+            ha_datastore_apd_response_delay = kwargs['haDatastoreApdResponseDelay']
+        if ha_datastore_pdl_response is None and 'haDatastorePdlResponse' in kwargs:
+            ha_datastore_pdl_response = kwargs['haDatastorePdlResponse']
+        if ha_host_isolation_response is None and 'haHostIsolationResponse' in kwargs:
+            ha_host_isolation_response = kwargs['haHostIsolationResponse']
+        if ha_vm_failure_interval is None and 'haVmFailureInterval' in kwargs:
+            ha_vm_failure_interval = kwargs['haVmFailureInterval']
+        if ha_vm_maximum_failure_window is None and 'haVmMaximumFailureWindow' in kwargs:
+            ha_vm_maximum_failure_window = kwargs['haVmMaximumFailureWindow']
+        if ha_vm_maximum_resets is None and 'haVmMaximumResets' in kwargs:
+            ha_vm_maximum_resets = kwargs['haVmMaximumResets']
+        if ha_vm_minimum_uptime is None and 'haVmMinimumUptime' in kwargs:
+            ha_vm_minimum_uptime = kwargs['haVmMinimumUptime']
+        if ha_vm_monitoring is None and 'haVmMonitoring' in kwargs:
+            ha_vm_monitoring = kwargs['haVmMonitoring']
+        if ha_vm_monitoring_use_cluster_defaults is None and 'haVmMonitoringUseClusterDefaults' in kwargs:
+            ha_vm_monitoring_use_cluster_defaults = kwargs['haVmMonitoringUseClusterDefaults']
+        if ha_vm_restart_priority is None and 'haVmRestartPriority' in kwargs:
+            ha_vm_restart_priority = kwargs['haVmRestartPriority']
+        if ha_vm_restart_timeout is None and 'haVmRestartTimeout' in kwargs:
+            ha_vm_restart_timeout = kwargs['haVmRestartTimeout']
+        if virtual_machine_id is None and 'virtualMachineId' in kwargs:
+            virtual_machine_id = kwargs['virtualMachineId']
+
         if compute_cluster_id is not None:
             _setter("compute_cluster_id", compute_cluster_id)
         if ha_datastore_apd_recovery_action is not None: