PyPI - pulumi-vsphere - Versions diffs - 4.10.0a1710245029__py3-none-any.whl → 4.13.0a1736836157__py3-none-any.whl - Mend

pulumi-vsphere 4.10.0a1710245029py3-none-any.whl → 4.13.0a1736836157py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of pulumi-vsphere might be problematic. Click here for more details.

Files changed (85) hide show

pulumi_vsphere/__init__.py +28 -0
pulumi_vsphere/_inputs.py +1816 -277
pulumi_vsphere/_utilities.py +41 -5
pulumi_vsphere/compute_cluster.py +937 -1488
pulumi_vsphere/compute_cluster_host_group.py +67 -2
pulumi_vsphere/compute_cluster_vm_affinity_rule.py +69 -34
pulumi_vsphere/compute_cluster_vm_anti_affinity_rule.py +41 -2
pulumi_vsphere/compute_cluster_vm_dependency_rule.py +205 -2
pulumi_vsphere/compute_cluster_vm_group.py +198 -2
pulumi_vsphere/compute_cluster_vm_host_rule.py +73 -2
pulumi_vsphere/config/__init__.pyi +5 -0
pulumi_vsphere/config/vars.py +5 -0
pulumi_vsphere/content_library.py +113 -12
pulumi_vsphere/content_library_item.py +143 -2
pulumi_vsphere/custom_attribute.py +77 -2
pulumi_vsphere/datacenter.py +48 -40
pulumi_vsphere/datastore_cluster.py +217 -366
pulumi_vsphere/datastore_cluster_vm_anti_affinity_rule.py +159 -2
pulumi_vsphere/distributed_port_group.py +416 -189
pulumi_vsphere/distributed_virtual_switch.py +571 -830
pulumi_vsphere/dpm_host_override.py +63 -2
pulumi_vsphere/drs_vm_override.py +67 -2
pulumi_vsphere/entity_permissions.py +64 -38
pulumi_vsphere/file.py +21 -24
pulumi_vsphere/folder.py +148 -30
pulumi_vsphere/get_compute_cluster.py +16 -9
pulumi_vsphere/get_compute_cluster_host_group.py +36 -25
pulumi_vsphere/get_content_library.py +23 -15
pulumi_vsphere/get_content_library_item.py +29 -13
pulumi_vsphere/get_custom_attribute.py +14 -9
pulumi_vsphere/get_datacenter.py +30 -12
pulumi_vsphere/get_datastore.py +29 -21
pulumi_vsphere/get_datastore_cluster.py +31 -10
pulumi_vsphere/get_datastore_stats.py +63 -57
pulumi_vsphere/get_distributed_virtual_switch.py +18 -9
pulumi_vsphere/get_dynamic.py +35 -25
pulumi_vsphere/get_folder.py +23 -11
pulumi_vsphere/get_guest_os_customization.py +26 -52
pulumi_vsphere/get_host.py +16 -9
pulumi_vsphere/get_host_base_images.py +104 -0
pulumi_vsphere/get_host_pci_device.py +28 -19
pulumi_vsphere/get_host_thumbprint.py +41 -25
pulumi_vsphere/get_host_vgpu_profile.py +20 -15
pulumi_vsphere/get_license.py +20 -10
pulumi_vsphere/get_network.py +80 -24
pulumi_vsphere/get_ovf_vm_template.py +56 -5
pulumi_vsphere/get_policy.py +13 -9
pulumi_vsphere/get_resource_pool.py +29 -23
pulumi_vsphere/get_role.py +23 -13
pulumi_vsphere/get_tag.py +16 -9
pulumi_vsphere/get_tag_category.py +16 -9
pulumi_vsphere/get_vapp_container.py +15 -9
pulumi_vsphere/get_virtual_machine.py +205 -48
pulumi_vsphere/get_vmfs_disks.py +18 -9
pulumi_vsphere/guest_os_customization.py +60 -5
pulumi_vsphere/ha_vm_override.py +352 -380
pulumi_vsphere/host.py +244 -64
pulumi_vsphere/host_port_group.py +27 -24
pulumi_vsphere/host_virtual_switch.py +209 -289
pulumi_vsphere/license.py +5 -32
pulumi_vsphere/nas_datastore.py +74 -9
pulumi_vsphere/offline_software_depot.py +185 -0
pulumi_vsphere/outputs.py +717 -270
pulumi_vsphere/provider.py +7 -6
pulumi_vsphere/pulumi-plugin.json +2 -1
pulumi_vsphere/resource_pool.py +168 -411
pulumi_vsphere/role.py +33 -2
pulumi_vsphere/storage_drs_vm_override.py +133 -2
pulumi_vsphere/supervisor.py +967 -0
pulumi_vsphere/tag.py +159 -2
pulumi_vsphere/tag_category.py +83 -2
pulumi_vsphere/vapp_container.py +163 -2
pulumi_vsphere/vapp_entity.py +147 -2
pulumi_vsphere/virtual_disk.py +123 -36
pulumi_vsphere/virtual_machine.py +698 -829
pulumi_vsphere/virtual_machine_class.py +447 -0
pulumi_vsphere/virtual_machine_snapshot.py +13 -12
pulumi_vsphere/vm_storage_policy.py +120 -127
pulumi_vsphere/vmfs_datastore.py +271 -2
pulumi_vsphere/vnic.py +104 -105
{pulumi_vsphere-4.10.0a1710245029.dist-info → pulumi_vsphere-4.13.0a1736836157.dist-info}/METADATA +7 -6
pulumi_vsphere-4.13.0a1736836157.dist-info/RECORD +86 -0
{pulumi_vsphere-4.10.0a1710245029.dist-info → pulumi_vsphere-4.13.0a1736836157.dist-info}/WHEEL +1 -1
pulumi_vsphere-4.10.0a1710245029.dist-info/RECORD +0 -82
{pulumi_vsphere-4.10.0a1710245029.dist-info → pulumi_vsphere-4.13.0a1736836157.dist-info}/top_level.txt +0 -0

pulumi_vsphere/host_virtual_switch.py CHANGED Viewed

@@ -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__ = ['HostVirtualSwitchArgs', 'HostVirtualSwitch']
@@ -37,58 +42,37 @@ class HostVirtualSwitchArgs:
                  teaming_policy: Optional[pulumi.Input[str]] = None):
         """
         The set of arguments for constructing a HostVirtualSwitch resource.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: The list of active network adapters used for load
-               balancing.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: List of active network adapters used for load balancing.
         :param pulumi.Input[str] host_system_id: The managed object ID of
                the host to set the virtual switch up on. Forces a new resource if changed.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The network interfaces to bind to the bridge.
-        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual
-               network adapter is allowed to send network traffic with a different MAC
-               address than that of its own. Default: `true`.
-        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
-               Control (MAC) address can be changed. Default: `true`.
-        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
-               flag indicates whether or not all traffic is seen on a given port. Default:
-               `false`.
-        :param pulumi.Input[int] beacon_interval: The interval, in seconds, that a NIC beacon
-               packet is sent out. This can be used with `check_beacon` to
-               offer link failure capability beyond link status only. Default: `1`.
-        :param pulumi.Input[bool] check_beacon: Enable beacon probing - this requires that the
-               `beacon_interval` option has been set in the bridge
-               options. If this is set to `false`, only link status is used to check for
-               failed NICs.  Default: `false`.
-        :param pulumi.Input[bool] failback: If set to `true`, the teaming policy will re-activate
-               failed interfaces higher in precedence when they come back up.  Default:
-               `true`.
-        :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
-               for link discovery traffic. Default: `listen`.
-        :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type.  Valid
-               types are `cpd` and `lldp`. Default: `cdp`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The list of network adapters to bind to this virtual switch.
+        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
+               that of its own.
+        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
+        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
+        :param pulumi.Input[int] beacon_interval: Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
+        :param pulumi.Input[bool] check_beacon: Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
+               only.
+        :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
+        :param pulumi.Input[str] link_discovery_operation: Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
+        :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid values are cdp and lldp.
         :param pulumi.Input[int] mtu: The maximum transmission unit (MTU) for the virtual
                switch. Default: `1500`.
         :param pulumi.Input[str] name: The name of the virtual switch. Forces a new resource if
                changed.
-        :param pulumi.Input[bool] notify_switches: If set to `true`, the teaming policy will
-               notify the broadcast network of a NIC failover, triggering cache updates.
-               Default: `true`.
+        :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
         :param pulumi.Input[int] number_of_ports: The number of ports to create with this
                virtual switch. Default: `128`.
                > **NOTE:** Changing the port count requires a reboot of the host. This provider
                will not restart the host for you.
-        :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per
-               second if traffic shaping is enabled. Default: `0`
-        :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if
-               shaping is enabled. Default: `0`
-        :param pulumi.Input[bool] shaping_enabled: Set to `true` to enable the traffic shaper for
-               ports managed by this virtual switch. Default: `false`.
-        :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in
-               bits per second if traffic shaping is enabled. Default: `0`
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: The list of standby network adapters used for
-               failover.
-        :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one
-               of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
-               `failover_explicit`. Default: `loadbalance_srcid`.
+        :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per second if traffic shaping is enabled.
+        :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if traffic shaping is enabled.
+        :param pulumi.Input[bool] shaping_enabled: Enable traffic shaping on this virtual switch or port group.
+        :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: List of standby network adapters used for failover.
+        :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
+               failover_explicit.
         """
         pulumi.set(__self__, "active_nics", active_nics)
         pulumi.set(__self__, "host_system_id", host_system_id)
@@ -134,8 +118,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="activeNics")
     def active_nics(self) -> pulumi.Input[Sequence[pulumi.Input[str]]]:
         """
-        The list of active network adapters used for load
-        balancing.
+        List of active network adapters used for load balancing.
         """
         return pulumi.get(self, "active_nics")
@@ -160,7 +143,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="networkAdapters")
     def network_adapters(self) -> pulumi.Input[Sequence[pulumi.Input[str]]]:
         """
-        The network interfaces to bind to the bridge.
+        The list of network adapters to bind to this virtual switch.
         """
         return pulumi.get(self, "network_adapters")
@@ -172,9 +155,8 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="allowForgedTransmits")
     def allow_forged_transmits(self) -> Optional[pulumi.Input[bool]]:
         """
-        Controls whether or not the virtual
-        network adapter is allowed to send network traffic with a different MAC
-        address than that of its own. Default: `true`.
+        Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
+        that of its own.
         """
         return pulumi.get(self, "allow_forged_transmits")
@@ -186,8 +168,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="allowMacChanges")
     def allow_mac_changes(self) -> Optional[pulumi.Input[bool]]:
         """
-        Controls whether or not the Media Access
-        Control (MAC) address can be changed. Default: `true`.
+        Controls whether or not the Media Access Control (MAC) address can be changed.
         """
         return pulumi.get(self, "allow_mac_changes")
@@ -199,9 +180,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="allowPromiscuous")
     def allow_promiscuous(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable promiscuous mode on the network. This
-        flag indicates whether or not all traffic is seen on a given port. Default:
-        `false`.
+        Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
         """
         return pulumi.get(self, "allow_promiscuous")
@@ -213,9 +192,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="beaconInterval")
     def beacon_interval(self) -> Optional[pulumi.Input[int]]:
         """
-        The interval, in seconds, that a NIC beacon
-        packet is sent out. This can be used with `check_beacon` to
-        offer link failure capability beyond link status only. Default: `1`.
+        Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
         """
         return pulumi.get(self, "beacon_interval")
@@ -227,10 +204,8 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="checkBeacon")
     def check_beacon(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable beacon probing - this requires that the
-        `beacon_interval` option has been set in the bridge
-        options. If this is set to `false`, only link status is used to check for
-        failed NICs.  Default: `false`.
+        Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
+        only.
         """
         return pulumi.get(self, "check_beacon")
@@ -242,9 +217,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter
     def failback(self) -> Optional[pulumi.Input[bool]]:
         """
-        If set to `true`, the teaming policy will re-activate
-        failed interfaces higher in precedence when they come back up.  Default:
-        `true`.
+        If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
         """
         return pulumi.get(self, "failback")
@@ -256,8 +229,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="linkDiscoveryOperation")
     def link_discovery_operation(self) -> Optional[pulumi.Input[str]]:
         """
-        Whether to `advertise` or `listen`
-        for link discovery traffic. Default: `listen`.
+        Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
         """
         return pulumi.get(self, "link_discovery_operation")
@@ -269,8 +241,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="linkDiscoveryProtocol")
     def link_discovery_protocol(self) -> Optional[pulumi.Input[str]]:
         """
-        The discovery protocol type.  Valid
-        types are `cpd` and `lldp`. Default: `cdp`.
+        The discovery protocol type. Valid values are cdp and lldp.
         """
         return pulumi.get(self, "link_discovery_protocol")
@@ -308,9 +279,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="notifySwitches")
     def notify_switches(self) -> Optional[pulumi.Input[bool]]:
         """
-        If set to `true`, the teaming policy will
-        notify the broadcast network of a NIC failover, triggering cache updates.
-        Default: `true`.
+        If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
         """
         return pulumi.get(self, "notify_switches")
@@ -338,8 +307,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="shapingAverageBandwidth")
     def shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
         """
-        The average bandwidth in bits per
-        second if traffic shaping is enabled. Default: `0`
+        The average bandwidth in bits per second if traffic shaping is enabled.
         """
         return pulumi.get(self, "shaping_average_bandwidth")
@@ -351,8 +319,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="shapingBurstSize")
     def shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum burst size allowed in bytes if
-        shaping is enabled. Default: `0`
+        The maximum burst size allowed in bytes if traffic shaping is enabled.
         """
         return pulumi.get(self, "shaping_burst_size")
@@ -364,8 +331,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="shapingEnabled")
     def shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Set to `true` to enable the traffic shaper for
-        ports managed by this virtual switch. Default: `false`.
+        Enable traffic shaping on this virtual switch or port group.
         """
         return pulumi.get(self, "shaping_enabled")
@@ -377,8 +343,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="shapingPeakBandwidth")
     def shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
         """
-        The peak bandwidth during bursts in
-        bits per second if traffic shaping is enabled. Default: `0`
+        The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
         """
         return pulumi.get(self, "shaping_peak_bandwidth")
@@ -390,8 +355,7 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="standbyNics")
     def standby_nics(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        The list of standby network adapters used for
-        failover.
+        List of standby network adapters used for failover.
         """
         return pulumi.get(self, "standby_nics")
@@ -403,9 +367,8 @@ class HostVirtualSwitchArgs:
     @pulumi.getter(name="teamingPolicy")
     def teaming_policy(self) -> Optional[pulumi.Input[str]]:
         """
-        The network adapter teaming policy. Can be one
-        of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
-        `failover_explicit`. Default: `loadbalance_srcid`.
+        The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
+        failover_explicit.
         """
         return pulumi.get(self, "teaming_policy")
@@ -440,58 +403,37 @@ class _HostVirtualSwitchState:
                  teaming_policy: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering HostVirtualSwitch resources.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: The list of active network adapters used for load
-               balancing.
-        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual
-               network adapter is allowed to send network traffic with a different MAC
-               address than that of its own. Default: `true`.
-        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
-               Control (MAC) address can be changed. Default: `true`.
-        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
-               flag indicates whether or not all traffic is seen on a given port. Default:
-               `false`.
-        :param pulumi.Input[int] beacon_interval: The interval, in seconds, that a NIC beacon
-               packet is sent out. This can be used with `check_beacon` to
-               offer link failure capability beyond link status only. Default: `1`.
-        :param pulumi.Input[bool] check_beacon: Enable beacon probing - this requires that the
-               `beacon_interval` option has been set in the bridge
-               options. If this is set to `false`, only link status is used to check for
-               failed NICs.  Default: `false`.
-        :param pulumi.Input[bool] failback: If set to `true`, the teaming policy will re-activate
-               failed interfaces higher in precedence when they come back up.  Default:
-               `true`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: List of active network adapters used for load balancing.
+        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
+               that of its own.
+        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
+        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
+        :param pulumi.Input[int] beacon_interval: Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
+        :param pulumi.Input[bool] check_beacon: Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
+               only.
+        :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
         :param pulumi.Input[str] host_system_id: The managed object ID of
                the host to set the virtual switch up on. Forces a new resource if changed.
-        :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
-               for link discovery traffic. Default: `listen`.
-        :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type.  Valid
-               types are `cpd` and `lldp`. Default: `cdp`.
+        :param pulumi.Input[str] link_discovery_operation: Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
+        :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid values are cdp and lldp.
         :param pulumi.Input[int] mtu: The maximum transmission unit (MTU) for the virtual
                switch. Default: `1500`.
         :param pulumi.Input[str] name: The name of the virtual switch. Forces a new resource if
                changed.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The network interfaces to bind to the bridge.
-        :param pulumi.Input[bool] notify_switches: If set to `true`, the teaming policy will
-               notify the broadcast network of a NIC failover, triggering cache updates.
-               Default: `true`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The list of network adapters to bind to this virtual switch.
+        :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
         :param pulumi.Input[int] number_of_ports: The number of ports to create with this
                virtual switch. Default: `128`.
                > **NOTE:** Changing the port count requires a reboot of the host. This provider
                will not restart the host for you.
-        :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per
-               second if traffic shaping is enabled. Default: `0`
-        :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if
-               shaping is enabled. Default: `0`
-        :param pulumi.Input[bool] shaping_enabled: Set to `true` to enable the traffic shaper for
-               ports managed by this virtual switch. Default: `false`.
-        :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in
-               bits per second if traffic shaping is enabled. Default: `0`
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: The list of standby network adapters used for
-               failover.
-        :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one
-               of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
-               `failover_explicit`. Default: `loadbalance_srcid`.
+        :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per second if traffic shaping is enabled.
+        :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if traffic shaping is enabled.
+        :param pulumi.Input[bool] shaping_enabled: Enable traffic shaping on this virtual switch or port group.
+        :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: List of standby network adapters used for failover.
+        :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
+               failover_explicit.
         """
         if active_nics is not None:
             pulumi.set(__self__, "active_nics", active_nics)
@@ -540,8 +482,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="activeNics")
     def active_nics(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        The list of active network adapters used for load
-        balancing.
+        List of active network adapters used for load balancing.
         """
         return pulumi.get(self, "active_nics")
@@ -553,9 +494,8 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="allowForgedTransmits")
     def allow_forged_transmits(self) -> Optional[pulumi.Input[bool]]:
         """
-        Controls whether or not the virtual
-        network adapter is allowed to send network traffic with a different MAC
-        address than that of its own. Default: `true`.
+        Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
+        that of its own.
         """
         return pulumi.get(self, "allow_forged_transmits")
@@ -567,8 +507,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="allowMacChanges")
     def allow_mac_changes(self) -> Optional[pulumi.Input[bool]]:
         """
-        Controls whether or not the Media Access
-        Control (MAC) address can be changed. Default: `true`.
+        Controls whether or not the Media Access Control (MAC) address can be changed.
         """
         return pulumi.get(self, "allow_mac_changes")
@@ -580,9 +519,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="allowPromiscuous")
     def allow_promiscuous(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable promiscuous mode on the network. This
-        flag indicates whether or not all traffic is seen on a given port. Default:
-        `false`.
+        Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
         """
         return pulumi.get(self, "allow_promiscuous")
@@ -594,9 +531,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="beaconInterval")
     def beacon_interval(self) -> Optional[pulumi.Input[int]]:
         """
-        The interval, in seconds, that a NIC beacon
-        packet is sent out. This can be used with `check_beacon` to
-        offer link failure capability beyond link status only. Default: `1`.
+        Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
         """
         return pulumi.get(self, "beacon_interval")
@@ -608,10 +543,8 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="checkBeacon")
     def check_beacon(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable beacon probing - this requires that the
-        `beacon_interval` option has been set in the bridge
-        options. If this is set to `false`, only link status is used to check for
-        failed NICs.  Default: `false`.
+        Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
+        only.
         """
         return pulumi.get(self, "check_beacon")
@@ -623,9 +556,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter
     def failback(self) -> Optional[pulumi.Input[bool]]:
         """
-        If set to `true`, the teaming policy will re-activate
-        failed interfaces higher in precedence when they come back up.  Default:
-        `true`.
+        If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
         """
         return pulumi.get(self, "failback")
@@ -650,8 +581,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="linkDiscoveryOperation")
     def link_discovery_operation(self) -> Optional[pulumi.Input[str]]:
         """
-        Whether to `advertise` or `listen`
-        for link discovery traffic. Default: `listen`.
+        Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
         """
         return pulumi.get(self, "link_discovery_operation")
@@ -663,8 +593,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="linkDiscoveryProtocol")
     def link_discovery_protocol(self) -> Optional[pulumi.Input[str]]:
         """
-        The discovery protocol type.  Valid
-        types are `cpd` and `lldp`. Default: `cdp`.
+        The discovery protocol type. Valid values are cdp and lldp.
         """
         return pulumi.get(self, "link_discovery_protocol")
@@ -702,7 +631,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="networkAdapters")
     def network_adapters(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        The network interfaces to bind to the bridge.
+        The list of network adapters to bind to this virtual switch.
         """
         return pulumi.get(self, "network_adapters")
@@ -714,9 +643,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="notifySwitches")
     def notify_switches(self) -> Optional[pulumi.Input[bool]]:
         """
-        If set to `true`, the teaming policy will
-        notify the broadcast network of a NIC failover, triggering cache updates.
-        Default: `true`.
+        If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
         """
         return pulumi.get(self, "notify_switches")
@@ -744,8 +671,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="shapingAverageBandwidth")
     def shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
         """
-        The average bandwidth in bits per
-        second if traffic shaping is enabled. Default: `0`
+        The average bandwidth in bits per second if traffic shaping is enabled.
         """
         return pulumi.get(self, "shaping_average_bandwidth")
@@ -757,8 +683,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="shapingBurstSize")
     def shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum burst size allowed in bytes if
-        shaping is enabled. Default: `0`
+        The maximum burst size allowed in bytes if traffic shaping is enabled.
         """
         return pulumi.get(self, "shaping_burst_size")
@@ -770,8 +695,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="shapingEnabled")
     def shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Set to `true` to enable the traffic shaper for
-        ports managed by this virtual switch. Default: `false`.
+        Enable traffic shaping on this virtual switch or port group.
         """
         return pulumi.get(self, "shaping_enabled")
@@ -783,8 +707,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="shapingPeakBandwidth")
     def shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
         """
-        The peak bandwidth during bursts in
-        bits per second if traffic shaping is enabled. Default: `0`
+        The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
         """
         return pulumi.get(self, "shaping_peak_bandwidth")
@@ -796,8 +719,7 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="standbyNics")
     def standby_nics(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        The list of standby network adapters used for
-        failover.
+        List of standby network adapters used for failover.
         """
         return pulumi.get(self, "standby_nics")
@@ -809,9 +731,8 @@ class _HostVirtualSwitchState:
     @pulumi.getter(name="teamingPolicy")
     def teaming_policy(self) -> Optional[pulumi.Input[str]]:
         """
-        The network adapter teaming policy. Can be one
-        of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
-        `failover_explicit`. Default: `loadbalance_srcid`.
+        The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
+        failover_explicit.
         """
         return pulumi.get(self, "teaming_policy")
@@ -848,61 +769,71 @@ class HostVirtualSwitch(pulumi.CustomResource):
                  teaming_policy: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Create a HostVirtualSwitch resource with the given unique name, props, and options.
+        The `HostVirtualSwitch` resource can be used to manage vSphere
+        standard switches on an ESXi host. These switches can be used as a backing for
+        standard port groups, which can be managed by the
+        `HostPortGroup` resource.
+        For an overview on vSphere networking concepts, see [this
+        page][ref-vsphere-net-concepts].
+        [ref-vsphere-net-concepts]: https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.networking.doc/GUID-2B11DBB8-CB3C-4AFF-8885-EFEA0FC562F4.html
+        ## Example Usage
+        ## Import
+        An existing vSwitch can be imported into this resource by its ID.
+        The convention of the id is a prefix, the host system [managed objectID][docs-about-morefs], and the virtual switch
+        name. An example would be `tf-HostVirtualSwitch:host-10:vSwitchTerraformTest`.
+        Import can the be done via the following command:
+        [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
+        ```sh
+        $ pulumi import vsphere:index/hostVirtualSwitch:HostVirtualSwitch switch tf-HostVirtualSwitch:host-10:vSwitchTerraformTest
+        ```
+        The above would import the vSwitch named `vSwitchTerraformTest` that is located in the `host-10`
+        vSphere host.
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: The list of active network adapters used for load
-               balancing.
-        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual
-               network adapter is allowed to send network traffic with a different MAC
-               address than that of its own. Default: `true`.
-        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
-               Control (MAC) address can be changed. Default: `true`.
-        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
-               flag indicates whether or not all traffic is seen on a given port. Default:
-               `false`.
-        :param pulumi.Input[int] beacon_interval: The interval, in seconds, that a NIC beacon
-               packet is sent out. This can be used with `check_beacon` to
-               offer link failure capability beyond link status only. Default: `1`.
-        :param pulumi.Input[bool] check_beacon: Enable beacon probing - this requires that the
-               `beacon_interval` option has been set in the bridge
-               options. If this is set to `false`, only link status is used to check for
-               failed NICs.  Default: `false`.
-        :param pulumi.Input[bool] failback: If set to `true`, the teaming policy will re-activate
-               failed interfaces higher in precedence when they come back up.  Default:
-               `true`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: List of active network adapters used for load balancing.
+        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
+               that of its own.
+        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
+        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
+        :param pulumi.Input[int] beacon_interval: Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
+        :param pulumi.Input[bool] check_beacon: Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
+               only.
+        :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
         :param pulumi.Input[str] host_system_id: The managed object ID of
                the host to set the virtual switch up on. Forces a new resource if changed.
-        :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
-               for link discovery traffic. Default: `listen`.
-        :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type.  Valid
-               types are `cpd` and `lldp`. Default: `cdp`.
+        :param pulumi.Input[str] link_discovery_operation: Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
+        :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid values are cdp and lldp.
         :param pulumi.Input[int] mtu: The maximum transmission unit (MTU) for the virtual
                switch. Default: `1500`.
         :param pulumi.Input[str] name: The name of the virtual switch. Forces a new resource if
                changed.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The network interfaces to bind to the bridge.
-        :param pulumi.Input[bool] notify_switches: If set to `true`, the teaming policy will
-               notify the broadcast network of a NIC failover, triggering cache updates.
-               Default: `true`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The list of network adapters to bind to this virtual switch.
+        :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
         :param pulumi.Input[int] number_of_ports: The number of ports to create with this
                virtual switch. Default: `128`.
                > **NOTE:** Changing the port count requires a reboot of the host. This provider
                will not restart the host for you.
-        :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per
-               second if traffic shaping is enabled. Default: `0`
-        :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if
-               shaping is enabled. Default: `0`
-        :param pulumi.Input[bool] shaping_enabled: Set to `true` to enable the traffic shaper for
-               ports managed by this virtual switch. Default: `false`.
-        :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in
-               bits per second if traffic shaping is enabled. Default: `0`
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: The list of standby network adapters used for
-               failover.
-        :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one
-               of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
-               `failover_explicit`. Default: `loadbalance_srcid`.
+        :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per second if traffic shaping is enabled.
+        :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if traffic shaping is enabled.
+        :param pulumi.Input[bool] shaping_enabled: Enable traffic shaping on this virtual switch or port group.
+        :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: List of standby network adapters used for failover.
+        :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
+               failover_explicit.
         """
         ...
     @overload
@@ -911,7 +842,38 @@ class HostVirtualSwitch(pulumi.CustomResource):
                  args: HostVirtualSwitchArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a HostVirtualSwitch resource with the given unique name, props, and options.
+        The `HostVirtualSwitch` resource can be used to manage vSphere
+        standard switches on an ESXi host. These switches can be used as a backing for
+        standard port groups, which can be managed by the
+        `HostPortGroup` resource.
+        For an overview on vSphere networking concepts, see [this
+        page][ref-vsphere-net-concepts].
+        [ref-vsphere-net-concepts]: https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.networking.doc/GUID-2B11DBB8-CB3C-4AFF-8885-EFEA0FC562F4.html
+        ## Example Usage
+        ## Import
+        An existing vSwitch can be imported into this resource by its ID.
+        The convention of the id is a prefix, the host system [managed objectID][docs-about-morefs], and the virtual switch
+        name. An example would be `tf-HostVirtualSwitch:host-10:vSwitchTerraformTest`.
+        Import can the be done via the following command:
+        [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
+        ```sh
+        $ pulumi import vsphere:index/hostVirtualSwitch:HostVirtualSwitch switch tf-HostVirtualSwitch:host-10:vSwitchTerraformTest
+        ```
+        The above would import the vSwitch named `vSwitchTerraformTest` that is located in the `host-10`
+        vSphere host.
         :param str resource_name: The name of the resource.
         :param HostVirtualSwitchArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -1022,58 +984,37 @@ class HostVirtualSwitch(pulumi.CustomResource):
         :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[str]]] active_nics: The list of active network adapters used for load
-               balancing.
-        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual
-               network adapter is allowed to send network traffic with a different MAC
-               address than that of its own. Default: `true`.
-        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
-               Control (MAC) address can be changed. Default: `true`.
-        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
-               flag indicates whether or not all traffic is seen on a given port. Default:
-               `false`.
-        :param pulumi.Input[int] beacon_interval: The interval, in seconds, that a NIC beacon
-               packet is sent out. This can be used with `check_beacon` to
-               offer link failure capability beyond link status only. Default: `1`.
-        :param pulumi.Input[bool] check_beacon: Enable beacon probing - this requires that the
-               `beacon_interval` option has been set in the bridge
-               options. If this is set to `false`, only link status is used to check for
-               failed NICs.  Default: `false`.
-        :param pulumi.Input[bool] failback: If set to `true`, the teaming policy will re-activate
-               failed interfaces higher in precedence when they come back up.  Default:
-               `true`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: List of active network adapters used for load balancing.
+        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
+               that of its own.
+        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
+        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
+        :param pulumi.Input[int] beacon_interval: Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
+        :param pulumi.Input[bool] check_beacon: Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
+               only.
+        :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
         :param pulumi.Input[str] host_system_id: The managed object ID of
                the host to set the virtual switch up on. Forces a new resource if changed.
-        :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
-               for link discovery traffic. Default: `listen`.
-        :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type.  Valid
-               types are `cpd` and `lldp`. Default: `cdp`.
+        :param pulumi.Input[str] link_discovery_operation: Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
+        :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid values are cdp and lldp.
         :param pulumi.Input[int] mtu: The maximum transmission unit (MTU) for the virtual
                switch. Default: `1500`.
         :param pulumi.Input[str] name: The name of the virtual switch. Forces a new resource if
                changed.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The network interfaces to bind to the bridge.
-        :param pulumi.Input[bool] notify_switches: If set to `true`, the teaming policy will
-               notify the broadcast network of a NIC failover, triggering cache updates.
-               Default: `true`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The list of network adapters to bind to this virtual switch.
+        :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
         :param pulumi.Input[int] number_of_ports: The number of ports to create with this
                virtual switch. Default: `128`.
                > **NOTE:** Changing the port count requires a reboot of the host. This provider
                will not restart the host for you.
-        :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per
-               second if traffic shaping is enabled. Default: `0`
-        :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if
-               shaping is enabled. Default: `0`
-        :param pulumi.Input[bool] shaping_enabled: Set to `true` to enable the traffic shaper for
-               ports managed by this virtual switch. Default: `false`.
-        :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in
-               bits per second if traffic shaping is enabled. Default: `0`
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: The list of standby network adapters used for
-               failover.
-        :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one
-               of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
-               `failover_explicit`. Default: `loadbalance_srcid`.
+        :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per second if traffic shaping is enabled.
+        :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if traffic shaping is enabled.
+        :param pulumi.Input[bool] shaping_enabled: Enable traffic shaping on this virtual switch or port group.
+        :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: List of standby network adapters used for failover.
+        :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
+               failover_explicit.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -1106,8 +1047,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="activeNics")
     def active_nics(self) -> pulumi.Output[Sequence[str]]:
         """
-        The list of active network adapters used for load
-        balancing.
+        List of active network adapters used for load balancing.
         """
         return pulumi.get(self, "active_nics")
@@ -1115,9 +1055,8 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="allowForgedTransmits")
     def allow_forged_transmits(self) -> pulumi.Output[Optional[bool]]:
         """
-        Controls whether or not the virtual
-        network adapter is allowed to send network traffic with a different MAC
-        address than that of its own. Default: `true`.
+        Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
+        that of its own.
         """
         return pulumi.get(self, "allow_forged_transmits")
@@ -1125,8 +1064,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="allowMacChanges")
     def allow_mac_changes(self) -> pulumi.Output[Optional[bool]]:
         """
-        Controls whether or not the Media Access
-        Control (MAC) address can be changed. Default: `true`.
+        Controls whether or not the Media Access Control (MAC) address can be changed.
         """
         return pulumi.get(self, "allow_mac_changes")
@@ -1134,9 +1072,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="allowPromiscuous")
     def allow_promiscuous(self) -> pulumi.Output[Optional[bool]]:
         """
-        Enable promiscuous mode on the network. This
-        flag indicates whether or not all traffic is seen on a given port. Default:
-        `false`.
+        Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
         """
         return pulumi.get(self, "allow_promiscuous")
@@ -1144,9 +1080,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="beaconInterval")
     def beacon_interval(self) -> pulumi.Output[Optional[int]]:
         """
-        The interval, in seconds, that a NIC beacon
-        packet is sent out. This can be used with `check_beacon` to
-        offer link failure capability beyond link status only. Default: `1`.
+        Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
         """
         return pulumi.get(self, "beacon_interval")
@@ -1154,10 +1088,8 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="checkBeacon")
     def check_beacon(self) -> pulumi.Output[Optional[bool]]:
         """
-        Enable beacon probing - this requires that the
-        `beacon_interval` option has been set in the bridge
-        options. If this is set to `false`, only link status is used to check for
-        failed NICs.  Default: `false`.
+        Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
+        only.
         """
         return pulumi.get(self, "check_beacon")
@@ -1165,9 +1097,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter
     def failback(self) -> pulumi.Output[Optional[bool]]:
         """
-        If set to `true`, the teaming policy will re-activate
-        failed interfaces higher in precedence when they come back up.  Default:
-        `true`.
+        If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
         """
         return pulumi.get(self, "failback")
@@ -1184,8 +1114,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="linkDiscoveryOperation")
     def link_discovery_operation(self) -> pulumi.Output[Optional[str]]:
         """
-        Whether to `advertise` or `listen`
-        for link discovery traffic. Default: `listen`.
+        Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
         """
         return pulumi.get(self, "link_discovery_operation")
@@ -1193,8 +1122,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="linkDiscoveryProtocol")
     def link_discovery_protocol(self) -> pulumi.Output[Optional[str]]:
         """
-        The discovery protocol type.  Valid
-        types are `cpd` and `lldp`. Default: `cdp`.
+        The discovery protocol type. Valid values are cdp and lldp.
         """
         return pulumi.get(self, "link_discovery_protocol")
@@ -1220,7 +1148,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="networkAdapters")
     def network_adapters(self) -> pulumi.Output[Sequence[str]]:
         """
-        The network interfaces to bind to the bridge.
+        The list of network adapters to bind to this virtual switch.
         """
         return pulumi.get(self, "network_adapters")
@@ -1228,9 +1156,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="notifySwitches")
     def notify_switches(self) -> pulumi.Output[Optional[bool]]:
         """
-        If set to `true`, the teaming policy will
-        notify the broadcast network of a NIC failover, triggering cache updates.
-        Default: `true`.
+        If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
         """
         return pulumi.get(self, "notify_switches")
@@ -1250,8 +1176,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="shapingAverageBandwidth")
     def shaping_average_bandwidth(self) -> pulumi.Output[Optional[int]]:
         """
-        The average bandwidth in bits per
-        second if traffic shaping is enabled. Default: `0`
+        The average bandwidth in bits per second if traffic shaping is enabled.
         """
         return pulumi.get(self, "shaping_average_bandwidth")
@@ -1259,8 +1184,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="shapingBurstSize")
     def shaping_burst_size(self) -> pulumi.Output[Optional[int]]:
         """
-        The maximum burst size allowed in bytes if
-        shaping is enabled. Default: `0`
+        The maximum burst size allowed in bytes if traffic shaping is enabled.
         """
         return pulumi.get(self, "shaping_burst_size")
@@ -1268,8 +1192,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="shapingEnabled")
     def shaping_enabled(self) -> pulumi.Output[Optional[bool]]:
         """
-        Set to `true` to enable the traffic shaper for
-        ports managed by this virtual switch. Default: `false`.
+        Enable traffic shaping on this virtual switch or port group.
         """
         return pulumi.get(self, "shaping_enabled")
@@ -1277,8 +1200,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="shapingPeakBandwidth")
     def shaping_peak_bandwidth(self) -> pulumi.Output[Optional[int]]:
         """
-        The peak bandwidth during bursts in
-        bits per second if traffic shaping is enabled. Default: `0`
+        The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
         """
         return pulumi.get(self, "shaping_peak_bandwidth")
@@ -1286,8 +1208,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="standbyNics")
     def standby_nics(self) -> pulumi.Output[Optional[Sequence[str]]]:
         """
-        The list of standby network adapters used for
-        failover.
+        List of standby network adapters used for failover.
         """
         return pulumi.get(self, "standby_nics")
@@ -1295,9 +1216,8 @@ class HostVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="teamingPolicy")
     def teaming_policy(self) -> pulumi.Output[Optional[str]]:
         """
-        The network adapter teaming policy. Can be one
-        of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
-        `failover_explicit`. Default: `loadbalance_srcid`.
+        The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
+        failover_explicit.
         """
         return pulumi.get(self, "teaming_policy")

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

Potentially problematic release.

pulumi-vsphere 4.10.0a1710245029py3-none-any.whl → 4.13.0a1736836157py3-none-any.whl