pulumi-vsphere 4.10.0a1709017641__py3-none-any.whl → 4.17.0a1763710194__py3-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 (89) hide show
  1. pulumi_vsphere/__init__.py +51 -1
  2. pulumi_vsphere/_inputs.py +2568 -1025
  3. pulumi_vsphere/_utilities.py +50 -10
  4. pulumi_vsphere/compute_cluster.py +1564 -2373
  5. pulumi_vsphere/compute_cluster_host_group.py +191 -55
  6. pulumi_vsphere/compute_cluster_vm_affinity_rule.py +157 -113
  7. pulumi_vsphere/compute_cluster_vm_anti_affinity_rule.py +133 -89
  8. pulumi_vsphere/compute_cluster_vm_dependency_rule.py +314 -106
  9. pulumi_vsphere/compute_cluster_vm_group.py +256 -55
  10. pulumi_vsphere/compute_cluster_vm_host_rule.py +323 -123
  11. pulumi_vsphere/config/__init__.py +2 -1
  12. pulumi_vsphere/config/__init__.pyi +7 -2
  13. pulumi_vsphere/config/vars.py +20 -15
  14. pulumi_vsphere/configuration_profile.py +286 -0
  15. pulumi_vsphere/content_library.py +177 -71
  16. pulumi_vsphere/content_library_item.py +252 -106
  17. pulumi_vsphere/custom_attribute.py +118 -38
  18. pulumi_vsphere/datacenter.py +128 -107
  19. pulumi_vsphere/datastore_cluster.py +636 -731
  20. pulumi_vsphere/datastore_cluster_vm_anti_affinity_rule.py +251 -89
  21. pulumi_vsphere/distributed_port_group.py +1129 -967
  22. pulumi_vsphere/distributed_virtual_switch.py +1971 -2239
  23. pulumi_vsphere/distributed_virtual_switch_pvlan_mapping.py +294 -0
  24. pulumi_vsphere/dpm_host_override.py +222 -72
  25. pulumi_vsphere/drs_vm_override.py +236 -72
  26. pulumi_vsphere/entity_permissions.py +96 -69
  27. pulumi_vsphere/file.py +173 -178
  28. pulumi_vsphere/folder.py +236 -113
  29. pulumi_vsphere/get_compute_cluster.py +34 -23
  30. pulumi_vsphere/get_compute_cluster_host_group.py +52 -41
  31. pulumi_vsphere/get_configuration_profile.py +145 -0
  32. pulumi_vsphere/get_content_library.py +33 -21
  33. pulumi_vsphere/get_content_library_item.py +47 -31
  34. pulumi_vsphere/get_custom_attribute.py +26 -17
  35. pulumi_vsphere/get_datacenter.py +40 -18
  36. pulumi_vsphere/get_datastore.py +60 -24
  37. pulumi_vsphere/get_datastore_cluster.py +47 -22
  38. pulumi_vsphere/get_datastore_stats.py +204 -0
  39. pulumi_vsphere/get_distributed_virtual_switch.py +36 -23
  40. pulumi_vsphere/get_dynamic.py +55 -45
  41. pulumi_vsphere/get_folder.py +163 -25
  42. pulumi_vsphere/get_guest_os_customization.py +68 -37
  43. pulumi_vsphere/get_host.py +34 -23
  44. pulumi_vsphere/get_host_base_images.py +104 -0
  45. pulumi_vsphere/get_host_pci_device.py +78 -35
  46. pulumi_vsphere/get_host_thumbprint.py +58 -38
  47. pulumi_vsphere/get_host_vgpu_profile.py +195 -0
  48. pulumi_vsphere/get_license.py +44 -28
  49. pulumi_vsphere/get_network.py +157 -46
  50. pulumi_vsphere/get_ovf_vm_template.py +184 -301
  51. pulumi_vsphere/get_policy.py +23 -15
  52. pulumi_vsphere/get_resource_pool.py +107 -40
  53. pulumi_vsphere/get_role.py +49 -35
  54. pulumi_vsphere/get_tag.py +34 -23
  55. pulumi_vsphere/get_tag_category.py +32 -21
  56. pulumi_vsphere/get_vapp_container.py +31 -21
  57. pulumi_vsphere/get_virtual_machine.py +499 -287
  58. pulumi_vsphere/get_vmfs_disks.py +42 -29
  59. pulumi_vsphere/guest_os_customization.py +135 -79
  60. pulumi_vsphere/ha_vm_override.py +470 -577
  61. pulumi_vsphere/host.py +515 -262
  62. pulumi_vsphere/host_port_group.py +352 -355
  63. pulumi_vsphere/host_virtual_switch.py +580 -580
  64. pulumi_vsphere/license.py +110 -92
  65. pulumi_vsphere/nas_datastore.py +398 -270
  66. pulumi_vsphere/offline_software_depot.py +190 -0
  67. pulumi_vsphere/outputs.py +1582 -1027
  68. pulumi_vsphere/provider.py +172 -152
  69. pulumi_vsphere/pulumi-plugin.json +2 -1
  70. pulumi_vsphere/resource_pool.py +357 -273
  71. pulumi_vsphere/role.py +79 -47
  72. pulumi_vsphere/storage_drs_vm_override.py +225 -89
  73. pulumi_vsphere/supervisor.py +1064 -0
  74. pulumi_vsphere/tag.py +217 -55
  75. pulumi_vsphere/tag_category.py +158 -72
  76. pulumi_vsphere/vapp_container.py +425 -259
  77. pulumi_vsphere/vapp_entity.py +324 -174
  78. pulumi_vsphere/virtual_disk.py +245 -153
  79. pulumi_vsphere/virtual_machine.py +1696 -1836
  80. pulumi_vsphere/virtual_machine_class.py +448 -0
  81. pulumi_vsphere/virtual_machine_snapshot.py +137 -131
  82. pulumi_vsphere/vm_storage_policy.py +160 -154
  83. pulumi_vsphere/vmfs_datastore.py +460 -186
  84. pulumi_vsphere/vnic.py +249 -231
  85. {pulumi_vsphere-4.10.0a1709017641.dist-info → pulumi_vsphere-4.17.0a1763710194.dist-info}/METADATA +7 -6
  86. pulumi_vsphere-4.17.0a1763710194.dist-info/RECORD +89 -0
  87. {pulumi_vsphere-4.10.0a1709017641.dist-info → pulumi_vsphere-4.17.0a1763710194.dist-info}/WHEEL +1 -1
  88. pulumi_vsphere-4.10.0a1709017641.dist-info/RECORD +0 -80
  89. {pulumi_vsphere-4.10.0a1709017641.dist-info → pulumi_vsphere-4.17.0a1763710194.dist-info}/top_level.txt +0 -0
@@ -1,12 +1,17 @@
1
1
  # coding=utf-8
2
- # *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
2
+ # *** WARNING: this file was generated by pulumi-language-python. ***
3
3
  # *** Do not edit by hand unless you're certain you know what you are doing! ***
4
4
 
5
- import copy
5
+ import builtins as _builtins
6
6
  import warnings
7
+ import sys
7
8
  import pulumi
8
9
  import pulumi.runtime
9
10
  from typing import Any, Mapping, Optional, Sequence, Union, overload
11
+ if sys.version_info >= (3, 11):
12
+ from typing import NotRequired, TypedDict, TypeAlias
13
+ else:
14
+ from typing_extensions import NotRequired, TypedDict, TypeAlias
10
15
  from . import _utilities
11
16
 
12
17
  __all__ = ['HostVirtualSwitchArgs', 'HostVirtualSwitch']
@@ -14,81 +19,57 @@ __all__ = ['HostVirtualSwitchArgs', 'HostVirtualSwitch']
14
19
  @pulumi.input_type
15
20
  class HostVirtualSwitchArgs:
16
21
  def __init__(__self__, *,
17
- active_nics: pulumi.Input[Sequence[pulumi.Input[str]]],
18
- host_system_id: pulumi.Input[str],
19
- network_adapters: pulumi.Input[Sequence[pulumi.Input[str]]],
20
- allow_forged_transmits: Optional[pulumi.Input[bool]] = None,
21
- allow_mac_changes: Optional[pulumi.Input[bool]] = None,
22
- allow_promiscuous: Optional[pulumi.Input[bool]] = None,
23
- beacon_interval: Optional[pulumi.Input[int]] = None,
24
- check_beacon: Optional[pulumi.Input[bool]] = None,
25
- failback: Optional[pulumi.Input[bool]] = None,
26
- link_discovery_operation: Optional[pulumi.Input[str]] = None,
27
- link_discovery_protocol: Optional[pulumi.Input[str]] = None,
28
- mtu: Optional[pulumi.Input[int]] = None,
29
- name: Optional[pulumi.Input[str]] = None,
30
- notify_switches: Optional[pulumi.Input[bool]] = None,
31
- number_of_ports: Optional[pulumi.Input[int]] = None,
32
- shaping_average_bandwidth: Optional[pulumi.Input[int]] = None,
33
- shaping_burst_size: Optional[pulumi.Input[int]] = None,
34
- shaping_enabled: Optional[pulumi.Input[bool]] = None,
35
- shaping_peak_bandwidth: Optional[pulumi.Input[int]] = None,
36
- standby_nics: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
37
- teaming_policy: Optional[pulumi.Input[str]] = None):
22
+ active_nics: pulumi.Input[Sequence[pulumi.Input[_builtins.str]]],
23
+ host_system_id: pulumi.Input[_builtins.str],
24
+ network_adapters: pulumi.Input[Sequence[pulumi.Input[_builtins.str]]],
25
+ allow_forged_transmits: Optional[pulumi.Input[_builtins.bool]] = None,
26
+ allow_mac_changes: Optional[pulumi.Input[_builtins.bool]] = None,
27
+ allow_promiscuous: Optional[pulumi.Input[_builtins.bool]] = None,
28
+ beacon_interval: Optional[pulumi.Input[_builtins.int]] = None,
29
+ check_beacon: Optional[pulumi.Input[_builtins.bool]] = None,
30
+ failback: Optional[pulumi.Input[_builtins.bool]] = None,
31
+ link_discovery_operation: Optional[pulumi.Input[_builtins.str]] = None,
32
+ link_discovery_protocol: Optional[pulumi.Input[_builtins.str]] = None,
33
+ mtu: Optional[pulumi.Input[_builtins.int]] = None,
34
+ name: Optional[pulumi.Input[_builtins.str]] = None,
35
+ notify_switches: Optional[pulumi.Input[_builtins.bool]] = None,
36
+ number_of_ports: Optional[pulumi.Input[_builtins.int]] = None,
37
+ shaping_average_bandwidth: Optional[pulumi.Input[_builtins.int]] = None,
38
+ shaping_burst_size: Optional[pulumi.Input[_builtins.int]] = None,
39
+ shaping_enabled: Optional[pulumi.Input[_builtins.bool]] = None,
40
+ shaping_peak_bandwidth: Optional[pulumi.Input[_builtins.int]] = None,
41
+ standby_nics: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
42
+ teaming_policy: Optional[pulumi.Input[_builtins.str]] = None):
38
43
  """
39
44
  The set of arguments for constructing a HostVirtualSwitch resource.
40
- :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: The list of active network adapters used for load
41
- balancing.
42
- :param pulumi.Input[str] host_system_id: The managed object ID of
45
+ :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] active_nics: List of active network adapters used for load balancing.
46
+ :param pulumi.Input[_builtins.str] host_system_id: The managed object ID of
43
47
  the host to set the virtual switch up on. Forces a new resource if changed.
44
- :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The network interfaces to bind to the bridge.
45
- :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual
46
- network adapter is allowed to send network traffic with a different MAC
47
- address than that of its own. Default: `true`.
48
- :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
49
- Control (MAC) address can be changed. Default: `true`.
50
- :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
51
- flag indicates whether or not all traffic is seen on a given port. Default:
52
- `false`.
53
- :param pulumi.Input[int] beacon_interval: The interval, in seconds, that a NIC beacon
54
- packet is sent out. This can be used with `check_beacon` to
55
- offer link failure capability beyond link status only. Default: `1`.
56
- :param pulumi.Input[bool] check_beacon: Enable beacon probing - this requires that the
57
- `beacon_interval` option has been set in the bridge
58
- options. If this is set to `false`, only link status is used to check for
59
- failed NICs. Default: `false`.
60
- :param pulumi.Input[bool] failback: If set to `true`, the teaming policy will re-activate
61
- failed interfaces higher in precedence when they come back up. Default:
62
- `true`.
63
- :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
64
- for link discovery traffic. Default: `listen`.
65
- :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid
66
- types are `cpd` and `lldp`. Default: `cdp`.
67
- :param pulumi.Input[int] mtu: The maximum transmission unit (MTU) for the virtual
48
+ :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] network_adapters: The list of network adapters to bind to this virtual switch.
49
+ :param pulumi.Input[_builtins.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.
50
+ :param pulumi.Input[_builtins.bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
51
+ :param pulumi.Input[_builtins.bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
52
+ :param pulumi.Input[_builtins.int] beacon_interval: Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
53
+ :param pulumi.Input[_builtins.bool] check_beacon: Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used only.
54
+ :param pulumi.Input[_builtins.bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
55
+ :param pulumi.Input[_builtins.str] link_discovery_operation: Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
56
+ :param pulumi.Input[_builtins.str] link_discovery_protocol: The discovery protocol type. Valid values are cdp and lldp.
57
+ :param pulumi.Input[_builtins.int] mtu: The maximum transmission unit (MTU) for the virtual
68
58
  switch. Default: `1500`.
69
- :param pulumi.Input[str] name: The name of the virtual switch. Forces a new resource if
59
+ :param pulumi.Input[_builtins.str] name: The name of the virtual switch. Forces a new resource if
70
60
  changed.
71
- :param pulumi.Input[bool] notify_switches: If set to `true`, the teaming policy will
72
- notify the broadcast network of a NIC failover, triggering cache updates.
73
- Default: `true`.
74
- :param pulumi.Input[int] number_of_ports: The number of ports to create with this
61
+ :param pulumi.Input[_builtins.bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
62
+ :param pulumi.Input[_builtins.int] number_of_ports: The number of ports to create with this
75
63
  virtual switch. Default: `128`.
76
64
 
77
65
  > **NOTE:** Changing the port count requires a reboot of the host. This provider
78
66
  will not restart the host for you.
79
- :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per
80
- second if traffic shaping is enabled. Default: `0`
81
- :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if
82
- shaping is enabled. Default: `0`
83
- :param pulumi.Input[bool] shaping_enabled: Set to `true` to enable the traffic shaper for
84
- ports managed by this virtual switch. Default: `false`.
85
- :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in
86
- bits per second if traffic shaping is enabled. Default: `0`
87
- :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: The list of standby network adapters used for
88
- failover.
89
- :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one
90
- of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
91
- `failover_explicit`. Default: `loadbalance_srcid`.
67
+ :param pulumi.Input[_builtins.int] shaping_average_bandwidth: The average bandwidth in bits per second if traffic shaping is enabled.
68
+ :param pulumi.Input[_builtins.int] shaping_burst_size: The maximum burst size allowed in bytes if traffic shaping is enabled.
69
+ :param pulumi.Input[_builtins.bool] shaping_enabled: Enable traffic shaping on this virtual switch or port group.
70
+ :param pulumi.Input[_builtins.int] shaping_peak_bandwidth: The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
71
+ :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] standby_nics: List of standby network adapters used for failover.
72
+ :param pulumi.Input[_builtins.str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or failover_explicit.
92
73
  """
93
74
  pulumi.set(__self__, "active_nics", active_nics)
94
75
  pulumi.set(__self__, "host_system_id", host_system_id)
@@ -130,22 +111,21 @@ class HostVirtualSwitchArgs:
130
111
  if teaming_policy is not None:
131
112
  pulumi.set(__self__, "teaming_policy", teaming_policy)
132
113
 
133
- @property
114
+ @_builtins.property
134
115
  @pulumi.getter(name="activeNics")
135
- def active_nics(self) -> pulumi.Input[Sequence[pulumi.Input[str]]]:
116
+ def active_nics(self) -> pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]:
136
117
  """
137
- The list of active network adapters used for load
138
- balancing.
118
+ List of active network adapters used for load balancing.
139
119
  """
140
120
  return pulumi.get(self, "active_nics")
141
121
 
142
122
  @active_nics.setter
143
- def active_nics(self, value: pulumi.Input[Sequence[pulumi.Input[str]]]):
123
+ def active_nics(self, value: pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]):
144
124
  pulumi.set(self, "active_nics", value)
145
125
 
146
- @property
126
+ @_builtins.property
147
127
  @pulumi.getter(name="hostSystemId")
148
- def host_system_id(self) -> pulumi.Input[str]:
128
+ def host_system_id(self) -> pulumi.Input[_builtins.str]:
149
129
  """
150
130
  The managed object ID of
151
131
  the host to set the virtual switch up on. Forces a new resource if changed.
@@ -153,134 +133,120 @@ class HostVirtualSwitchArgs:
153
133
  return pulumi.get(self, "host_system_id")
154
134
 
155
135
  @host_system_id.setter
156
- def host_system_id(self, value: pulumi.Input[str]):
136
+ def host_system_id(self, value: pulumi.Input[_builtins.str]):
157
137
  pulumi.set(self, "host_system_id", value)
158
138
 
159
- @property
139
+ @_builtins.property
160
140
  @pulumi.getter(name="networkAdapters")
161
- def network_adapters(self) -> pulumi.Input[Sequence[pulumi.Input[str]]]:
141
+ def network_adapters(self) -> pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]:
162
142
  """
163
- The network interfaces to bind to the bridge.
143
+ The list of network adapters to bind to this virtual switch.
164
144
  """
165
145
  return pulumi.get(self, "network_adapters")
166
146
 
167
147
  @network_adapters.setter
168
- def network_adapters(self, value: pulumi.Input[Sequence[pulumi.Input[str]]]):
148
+ def network_adapters(self, value: pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]):
169
149
  pulumi.set(self, "network_adapters", value)
170
150
 
171
- @property
151
+ @_builtins.property
172
152
  @pulumi.getter(name="allowForgedTransmits")
173
- def allow_forged_transmits(self) -> Optional[pulumi.Input[bool]]:
153
+ def allow_forged_transmits(self) -> Optional[pulumi.Input[_builtins.bool]]:
174
154
  """
175
- Controls whether or not the virtual
176
- network adapter is allowed to send network traffic with a different MAC
177
- address than that of its own. Default: `true`.
155
+ Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
178
156
  """
179
157
  return pulumi.get(self, "allow_forged_transmits")
180
158
 
181
159
  @allow_forged_transmits.setter
182
- def allow_forged_transmits(self, value: Optional[pulumi.Input[bool]]):
160
+ def allow_forged_transmits(self, value: Optional[pulumi.Input[_builtins.bool]]):
183
161
  pulumi.set(self, "allow_forged_transmits", value)
184
162
 
185
- @property
163
+ @_builtins.property
186
164
  @pulumi.getter(name="allowMacChanges")
187
- def allow_mac_changes(self) -> Optional[pulumi.Input[bool]]:
165
+ def allow_mac_changes(self) -> Optional[pulumi.Input[_builtins.bool]]:
188
166
  """
189
- Controls whether or not the Media Access
190
- Control (MAC) address can be changed. Default: `true`.
167
+ Controls whether or not the Media Access Control (MAC) address can be changed.
191
168
  """
192
169
  return pulumi.get(self, "allow_mac_changes")
193
170
 
194
171
  @allow_mac_changes.setter
195
- def allow_mac_changes(self, value: Optional[pulumi.Input[bool]]):
172
+ def allow_mac_changes(self, value: Optional[pulumi.Input[_builtins.bool]]):
196
173
  pulumi.set(self, "allow_mac_changes", value)
197
174
 
198
- @property
175
+ @_builtins.property
199
176
  @pulumi.getter(name="allowPromiscuous")
200
- def allow_promiscuous(self) -> Optional[pulumi.Input[bool]]:
177
+ def allow_promiscuous(self) -> Optional[pulumi.Input[_builtins.bool]]:
201
178
  """
202
- Enable promiscuous mode on the network. This
203
- flag indicates whether or not all traffic is seen on a given port. Default:
204
- `false`.
179
+ Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
205
180
  """
206
181
  return pulumi.get(self, "allow_promiscuous")
207
182
 
208
183
  @allow_promiscuous.setter
209
- def allow_promiscuous(self, value: Optional[pulumi.Input[bool]]):
184
+ def allow_promiscuous(self, value: Optional[pulumi.Input[_builtins.bool]]):
210
185
  pulumi.set(self, "allow_promiscuous", value)
211
186
 
212
- @property
187
+ @_builtins.property
213
188
  @pulumi.getter(name="beaconInterval")
214
- def beacon_interval(self) -> Optional[pulumi.Input[int]]:
189
+ def beacon_interval(self) -> Optional[pulumi.Input[_builtins.int]]:
215
190
  """
216
- The interval, in seconds, that a NIC beacon
217
- packet is sent out. This can be used with `check_beacon` to
218
- offer link failure capability beyond link status only. Default: `1`.
191
+ Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
219
192
  """
220
193
  return pulumi.get(self, "beacon_interval")
221
194
 
222
195
  @beacon_interval.setter
223
- def beacon_interval(self, value: Optional[pulumi.Input[int]]):
196
+ def beacon_interval(self, value: Optional[pulumi.Input[_builtins.int]]):
224
197
  pulumi.set(self, "beacon_interval", value)
225
198
 
226
- @property
199
+ @_builtins.property
227
200
  @pulumi.getter(name="checkBeacon")
228
- def check_beacon(self) -> Optional[pulumi.Input[bool]]:
201
+ def check_beacon(self) -> Optional[pulumi.Input[_builtins.bool]]:
229
202
  """
230
- Enable beacon probing - this requires that the
231
- `beacon_interval` option has been set in the bridge
232
- options. If this is set to `false`, only link status is used to check for
233
- failed NICs. Default: `false`.
203
+ Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used only.
234
204
  """
235
205
  return pulumi.get(self, "check_beacon")
236
206
 
237
207
  @check_beacon.setter
238
- def check_beacon(self, value: Optional[pulumi.Input[bool]]):
208
+ def check_beacon(self, value: Optional[pulumi.Input[_builtins.bool]]):
239
209
  pulumi.set(self, "check_beacon", value)
240
210
 
241
- @property
211
+ @_builtins.property
242
212
  @pulumi.getter
243
- def failback(self) -> Optional[pulumi.Input[bool]]:
213
+ def failback(self) -> Optional[pulumi.Input[_builtins.bool]]:
244
214
  """
245
- If set to `true`, the teaming policy will re-activate
246
- failed interfaces higher in precedence when they come back up. Default:
247
- `true`.
215
+ If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
248
216
  """
249
217
  return pulumi.get(self, "failback")
250
218
 
251
219
  @failback.setter
252
- def failback(self, value: Optional[pulumi.Input[bool]]):
220
+ def failback(self, value: Optional[pulumi.Input[_builtins.bool]]):
253
221
  pulumi.set(self, "failback", value)
254
222
 
255
- @property
223
+ @_builtins.property
256
224
  @pulumi.getter(name="linkDiscoveryOperation")
257
- def link_discovery_operation(self) -> Optional[pulumi.Input[str]]:
225
+ def link_discovery_operation(self) -> Optional[pulumi.Input[_builtins.str]]:
258
226
  """
259
- Whether to `advertise` or `listen`
260
- for link discovery traffic. Default: `listen`.
227
+ Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
261
228
  """
262
229
  return pulumi.get(self, "link_discovery_operation")
263
230
 
264
231
  @link_discovery_operation.setter
265
- def link_discovery_operation(self, value: Optional[pulumi.Input[str]]):
232
+ def link_discovery_operation(self, value: Optional[pulumi.Input[_builtins.str]]):
266
233
  pulumi.set(self, "link_discovery_operation", value)
267
234
 
268
- @property
235
+ @_builtins.property
269
236
  @pulumi.getter(name="linkDiscoveryProtocol")
270
- def link_discovery_protocol(self) -> Optional[pulumi.Input[str]]:
237
+ def link_discovery_protocol(self) -> Optional[pulumi.Input[_builtins.str]]:
271
238
  """
272
- The discovery protocol type. Valid
273
- types are `cpd` and `lldp`. Default: `cdp`.
239
+ The discovery protocol type. Valid values are cdp and lldp.
274
240
  """
275
241
  return pulumi.get(self, "link_discovery_protocol")
276
242
 
277
243
  @link_discovery_protocol.setter
278
- def link_discovery_protocol(self, value: Optional[pulumi.Input[str]]):
244
+ def link_discovery_protocol(self, value: Optional[pulumi.Input[_builtins.str]]):
279
245
  pulumi.set(self, "link_discovery_protocol", value)
280
246
 
281
- @property
247
+ @_builtins.property
282
248
  @pulumi.getter
283
- def mtu(self) -> Optional[pulumi.Input[int]]:
249
+ def mtu(self) -> Optional[pulumi.Input[_builtins.int]]:
284
250
  """
285
251
  The maximum transmission unit (MTU) for the virtual
286
252
  switch. Default: `1500`.
@@ -288,12 +254,12 @@ class HostVirtualSwitchArgs:
288
254
  return pulumi.get(self, "mtu")
289
255
 
290
256
  @mtu.setter
291
- def mtu(self, value: Optional[pulumi.Input[int]]):
257
+ def mtu(self, value: Optional[pulumi.Input[_builtins.int]]):
292
258
  pulumi.set(self, "mtu", value)
293
259
 
294
- @property
260
+ @_builtins.property
295
261
  @pulumi.getter
296
- def name(self) -> Optional[pulumi.Input[str]]:
262
+ def name(self) -> Optional[pulumi.Input[_builtins.str]]:
297
263
  """
298
264
  The name of the virtual switch. Forces a new resource if
299
265
  changed.
@@ -301,26 +267,24 @@ class HostVirtualSwitchArgs:
301
267
  return pulumi.get(self, "name")
302
268
 
303
269
  @name.setter
304
- def name(self, value: Optional[pulumi.Input[str]]):
270
+ def name(self, value: Optional[pulumi.Input[_builtins.str]]):
305
271
  pulumi.set(self, "name", value)
306
272
 
307
- @property
273
+ @_builtins.property
308
274
  @pulumi.getter(name="notifySwitches")
309
- def notify_switches(self) -> Optional[pulumi.Input[bool]]:
275
+ def notify_switches(self) -> Optional[pulumi.Input[_builtins.bool]]:
310
276
  """
311
- If set to `true`, the teaming policy will
312
- notify the broadcast network of a NIC failover, triggering cache updates.
313
- Default: `true`.
277
+ If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
314
278
  """
315
279
  return pulumi.get(self, "notify_switches")
316
280
 
317
281
  @notify_switches.setter
318
- def notify_switches(self, value: Optional[pulumi.Input[bool]]):
282
+ def notify_switches(self, value: Optional[pulumi.Input[_builtins.bool]]):
319
283
  pulumi.set(self, "notify_switches", value)
320
284
 
321
- @property
285
+ @_builtins.property
322
286
  @pulumi.getter(name="numberOfPorts")
323
- def number_of_ports(self) -> Optional[pulumi.Input[int]]:
287
+ def number_of_ports(self) -> Optional[pulumi.Input[_builtins.int]]:
324
288
  """
325
289
  The number of ports to create with this
326
290
  virtual switch. Default: `128`.
@@ -331,167 +295,136 @@ class HostVirtualSwitchArgs:
331
295
  return pulumi.get(self, "number_of_ports")
332
296
 
333
297
  @number_of_ports.setter
334
- def number_of_ports(self, value: Optional[pulumi.Input[int]]):
298
+ def number_of_ports(self, value: Optional[pulumi.Input[_builtins.int]]):
335
299
  pulumi.set(self, "number_of_ports", value)
336
300
 
337
- @property
301
+ @_builtins.property
338
302
  @pulumi.getter(name="shapingAverageBandwidth")
339
- def shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
303
+ def shaping_average_bandwidth(self) -> Optional[pulumi.Input[_builtins.int]]:
340
304
  """
341
- The average bandwidth in bits per
342
- second if traffic shaping is enabled. Default: `0`
305
+ The average bandwidth in bits per second if traffic shaping is enabled.
343
306
  """
344
307
  return pulumi.get(self, "shaping_average_bandwidth")
345
308
 
346
309
  @shaping_average_bandwidth.setter
347
- def shaping_average_bandwidth(self, value: Optional[pulumi.Input[int]]):
310
+ def shaping_average_bandwidth(self, value: Optional[pulumi.Input[_builtins.int]]):
348
311
  pulumi.set(self, "shaping_average_bandwidth", value)
349
312
 
350
- @property
313
+ @_builtins.property
351
314
  @pulumi.getter(name="shapingBurstSize")
352
- def shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
315
+ def shaping_burst_size(self) -> Optional[pulumi.Input[_builtins.int]]:
353
316
  """
354
- The maximum burst size allowed in bytes if
355
- shaping is enabled. Default: `0`
317
+ The maximum burst size allowed in bytes if traffic shaping is enabled.
356
318
  """
357
319
  return pulumi.get(self, "shaping_burst_size")
358
320
 
359
321
  @shaping_burst_size.setter
360
- def shaping_burst_size(self, value: Optional[pulumi.Input[int]]):
322
+ def shaping_burst_size(self, value: Optional[pulumi.Input[_builtins.int]]):
361
323
  pulumi.set(self, "shaping_burst_size", value)
362
324
 
363
- @property
325
+ @_builtins.property
364
326
  @pulumi.getter(name="shapingEnabled")
365
- def shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
327
+ def shaping_enabled(self) -> Optional[pulumi.Input[_builtins.bool]]:
366
328
  """
367
- Set to `true` to enable the traffic shaper for
368
- ports managed by this virtual switch. Default: `false`.
329
+ Enable traffic shaping on this virtual switch or port group.
369
330
  """
370
331
  return pulumi.get(self, "shaping_enabled")
371
332
 
372
333
  @shaping_enabled.setter
373
- def shaping_enabled(self, value: Optional[pulumi.Input[bool]]):
334
+ def shaping_enabled(self, value: Optional[pulumi.Input[_builtins.bool]]):
374
335
  pulumi.set(self, "shaping_enabled", value)
375
336
 
376
- @property
337
+ @_builtins.property
377
338
  @pulumi.getter(name="shapingPeakBandwidth")
378
- def shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
339
+ def shaping_peak_bandwidth(self) -> Optional[pulumi.Input[_builtins.int]]:
379
340
  """
380
- The peak bandwidth during bursts in
381
- bits per second if traffic shaping is enabled. Default: `0`
341
+ The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
382
342
  """
383
343
  return pulumi.get(self, "shaping_peak_bandwidth")
384
344
 
385
345
  @shaping_peak_bandwidth.setter
386
- def shaping_peak_bandwidth(self, value: Optional[pulumi.Input[int]]):
346
+ def shaping_peak_bandwidth(self, value: Optional[pulumi.Input[_builtins.int]]):
387
347
  pulumi.set(self, "shaping_peak_bandwidth", value)
388
348
 
389
- @property
349
+ @_builtins.property
390
350
  @pulumi.getter(name="standbyNics")
391
- def standby_nics(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
351
+ def standby_nics(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]:
392
352
  """
393
- The list of standby network adapters used for
394
- failover.
353
+ List of standby network adapters used for failover.
395
354
  """
396
355
  return pulumi.get(self, "standby_nics")
397
356
 
398
357
  @standby_nics.setter
399
- def standby_nics(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
358
+ def standby_nics(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]):
400
359
  pulumi.set(self, "standby_nics", value)
401
360
 
402
- @property
361
+ @_builtins.property
403
362
  @pulumi.getter(name="teamingPolicy")
404
- def teaming_policy(self) -> Optional[pulumi.Input[str]]:
363
+ def teaming_policy(self) -> Optional[pulumi.Input[_builtins.str]]:
405
364
  """
406
- The network adapter teaming policy. Can be one
407
- of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
408
- `failover_explicit`. Default: `loadbalance_srcid`.
365
+ The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or failover_explicit.
409
366
  """
410
367
  return pulumi.get(self, "teaming_policy")
411
368
 
412
369
  @teaming_policy.setter
413
- def teaming_policy(self, value: Optional[pulumi.Input[str]]):
370
+ def teaming_policy(self, value: Optional[pulumi.Input[_builtins.str]]):
414
371
  pulumi.set(self, "teaming_policy", value)
415
372
 
416
373
 
417
374
  @pulumi.input_type
418
375
  class _HostVirtualSwitchState:
419
376
  def __init__(__self__, *,
420
- active_nics: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
421
- allow_forged_transmits: Optional[pulumi.Input[bool]] = None,
422
- allow_mac_changes: Optional[pulumi.Input[bool]] = None,
423
- allow_promiscuous: Optional[pulumi.Input[bool]] = None,
424
- beacon_interval: Optional[pulumi.Input[int]] = None,
425
- check_beacon: Optional[pulumi.Input[bool]] = None,
426
- failback: Optional[pulumi.Input[bool]] = None,
427
- host_system_id: Optional[pulumi.Input[str]] = None,
428
- link_discovery_operation: Optional[pulumi.Input[str]] = None,
429
- link_discovery_protocol: Optional[pulumi.Input[str]] = None,
430
- mtu: Optional[pulumi.Input[int]] = None,
431
- name: Optional[pulumi.Input[str]] = None,
432
- network_adapters: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
433
- notify_switches: Optional[pulumi.Input[bool]] = None,
434
- number_of_ports: Optional[pulumi.Input[int]] = None,
435
- shaping_average_bandwidth: Optional[pulumi.Input[int]] = None,
436
- shaping_burst_size: Optional[pulumi.Input[int]] = None,
437
- shaping_enabled: Optional[pulumi.Input[bool]] = None,
438
- shaping_peak_bandwidth: Optional[pulumi.Input[int]] = None,
439
- standby_nics: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
440
- teaming_policy: Optional[pulumi.Input[str]] = None):
377
+ active_nics: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
378
+ allow_forged_transmits: Optional[pulumi.Input[_builtins.bool]] = None,
379
+ allow_mac_changes: Optional[pulumi.Input[_builtins.bool]] = None,
380
+ allow_promiscuous: Optional[pulumi.Input[_builtins.bool]] = None,
381
+ beacon_interval: Optional[pulumi.Input[_builtins.int]] = None,
382
+ check_beacon: Optional[pulumi.Input[_builtins.bool]] = None,
383
+ failback: Optional[pulumi.Input[_builtins.bool]] = None,
384
+ host_system_id: Optional[pulumi.Input[_builtins.str]] = None,
385
+ link_discovery_operation: Optional[pulumi.Input[_builtins.str]] = None,
386
+ link_discovery_protocol: Optional[pulumi.Input[_builtins.str]] = None,
387
+ mtu: Optional[pulumi.Input[_builtins.int]] = None,
388
+ name: Optional[pulumi.Input[_builtins.str]] = None,
389
+ network_adapters: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
390
+ notify_switches: Optional[pulumi.Input[_builtins.bool]] = None,
391
+ number_of_ports: Optional[pulumi.Input[_builtins.int]] = None,
392
+ shaping_average_bandwidth: Optional[pulumi.Input[_builtins.int]] = None,
393
+ shaping_burst_size: Optional[pulumi.Input[_builtins.int]] = None,
394
+ shaping_enabled: Optional[pulumi.Input[_builtins.bool]] = None,
395
+ shaping_peak_bandwidth: Optional[pulumi.Input[_builtins.int]] = None,
396
+ standby_nics: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
397
+ teaming_policy: Optional[pulumi.Input[_builtins.str]] = None):
441
398
  """
442
399
  Input properties used for looking up and filtering HostVirtualSwitch resources.
443
- :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: The list of active network adapters used for load
444
- balancing.
445
- :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual
446
- network adapter is allowed to send network traffic with a different MAC
447
- address than that of its own. Default: `true`.
448
- :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
449
- Control (MAC) address can be changed. Default: `true`.
450
- :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
451
- flag indicates whether or not all traffic is seen on a given port. Default:
452
- `false`.
453
- :param pulumi.Input[int] beacon_interval: The interval, in seconds, that a NIC beacon
454
- packet is sent out. This can be used with `check_beacon` to
455
- offer link failure capability beyond link status only. Default: `1`.
456
- :param pulumi.Input[bool] check_beacon: Enable beacon probing - this requires that the
457
- `beacon_interval` option has been set in the bridge
458
- options. If this is set to `false`, only link status is used to check for
459
- failed NICs. Default: `false`.
460
- :param pulumi.Input[bool] failback: If set to `true`, the teaming policy will re-activate
461
- failed interfaces higher in precedence when they come back up. Default:
462
- `true`.
463
- :param pulumi.Input[str] host_system_id: The managed object ID of
400
+ :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] active_nics: List of active network adapters used for load balancing.
401
+ :param pulumi.Input[_builtins.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.
402
+ :param pulumi.Input[_builtins.bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
403
+ :param pulumi.Input[_builtins.bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
404
+ :param pulumi.Input[_builtins.int] beacon_interval: Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
405
+ :param pulumi.Input[_builtins.bool] check_beacon: Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used only.
406
+ :param pulumi.Input[_builtins.bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
407
+ :param pulumi.Input[_builtins.str] host_system_id: The managed object ID of
464
408
  the host to set the virtual switch up on. Forces a new resource if changed.
465
- :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
466
- for link discovery traffic. Default: `listen`.
467
- :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid
468
- types are `cpd` and `lldp`. Default: `cdp`.
469
- :param pulumi.Input[int] mtu: The maximum transmission unit (MTU) for the virtual
409
+ :param pulumi.Input[_builtins.str] link_discovery_operation: Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
410
+ :param pulumi.Input[_builtins.str] link_discovery_protocol: The discovery protocol type. Valid values are cdp and lldp.
411
+ :param pulumi.Input[_builtins.int] mtu: The maximum transmission unit (MTU) for the virtual
470
412
  switch. Default: `1500`.
471
- :param pulumi.Input[str] name: The name of the virtual switch. Forces a new resource if
413
+ :param pulumi.Input[_builtins.str] name: The name of the virtual switch. Forces a new resource if
472
414
  changed.
473
- :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The network interfaces to bind to the bridge.
474
- :param pulumi.Input[bool] notify_switches: If set to `true`, the teaming policy will
475
- notify the broadcast network of a NIC failover, triggering cache updates.
476
- Default: `true`.
477
- :param pulumi.Input[int] number_of_ports: The number of ports to create with this
415
+ :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] network_adapters: The list of network adapters to bind to this virtual switch.
416
+ :param pulumi.Input[_builtins.bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
417
+ :param pulumi.Input[_builtins.int] number_of_ports: The number of ports to create with this
478
418
  virtual switch. Default: `128`.
479
419
 
480
420
  > **NOTE:** Changing the port count requires a reboot of the host. This provider
481
421
  will not restart the host for you.
482
- :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per
483
- second if traffic shaping is enabled. Default: `0`
484
- :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if
485
- shaping is enabled. Default: `0`
486
- :param pulumi.Input[bool] shaping_enabled: Set to `true` to enable the traffic shaper for
487
- ports managed by this virtual switch. Default: `false`.
488
- :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in
489
- bits per second if traffic shaping is enabled. Default: `0`
490
- :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: The list of standby network adapters used for
491
- failover.
492
- :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one
493
- of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
494
- `failover_explicit`. Default: `loadbalance_srcid`.
422
+ :param pulumi.Input[_builtins.int] shaping_average_bandwidth: The average bandwidth in bits per second if traffic shaping is enabled.
423
+ :param pulumi.Input[_builtins.int] shaping_burst_size: The maximum burst size allowed in bytes if traffic shaping is enabled.
424
+ :param pulumi.Input[_builtins.bool] shaping_enabled: Enable traffic shaping on this virtual switch or port group.
425
+ :param pulumi.Input[_builtins.int] shaping_peak_bandwidth: The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
426
+ :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] standby_nics: List of standby network adapters used for failover.
427
+ :param pulumi.Input[_builtins.str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or failover_explicit.
495
428
  """
496
429
  if active_nics is not None:
497
430
  pulumi.set(__self__, "active_nics", active_nics)
@@ -536,106 +469,93 @@ class _HostVirtualSwitchState:
536
469
  if teaming_policy is not None:
537
470
  pulumi.set(__self__, "teaming_policy", teaming_policy)
538
471
 
539
- @property
472
+ @_builtins.property
540
473
  @pulumi.getter(name="activeNics")
541
- def active_nics(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
474
+ def active_nics(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]:
542
475
  """
543
- The list of active network adapters used for load
544
- balancing.
476
+ List of active network adapters used for load balancing.
545
477
  """
546
478
  return pulumi.get(self, "active_nics")
547
479
 
548
480
  @active_nics.setter
549
- def active_nics(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
481
+ def active_nics(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]):
550
482
  pulumi.set(self, "active_nics", value)
551
483
 
552
- @property
484
+ @_builtins.property
553
485
  @pulumi.getter(name="allowForgedTransmits")
554
- def allow_forged_transmits(self) -> Optional[pulumi.Input[bool]]:
486
+ def allow_forged_transmits(self) -> Optional[pulumi.Input[_builtins.bool]]:
555
487
  """
556
- Controls whether or not the virtual
557
- network adapter is allowed to send network traffic with a different MAC
558
- address than that of its own. Default: `true`.
488
+ Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
559
489
  """
560
490
  return pulumi.get(self, "allow_forged_transmits")
561
491
 
562
492
  @allow_forged_transmits.setter
563
- def allow_forged_transmits(self, value: Optional[pulumi.Input[bool]]):
493
+ def allow_forged_transmits(self, value: Optional[pulumi.Input[_builtins.bool]]):
564
494
  pulumi.set(self, "allow_forged_transmits", value)
565
495
 
566
- @property
496
+ @_builtins.property
567
497
  @pulumi.getter(name="allowMacChanges")
568
- def allow_mac_changes(self) -> Optional[pulumi.Input[bool]]:
498
+ def allow_mac_changes(self) -> Optional[pulumi.Input[_builtins.bool]]:
569
499
  """
570
- Controls whether or not the Media Access
571
- Control (MAC) address can be changed. Default: `true`.
500
+ Controls whether or not the Media Access Control (MAC) address can be changed.
572
501
  """
573
502
  return pulumi.get(self, "allow_mac_changes")
574
503
 
575
504
  @allow_mac_changes.setter
576
- def allow_mac_changes(self, value: Optional[pulumi.Input[bool]]):
505
+ def allow_mac_changes(self, value: Optional[pulumi.Input[_builtins.bool]]):
577
506
  pulumi.set(self, "allow_mac_changes", value)
578
507
 
579
- @property
508
+ @_builtins.property
580
509
  @pulumi.getter(name="allowPromiscuous")
581
- def allow_promiscuous(self) -> Optional[pulumi.Input[bool]]:
510
+ def allow_promiscuous(self) -> Optional[pulumi.Input[_builtins.bool]]:
582
511
  """
583
- Enable promiscuous mode on the network. This
584
- flag indicates whether or not all traffic is seen on a given port. Default:
585
- `false`.
512
+ Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
586
513
  """
587
514
  return pulumi.get(self, "allow_promiscuous")
588
515
 
589
516
  @allow_promiscuous.setter
590
- def allow_promiscuous(self, value: Optional[pulumi.Input[bool]]):
517
+ def allow_promiscuous(self, value: Optional[pulumi.Input[_builtins.bool]]):
591
518
  pulumi.set(self, "allow_promiscuous", value)
592
519
 
593
- @property
520
+ @_builtins.property
594
521
  @pulumi.getter(name="beaconInterval")
595
- def beacon_interval(self) -> Optional[pulumi.Input[int]]:
522
+ def beacon_interval(self) -> Optional[pulumi.Input[_builtins.int]]:
596
523
  """
597
- The interval, in seconds, that a NIC beacon
598
- packet is sent out. This can be used with `check_beacon` to
599
- offer link failure capability beyond link status only. Default: `1`.
524
+ Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
600
525
  """
601
526
  return pulumi.get(self, "beacon_interval")
602
527
 
603
528
  @beacon_interval.setter
604
- def beacon_interval(self, value: Optional[pulumi.Input[int]]):
529
+ def beacon_interval(self, value: Optional[pulumi.Input[_builtins.int]]):
605
530
  pulumi.set(self, "beacon_interval", value)
606
531
 
607
- @property
532
+ @_builtins.property
608
533
  @pulumi.getter(name="checkBeacon")
609
- def check_beacon(self) -> Optional[pulumi.Input[bool]]:
534
+ def check_beacon(self) -> Optional[pulumi.Input[_builtins.bool]]:
610
535
  """
611
- Enable beacon probing - this requires that the
612
- `beacon_interval` option has been set in the bridge
613
- options. If this is set to `false`, only link status is used to check for
614
- failed NICs. Default: `false`.
536
+ Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used only.
615
537
  """
616
538
  return pulumi.get(self, "check_beacon")
617
539
 
618
540
  @check_beacon.setter
619
- def check_beacon(self, value: Optional[pulumi.Input[bool]]):
541
+ def check_beacon(self, value: Optional[pulumi.Input[_builtins.bool]]):
620
542
  pulumi.set(self, "check_beacon", value)
621
543
 
622
- @property
544
+ @_builtins.property
623
545
  @pulumi.getter
624
- def failback(self) -> Optional[pulumi.Input[bool]]:
546
+ def failback(self) -> Optional[pulumi.Input[_builtins.bool]]:
625
547
  """
626
- If set to `true`, the teaming policy will re-activate
627
- failed interfaces higher in precedence when they come back up. Default:
628
- `true`.
548
+ If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
629
549
  """
630
550
  return pulumi.get(self, "failback")
631
551
 
632
552
  @failback.setter
633
- def failback(self, value: Optional[pulumi.Input[bool]]):
553
+ def failback(self, value: Optional[pulumi.Input[_builtins.bool]]):
634
554
  pulumi.set(self, "failback", value)
635
555
 
636
- @property
556
+ @_builtins.property
637
557
  @pulumi.getter(name="hostSystemId")
638
- def host_system_id(self) -> Optional[pulumi.Input[str]]:
558
+ def host_system_id(self) -> Optional[pulumi.Input[_builtins.str]]:
639
559
  """
640
560
  The managed object ID of
641
561
  the host to set the virtual switch up on. Forces a new resource if changed.
@@ -643,38 +563,36 @@ class _HostVirtualSwitchState:
643
563
  return pulumi.get(self, "host_system_id")
644
564
 
645
565
  @host_system_id.setter
646
- def host_system_id(self, value: Optional[pulumi.Input[str]]):
566
+ def host_system_id(self, value: Optional[pulumi.Input[_builtins.str]]):
647
567
  pulumi.set(self, "host_system_id", value)
648
568
 
649
- @property
569
+ @_builtins.property
650
570
  @pulumi.getter(name="linkDiscoveryOperation")
651
- def link_discovery_operation(self) -> Optional[pulumi.Input[str]]:
571
+ def link_discovery_operation(self) -> Optional[pulumi.Input[_builtins.str]]:
652
572
  """
653
- Whether to `advertise` or `listen`
654
- for link discovery traffic. Default: `listen`.
573
+ Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
655
574
  """
656
575
  return pulumi.get(self, "link_discovery_operation")
657
576
 
658
577
  @link_discovery_operation.setter
659
- def link_discovery_operation(self, value: Optional[pulumi.Input[str]]):
578
+ def link_discovery_operation(self, value: Optional[pulumi.Input[_builtins.str]]):
660
579
  pulumi.set(self, "link_discovery_operation", value)
661
580
 
662
- @property
581
+ @_builtins.property
663
582
  @pulumi.getter(name="linkDiscoveryProtocol")
664
- def link_discovery_protocol(self) -> Optional[pulumi.Input[str]]:
583
+ def link_discovery_protocol(self) -> Optional[pulumi.Input[_builtins.str]]:
665
584
  """
666
- The discovery protocol type. Valid
667
- types are `cpd` and `lldp`. Default: `cdp`.
585
+ The discovery protocol type. Valid values are cdp and lldp.
668
586
  """
669
587
  return pulumi.get(self, "link_discovery_protocol")
670
588
 
671
589
  @link_discovery_protocol.setter
672
- def link_discovery_protocol(self, value: Optional[pulumi.Input[str]]):
590
+ def link_discovery_protocol(self, value: Optional[pulumi.Input[_builtins.str]]):
673
591
  pulumi.set(self, "link_discovery_protocol", value)
674
592
 
675
- @property
593
+ @_builtins.property
676
594
  @pulumi.getter
677
- def mtu(self) -> Optional[pulumi.Input[int]]:
595
+ def mtu(self) -> Optional[pulumi.Input[_builtins.int]]:
678
596
  """
679
597
  The maximum transmission unit (MTU) for the virtual
680
598
  switch. Default: `1500`.
@@ -682,12 +600,12 @@ class _HostVirtualSwitchState:
682
600
  return pulumi.get(self, "mtu")
683
601
 
684
602
  @mtu.setter
685
- def mtu(self, value: Optional[pulumi.Input[int]]):
603
+ def mtu(self, value: Optional[pulumi.Input[_builtins.int]]):
686
604
  pulumi.set(self, "mtu", value)
687
605
 
688
- @property
606
+ @_builtins.property
689
607
  @pulumi.getter
690
- def name(self) -> Optional[pulumi.Input[str]]:
608
+ def name(self) -> Optional[pulumi.Input[_builtins.str]]:
691
609
  """
692
610
  The name of the virtual switch. Forces a new resource if
693
611
  changed.
@@ -695,38 +613,36 @@ class _HostVirtualSwitchState:
695
613
  return pulumi.get(self, "name")
696
614
 
697
615
  @name.setter
698
- def name(self, value: Optional[pulumi.Input[str]]):
616
+ def name(self, value: Optional[pulumi.Input[_builtins.str]]):
699
617
  pulumi.set(self, "name", value)
700
618
 
701
- @property
619
+ @_builtins.property
702
620
  @pulumi.getter(name="networkAdapters")
703
- def network_adapters(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
621
+ def network_adapters(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]:
704
622
  """
705
- The network interfaces to bind to the bridge.
623
+ The list of network adapters to bind to this virtual switch.
706
624
  """
707
625
  return pulumi.get(self, "network_adapters")
708
626
 
709
627
  @network_adapters.setter
710
- def network_adapters(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
628
+ def network_adapters(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]):
711
629
  pulumi.set(self, "network_adapters", value)
712
630
 
713
- @property
631
+ @_builtins.property
714
632
  @pulumi.getter(name="notifySwitches")
715
- def notify_switches(self) -> Optional[pulumi.Input[bool]]:
633
+ def notify_switches(self) -> Optional[pulumi.Input[_builtins.bool]]:
716
634
  """
717
- If set to `true`, the teaming policy will
718
- notify the broadcast network of a NIC failover, triggering cache updates.
719
- Default: `true`.
635
+ If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
720
636
  """
721
637
  return pulumi.get(self, "notify_switches")
722
638
 
723
639
  @notify_switches.setter
724
- def notify_switches(self, value: Optional[pulumi.Input[bool]]):
640
+ def notify_switches(self, value: Optional[pulumi.Input[_builtins.bool]]):
725
641
  pulumi.set(self, "notify_switches", value)
726
642
 
727
- @property
643
+ @_builtins.property
728
644
  @pulumi.getter(name="numberOfPorts")
729
- def number_of_ports(self) -> Optional[pulumi.Input[int]]:
645
+ def number_of_ports(self) -> Optional[pulumi.Input[_builtins.int]]:
730
646
  """
731
647
  The number of ports to create with this
732
648
  virtual switch. Default: `128`.
@@ -737,172 +653,223 @@ class _HostVirtualSwitchState:
737
653
  return pulumi.get(self, "number_of_ports")
738
654
 
739
655
  @number_of_ports.setter
740
- def number_of_ports(self, value: Optional[pulumi.Input[int]]):
656
+ def number_of_ports(self, value: Optional[pulumi.Input[_builtins.int]]):
741
657
  pulumi.set(self, "number_of_ports", value)
742
658
 
743
- @property
659
+ @_builtins.property
744
660
  @pulumi.getter(name="shapingAverageBandwidth")
745
- def shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
661
+ def shaping_average_bandwidth(self) -> Optional[pulumi.Input[_builtins.int]]:
746
662
  """
747
- The average bandwidth in bits per
748
- second if traffic shaping is enabled. Default: `0`
663
+ The average bandwidth in bits per second if traffic shaping is enabled.
749
664
  """
750
665
  return pulumi.get(self, "shaping_average_bandwidth")
751
666
 
752
667
  @shaping_average_bandwidth.setter
753
- def shaping_average_bandwidth(self, value: Optional[pulumi.Input[int]]):
668
+ def shaping_average_bandwidth(self, value: Optional[pulumi.Input[_builtins.int]]):
754
669
  pulumi.set(self, "shaping_average_bandwidth", value)
755
670
 
756
- @property
671
+ @_builtins.property
757
672
  @pulumi.getter(name="shapingBurstSize")
758
- def shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
673
+ def shaping_burst_size(self) -> Optional[pulumi.Input[_builtins.int]]:
759
674
  """
760
- The maximum burst size allowed in bytes if
761
- shaping is enabled. Default: `0`
675
+ The maximum burst size allowed in bytes if traffic shaping is enabled.
762
676
  """
763
677
  return pulumi.get(self, "shaping_burst_size")
764
678
 
765
679
  @shaping_burst_size.setter
766
- def shaping_burst_size(self, value: Optional[pulumi.Input[int]]):
680
+ def shaping_burst_size(self, value: Optional[pulumi.Input[_builtins.int]]):
767
681
  pulumi.set(self, "shaping_burst_size", value)
768
682
 
769
- @property
683
+ @_builtins.property
770
684
  @pulumi.getter(name="shapingEnabled")
771
- def shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
685
+ def shaping_enabled(self) -> Optional[pulumi.Input[_builtins.bool]]:
772
686
  """
773
- Set to `true` to enable the traffic shaper for
774
- ports managed by this virtual switch. Default: `false`.
687
+ Enable traffic shaping on this virtual switch or port group.
775
688
  """
776
689
  return pulumi.get(self, "shaping_enabled")
777
690
 
778
691
  @shaping_enabled.setter
779
- def shaping_enabled(self, value: Optional[pulumi.Input[bool]]):
692
+ def shaping_enabled(self, value: Optional[pulumi.Input[_builtins.bool]]):
780
693
  pulumi.set(self, "shaping_enabled", value)
781
694
 
782
- @property
695
+ @_builtins.property
783
696
  @pulumi.getter(name="shapingPeakBandwidth")
784
- def shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
697
+ def shaping_peak_bandwidth(self) -> Optional[pulumi.Input[_builtins.int]]:
785
698
  """
786
- The peak bandwidth during bursts in
787
- bits per second if traffic shaping is enabled. Default: `0`
699
+ The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
788
700
  """
789
701
  return pulumi.get(self, "shaping_peak_bandwidth")
790
702
 
791
703
  @shaping_peak_bandwidth.setter
792
- def shaping_peak_bandwidth(self, value: Optional[pulumi.Input[int]]):
704
+ def shaping_peak_bandwidth(self, value: Optional[pulumi.Input[_builtins.int]]):
793
705
  pulumi.set(self, "shaping_peak_bandwidth", value)
794
706
 
795
- @property
707
+ @_builtins.property
796
708
  @pulumi.getter(name="standbyNics")
797
- def standby_nics(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
709
+ def standby_nics(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]:
798
710
  """
799
- The list of standby network adapters used for
800
- failover.
711
+ List of standby network adapters used for failover.
801
712
  """
802
713
  return pulumi.get(self, "standby_nics")
803
714
 
804
715
  @standby_nics.setter
805
- def standby_nics(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
716
+ def standby_nics(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]):
806
717
  pulumi.set(self, "standby_nics", value)
807
718
 
808
- @property
719
+ @_builtins.property
809
720
  @pulumi.getter(name="teamingPolicy")
810
- def teaming_policy(self) -> Optional[pulumi.Input[str]]:
721
+ def teaming_policy(self) -> Optional[pulumi.Input[_builtins.str]]:
811
722
  """
812
- The network adapter teaming policy. Can be one
813
- of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
814
- `failover_explicit`. Default: `loadbalance_srcid`.
723
+ The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or failover_explicit.
815
724
  """
816
725
  return pulumi.get(self, "teaming_policy")
817
726
 
818
727
  @teaming_policy.setter
819
- def teaming_policy(self, value: Optional[pulumi.Input[str]]):
728
+ def teaming_policy(self, value: Optional[pulumi.Input[_builtins.str]]):
820
729
  pulumi.set(self, "teaming_policy", value)
821
730
 
822
731
 
732
+ @pulumi.type_token("vsphere:index/hostVirtualSwitch:HostVirtualSwitch")
823
733
  class HostVirtualSwitch(pulumi.CustomResource):
824
734
  @overload
825
735
  def __init__(__self__,
826
736
  resource_name: str,
827
737
  opts: Optional[pulumi.ResourceOptions] = None,
828
- active_nics: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
829
- allow_forged_transmits: Optional[pulumi.Input[bool]] = None,
830
- allow_mac_changes: Optional[pulumi.Input[bool]] = None,
831
- allow_promiscuous: Optional[pulumi.Input[bool]] = None,
832
- beacon_interval: Optional[pulumi.Input[int]] = None,
833
- check_beacon: Optional[pulumi.Input[bool]] = None,
834
- failback: Optional[pulumi.Input[bool]] = None,
835
- host_system_id: Optional[pulumi.Input[str]] = None,
836
- link_discovery_operation: Optional[pulumi.Input[str]] = None,
837
- link_discovery_protocol: Optional[pulumi.Input[str]] = None,
838
- mtu: Optional[pulumi.Input[int]] = None,
839
- name: Optional[pulumi.Input[str]] = None,
840
- network_adapters: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
841
- notify_switches: Optional[pulumi.Input[bool]] = None,
842
- number_of_ports: Optional[pulumi.Input[int]] = None,
843
- shaping_average_bandwidth: Optional[pulumi.Input[int]] = None,
844
- shaping_burst_size: Optional[pulumi.Input[int]] = None,
845
- shaping_enabled: Optional[pulumi.Input[bool]] = None,
846
- shaping_peak_bandwidth: Optional[pulumi.Input[int]] = None,
847
- standby_nics: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
848
- teaming_policy: Optional[pulumi.Input[str]] = None,
738
+ active_nics: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
739
+ allow_forged_transmits: Optional[pulumi.Input[_builtins.bool]] = None,
740
+ allow_mac_changes: Optional[pulumi.Input[_builtins.bool]] = None,
741
+ allow_promiscuous: Optional[pulumi.Input[_builtins.bool]] = None,
742
+ beacon_interval: Optional[pulumi.Input[_builtins.int]] = None,
743
+ check_beacon: Optional[pulumi.Input[_builtins.bool]] = None,
744
+ failback: Optional[pulumi.Input[_builtins.bool]] = None,
745
+ host_system_id: Optional[pulumi.Input[_builtins.str]] = None,
746
+ link_discovery_operation: Optional[pulumi.Input[_builtins.str]] = None,
747
+ link_discovery_protocol: Optional[pulumi.Input[_builtins.str]] = None,
748
+ mtu: Optional[pulumi.Input[_builtins.int]] = None,
749
+ name: Optional[pulumi.Input[_builtins.str]] = None,
750
+ network_adapters: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
751
+ notify_switches: Optional[pulumi.Input[_builtins.bool]] = None,
752
+ number_of_ports: Optional[pulumi.Input[_builtins.int]] = None,
753
+ shaping_average_bandwidth: Optional[pulumi.Input[_builtins.int]] = None,
754
+ shaping_burst_size: Optional[pulumi.Input[_builtins.int]] = None,
755
+ shaping_enabled: Optional[pulumi.Input[_builtins.bool]] = None,
756
+ shaping_peak_bandwidth: Optional[pulumi.Input[_builtins.int]] = None,
757
+ standby_nics: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
758
+ teaming_policy: Optional[pulumi.Input[_builtins.str]] = None,
849
759
  __props__=None):
850
760
  """
851
- Create a HostVirtualSwitch resource with the given unique name, props, and options.
761
+ The `HostVirtualSwitch` resource can be used to manage vSphere
762
+ standard switches on an ESXi host. These switches can be used as a backing for
763
+ standard port groups, which can be managed by the
764
+ `HostPortGroup` resource.
765
+
766
+ For an overview on vSphere networking concepts, see [this
767
+ page][ref-vsphere-net-concepts].
768
+
769
+ [ref-vsphere-net-concepts]: https://techdocs.broadcom.com/us/en/vmware-cis/vsphere/vsphere/8-0/vsphere-networking-8-0/introduction-to-vsphere-networking.html
770
+
771
+ ## Example Usage
772
+
773
+ ### Create a virtual switch with one active and one standby NIC
774
+
775
+ ```python
776
+ import pulumi
777
+ import pulumi_vsphere as vsphere
778
+
779
+ datacenter = vsphere.get_datacenter(name="dc-01")
780
+ host = vsphere.get_host(name="esxi-01.example.com",
781
+ datacenter_id=datacenter.id)
782
+ switch = vsphere.HostVirtualSwitch("switch",
783
+ name="vSwitchTest",
784
+ host_system_id=host.id,
785
+ network_adapters=[
786
+ "vmnic0",
787
+ "vmnic1",
788
+ ],
789
+ active_nics=["vmnic0"],
790
+ standby_nics=["vmnic1"])
791
+ ```
792
+
793
+ ### Create a virtual switch with extra networking policy options
794
+
795
+ ```python
796
+ import pulumi
797
+ import pulumi_vsphere as vsphere
798
+
799
+ datacenter = vsphere.get_datacenter(name="dc-01")
800
+ host = vsphere.get_host(name="esxi-01.example.com",
801
+ datacenter_id=datacenter.id)
802
+ switch = vsphere.HostVirtualSwitch("switch",
803
+ name="vSwitchTest",
804
+ host_system_id=host.id,
805
+ network_adapters=[
806
+ "vmnic0",
807
+ "vmnic1",
808
+ ],
809
+ active_nics=["vmnic0"],
810
+ standby_nics=["vmnic1"],
811
+ teaming_policy="failover_explicit",
812
+ allow_promiscuous=False,
813
+ allow_forged_transmits=False,
814
+ allow_mac_changes=False,
815
+ shaping_enabled=True,
816
+ shaping_average_bandwidth=50000000,
817
+ shaping_peak_bandwidth=100000000,
818
+ shaping_burst_size=1000000000)
819
+ ```
820
+
821
+ ## Import
822
+
823
+ An existing vSwitch can be imported into this resource by its ID.
824
+
825
+ The convention of the id is a prefix, the host system [managed objectID][docs-about-morefs], and the virtual switch
826
+
827
+ name. An example would be `tf-HostVirtualSwitch:host-10:vSwitchTerraformTest`.
828
+
829
+ Import can the be done via the following command:
830
+
831
+ [docs-import]: https://developer.hashicorp.com/terraform/cli/import
832
+
833
+ [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
834
+
835
+ ```sh
836
+ $ pulumi import vsphere:index/hostVirtualSwitch:HostVirtualSwitch switch tf-HostVirtualSwitch:host-10:vSwitchTerraformTest
837
+ ```
838
+
839
+ The above would import the vSwitch named `vSwitchTerraformTest` that is located in the `host-10`
840
+
841
+ vSphere host.
842
+
852
843
  :param str resource_name: The name of the resource.
853
844
  :param pulumi.ResourceOptions opts: Options for the resource.
854
- :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: The list of active network adapters used for load
855
- balancing.
856
- :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual
857
- network adapter is allowed to send network traffic with a different MAC
858
- address than that of its own. Default: `true`.
859
- :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
860
- Control (MAC) address can be changed. Default: `true`.
861
- :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
862
- flag indicates whether or not all traffic is seen on a given port. Default:
863
- `false`.
864
- :param pulumi.Input[int] beacon_interval: The interval, in seconds, that a NIC beacon
865
- packet is sent out. This can be used with `check_beacon` to
866
- offer link failure capability beyond link status only. Default: `1`.
867
- :param pulumi.Input[bool] check_beacon: Enable beacon probing - this requires that the
868
- `beacon_interval` option has been set in the bridge
869
- options. If this is set to `false`, only link status is used to check for
870
- failed NICs. Default: `false`.
871
- :param pulumi.Input[bool] failback: If set to `true`, the teaming policy will re-activate
872
- failed interfaces higher in precedence when they come back up. Default:
873
- `true`.
874
- :param pulumi.Input[str] host_system_id: The managed object ID of
845
+ :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] active_nics: List of active network adapters used for load balancing.
846
+ :param pulumi.Input[_builtins.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.
847
+ :param pulumi.Input[_builtins.bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
848
+ :param pulumi.Input[_builtins.bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
849
+ :param pulumi.Input[_builtins.int] beacon_interval: Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
850
+ :param pulumi.Input[_builtins.bool] check_beacon: Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used only.
851
+ :param pulumi.Input[_builtins.bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
852
+ :param pulumi.Input[_builtins.str] host_system_id: The managed object ID of
875
853
  the host to set the virtual switch up on. Forces a new resource if changed.
876
- :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
877
- for link discovery traffic. Default: `listen`.
878
- :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid
879
- types are `cpd` and `lldp`. Default: `cdp`.
880
- :param pulumi.Input[int] mtu: The maximum transmission unit (MTU) for the virtual
854
+ :param pulumi.Input[_builtins.str] link_discovery_operation: Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
855
+ :param pulumi.Input[_builtins.str] link_discovery_protocol: The discovery protocol type. Valid values are cdp and lldp.
856
+ :param pulumi.Input[_builtins.int] mtu: The maximum transmission unit (MTU) for the virtual
881
857
  switch. Default: `1500`.
882
- :param pulumi.Input[str] name: The name of the virtual switch. Forces a new resource if
858
+ :param pulumi.Input[_builtins.str] name: The name of the virtual switch. Forces a new resource if
883
859
  changed.
884
- :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The network interfaces to bind to the bridge.
885
- :param pulumi.Input[bool] notify_switches: If set to `true`, the teaming policy will
886
- notify the broadcast network of a NIC failover, triggering cache updates.
887
- Default: `true`.
888
- :param pulumi.Input[int] number_of_ports: The number of ports to create with this
860
+ :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] network_adapters: The list of network adapters to bind to this virtual switch.
861
+ :param pulumi.Input[_builtins.bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
862
+ :param pulumi.Input[_builtins.int] number_of_ports: The number of ports to create with this
889
863
  virtual switch. Default: `128`.
890
864
 
891
865
  > **NOTE:** Changing the port count requires a reboot of the host. This provider
892
866
  will not restart the host for you.
893
- :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per
894
- second if traffic shaping is enabled. Default: `0`
895
- :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if
896
- shaping is enabled. Default: `0`
897
- :param pulumi.Input[bool] shaping_enabled: Set to `true` to enable the traffic shaper for
898
- ports managed by this virtual switch. Default: `false`.
899
- :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in
900
- bits per second if traffic shaping is enabled. Default: `0`
901
- :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: The list of standby network adapters used for
902
- failover.
903
- :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one
904
- of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
905
- `failover_explicit`. Default: `loadbalance_srcid`.
867
+ :param pulumi.Input[_builtins.int] shaping_average_bandwidth: The average bandwidth in bits per second if traffic shaping is enabled.
868
+ :param pulumi.Input[_builtins.int] shaping_burst_size: The maximum burst size allowed in bytes if traffic shaping is enabled.
869
+ :param pulumi.Input[_builtins.bool] shaping_enabled: Enable traffic shaping on this virtual switch or port group.
870
+ :param pulumi.Input[_builtins.int] shaping_peak_bandwidth: The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
871
+ :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] standby_nics: List of standby network adapters used for failover.
872
+ :param pulumi.Input[_builtins.str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or failover_explicit.
906
873
  """
907
874
  ...
908
875
  @overload
@@ -911,7 +878,88 @@ class HostVirtualSwitch(pulumi.CustomResource):
911
878
  args: HostVirtualSwitchArgs,
912
879
  opts: Optional[pulumi.ResourceOptions] = None):
913
880
  """
914
- Create a HostVirtualSwitch resource with the given unique name, props, and options.
881
+ The `HostVirtualSwitch` resource can be used to manage vSphere
882
+ standard switches on an ESXi host. These switches can be used as a backing for
883
+ standard port groups, which can be managed by the
884
+ `HostPortGroup` resource.
885
+
886
+ For an overview on vSphere networking concepts, see [this
887
+ page][ref-vsphere-net-concepts].
888
+
889
+ [ref-vsphere-net-concepts]: https://techdocs.broadcom.com/us/en/vmware-cis/vsphere/vsphere/8-0/vsphere-networking-8-0/introduction-to-vsphere-networking.html
890
+
891
+ ## Example Usage
892
+
893
+ ### Create a virtual switch with one active and one standby NIC
894
+
895
+ ```python
896
+ import pulumi
897
+ import pulumi_vsphere as vsphere
898
+
899
+ datacenter = vsphere.get_datacenter(name="dc-01")
900
+ host = vsphere.get_host(name="esxi-01.example.com",
901
+ datacenter_id=datacenter.id)
902
+ switch = vsphere.HostVirtualSwitch("switch",
903
+ name="vSwitchTest",
904
+ host_system_id=host.id,
905
+ network_adapters=[
906
+ "vmnic0",
907
+ "vmnic1",
908
+ ],
909
+ active_nics=["vmnic0"],
910
+ standby_nics=["vmnic1"])
911
+ ```
912
+
913
+ ### Create a virtual switch with extra networking policy options
914
+
915
+ ```python
916
+ import pulumi
917
+ import pulumi_vsphere as vsphere
918
+
919
+ datacenter = vsphere.get_datacenter(name="dc-01")
920
+ host = vsphere.get_host(name="esxi-01.example.com",
921
+ datacenter_id=datacenter.id)
922
+ switch = vsphere.HostVirtualSwitch("switch",
923
+ name="vSwitchTest",
924
+ host_system_id=host.id,
925
+ network_adapters=[
926
+ "vmnic0",
927
+ "vmnic1",
928
+ ],
929
+ active_nics=["vmnic0"],
930
+ standby_nics=["vmnic1"],
931
+ teaming_policy="failover_explicit",
932
+ allow_promiscuous=False,
933
+ allow_forged_transmits=False,
934
+ allow_mac_changes=False,
935
+ shaping_enabled=True,
936
+ shaping_average_bandwidth=50000000,
937
+ shaping_peak_bandwidth=100000000,
938
+ shaping_burst_size=1000000000)
939
+ ```
940
+
941
+ ## Import
942
+
943
+ An existing vSwitch can be imported into this resource by its ID.
944
+
945
+ The convention of the id is a prefix, the host system [managed objectID][docs-about-morefs], and the virtual switch
946
+
947
+ name. An example would be `tf-HostVirtualSwitch:host-10:vSwitchTerraformTest`.
948
+
949
+ Import can the be done via the following command:
950
+
951
+ [docs-import]: https://developer.hashicorp.com/terraform/cli/import
952
+
953
+ [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
954
+
955
+ ```sh
956
+ $ pulumi import vsphere:index/hostVirtualSwitch:HostVirtualSwitch switch tf-HostVirtualSwitch:host-10:vSwitchTerraformTest
957
+ ```
958
+
959
+ The above would import the vSwitch named `vSwitchTerraformTest` that is located in the `host-10`
960
+
961
+ vSphere host.
962
+
915
963
  :param str resource_name: The name of the resource.
916
964
  :param HostVirtualSwitchArgs args: The arguments to use to populate this resource's properties.
917
965
  :param pulumi.ResourceOptions opts: Options for the resource.
@@ -927,27 +975,27 @@ class HostVirtualSwitch(pulumi.CustomResource):
927
975
  def _internal_init(__self__,
928
976
  resource_name: str,
929
977
  opts: Optional[pulumi.ResourceOptions] = None,
930
- active_nics: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
931
- allow_forged_transmits: Optional[pulumi.Input[bool]] = None,
932
- allow_mac_changes: Optional[pulumi.Input[bool]] = None,
933
- allow_promiscuous: Optional[pulumi.Input[bool]] = None,
934
- beacon_interval: Optional[pulumi.Input[int]] = None,
935
- check_beacon: Optional[pulumi.Input[bool]] = None,
936
- failback: Optional[pulumi.Input[bool]] = None,
937
- host_system_id: Optional[pulumi.Input[str]] = None,
938
- link_discovery_operation: Optional[pulumi.Input[str]] = None,
939
- link_discovery_protocol: Optional[pulumi.Input[str]] = None,
940
- mtu: Optional[pulumi.Input[int]] = None,
941
- name: Optional[pulumi.Input[str]] = None,
942
- network_adapters: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
943
- notify_switches: Optional[pulumi.Input[bool]] = None,
944
- number_of_ports: Optional[pulumi.Input[int]] = None,
945
- shaping_average_bandwidth: Optional[pulumi.Input[int]] = None,
946
- shaping_burst_size: Optional[pulumi.Input[int]] = None,
947
- shaping_enabled: Optional[pulumi.Input[bool]] = None,
948
- shaping_peak_bandwidth: Optional[pulumi.Input[int]] = None,
949
- standby_nics: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
950
- teaming_policy: Optional[pulumi.Input[str]] = None,
978
+ active_nics: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
979
+ allow_forged_transmits: Optional[pulumi.Input[_builtins.bool]] = None,
980
+ allow_mac_changes: Optional[pulumi.Input[_builtins.bool]] = None,
981
+ allow_promiscuous: Optional[pulumi.Input[_builtins.bool]] = None,
982
+ beacon_interval: Optional[pulumi.Input[_builtins.int]] = None,
983
+ check_beacon: Optional[pulumi.Input[_builtins.bool]] = None,
984
+ failback: Optional[pulumi.Input[_builtins.bool]] = None,
985
+ host_system_id: Optional[pulumi.Input[_builtins.str]] = None,
986
+ link_discovery_operation: Optional[pulumi.Input[_builtins.str]] = None,
987
+ link_discovery_protocol: Optional[pulumi.Input[_builtins.str]] = None,
988
+ mtu: Optional[pulumi.Input[_builtins.int]] = None,
989
+ name: Optional[pulumi.Input[_builtins.str]] = None,
990
+ network_adapters: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
991
+ notify_switches: Optional[pulumi.Input[_builtins.bool]] = None,
992
+ number_of_ports: Optional[pulumi.Input[_builtins.int]] = None,
993
+ shaping_average_bandwidth: Optional[pulumi.Input[_builtins.int]] = None,
994
+ shaping_burst_size: Optional[pulumi.Input[_builtins.int]] = None,
995
+ shaping_enabled: Optional[pulumi.Input[_builtins.bool]] = None,
996
+ shaping_peak_bandwidth: Optional[pulumi.Input[_builtins.int]] = None,
997
+ standby_nics: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
998
+ teaming_policy: Optional[pulumi.Input[_builtins.str]] = None,
951
999
  __props__=None):
952
1000
  opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
953
1001
  if not isinstance(opts, pulumi.ResourceOptions):
@@ -994,27 +1042,27 @@ class HostVirtualSwitch(pulumi.CustomResource):
994
1042
  def get(resource_name: str,
995
1043
  id: pulumi.Input[str],
996
1044
  opts: Optional[pulumi.ResourceOptions] = None,
997
- active_nics: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
998
- allow_forged_transmits: Optional[pulumi.Input[bool]] = None,
999
- allow_mac_changes: Optional[pulumi.Input[bool]] = None,
1000
- allow_promiscuous: Optional[pulumi.Input[bool]] = None,
1001
- beacon_interval: Optional[pulumi.Input[int]] = None,
1002
- check_beacon: Optional[pulumi.Input[bool]] = None,
1003
- failback: Optional[pulumi.Input[bool]] = None,
1004
- host_system_id: Optional[pulumi.Input[str]] = None,
1005
- link_discovery_operation: Optional[pulumi.Input[str]] = None,
1006
- link_discovery_protocol: Optional[pulumi.Input[str]] = None,
1007
- mtu: Optional[pulumi.Input[int]] = None,
1008
- name: Optional[pulumi.Input[str]] = None,
1009
- network_adapters: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
1010
- notify_switches: Optional[pulumi.Input[bool]] = None,
1011
- number_of_ports: Optional[pulumi.Input[int]] = None,
1012
- shaping_average_bandwidth: Optional[pulumi.Input[int]] = None,
1013
- shaping_burst_size: Optional[pulumi.Input[int]] = None,
1014
- shaping_enabled: Optional[pulumi.Input[bool]] = None,
1015
- shaping_peak_bandwidth: Optional[pulumi.Input[int]] = None,
1016
- standby_nics: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
1017
- teaming_policy: Optional[pulumi.Input[str]] = None) -> 'HostVirtualSwitch':
1045
+ active_nics: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
1046
+ allow_forged_transmits: Optional[pulumi.Input[_builtins.bool]] = None,
1047
+ allow_mac_changes: Optional[pulumi.Input[_builtins.bool]] = None,
1048
+ allow_promiscuous: Optional[pulumi.Input[_builtins.bool]] = None,
1049
+ beacon_interval: Optional[pulumi.Input[_builtins.int]] = None,
1050
+ check_beacon: Optional[pulumi.Input[_builtins.bool]] = None,
1051
+ failback: Optional[pulumi.Input[_builtins.bool]] = None,
1052
+ host_system_id: Optional[pulumi.Input[_builtins.str]] = None,
1053
+ link_discovery_operation: Optional[pulumi.Input[_builtins.str]] = None,
1054
+ link_discovery_protocol: Optional[pulumi.Input[_builtins.str]] = None,
1055
+ mtu: Optional[pulumi.Input[_builtins.int]] = None,
1056
+ name: Optional[pulumi.Input[_builtins.str]] = None,
1057
+ network_adapters: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
1058
+ notify_switches: Optional[pulumi.Input[_builtins.bool]] = None,
1059
+ number_of_ports: Optional[pulumi.Input[_builtins.int]] = None,
1060
+ shaping_average_bandwidth: Optional[pulumi.Input[_builtins.int]] = None,
1061
+ shaping_burst_size: Optional[pulumi.Input[_builtins.int]] = None,
1062
+ shaping_enabled: Optional[pulumi.Input[_builtins.bool]] = None,
1063
+ shaping_peak_bandwidth: Optional[pulumi.Input[_builtins.int]] = None,
1064
+ standby_nics: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
1065
+ teaming_policy: Optional[pulumi.Input[_builtins.str]] = None) -> 'HostVirtualSwitch':
1018
1066
  """
1019
1067
  Get an existing HostVirtualSwitch resource's state with the given name, id, and optional extra
1020
1068
  properties used to qualify the lookup.
@@ -1022,58 +1070,34 @@ class HostVirtualSwitch(pulumi.CustomResource):
1022
1070
  :param str resource_name: The unique name of the resulting resource.
1023
1071
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
1024
1072
  :param pulumi.ResourceOptions opts: Options for the resource.
1025
- :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: The list of active network adapters used for load
1026
- balancing.
1027
- :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual
1028
- network adapter is allowed to send network traffic with a different MAC
1029
- address than that of its own. Default: `true`.
1030
- :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
1031
- Control (MAC) address can be changed. Default: `true`.
1032
- :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
1033
- flag indicates whether or not all traffic is seen on a given port. Default:
1034
- `false`.
1035
- :param pulumi.Input[int] beacon_interval: The interval, in seconds, that a NIC beacon
1036
- packet is sent out. This can be used with `check_beacon` to
1037
- offer link failure capability beyond link status only. Default: `1`.
1038
- :param pulumi.Input[bool] check_beacon: Enable beacon probing - this requires that the
1039
- `beacon_interval` option has been set in the bridge
1040
- options. If this is set to `false`, only link status is used to check for
1041
- failed NICs. Default: `false`.
1042
- :param pulumi.Input[bool] failback: If set to `true`, the teaming policy will re-activate
1043
- failed interfaces higher in precedence when they come back up. Default:
1044
- `true`.
1045
- :param pulumi.Input[str] host_system_id: The managed object ID of
1073
+ :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] active_nics: List of active network adapters used for load balancing.
1074
+ :param pulumi.Input[_builtins.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.
1075
+ :param pulumi.Input[_builtins.bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
1076
+ :param pulumi.Input[_builtins.bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
1077
+ :param pulumi.Input[_builtins.int] beacon_interval: Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
1078
+ :param pulumi.Input[_builtins.bool] check_beacon: Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used only.
1079
+ :param pulumi.Input[_builtins.bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
1080
+ :param pulumi.Input[_builtins.str] host_system_id: The managed object ID of
1046
1081
  the host to set the virtual switch up on. Forces a new resource if changed.
1047
- :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
1048
- for link discovery traffic. Default: `listen`.
1049
- :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid
1050
- types are `cpd` and `lldp`. Default: `cdp`.
1051
- :param pulumi.Input[int] mtu: The maximum transmission unit (MTU) for the virtual
1082
+ :param pulumi.Input[_builtins.str] link_discovery_operation: Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
1083
+ :param pulumi.Input[_builtins.str] link_discovery_protocol: The discovery protocol type. Valid values are cdp and lldp.
1084
+ :param pulumi.Input[_builtins.int] mtu: The maximum transmission unit (MTU) for the virtual
1052
1085
  switch. Default: `1500`.
1053
- :param pulumi.Input[str] name: The name of the virtual switch. Forces a new resource if
1086
+ :param pulumi.Input[_builtins.str] name: The name of the virtual switch. Forces a new resource if
1054
1087
  changed.
1055
- :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The network interfaces to bind to the bridge.
1056
- :param pulumi.Input[bool] notify_switches: If set to `true`, the teaming policy will
1057
- notify the broadcast network of a NIC failover, triggering cache updates.
1058
- Default: `true`.
1059
- :param pulumi.Input[int] number_of_ports: The number of ports to create with this
1088
+ :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] network_adapters: The list of network adapters to bind to this virtual switch.
1089
+ :param pulumi.Input[_builtins.bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
1090
+ :param pulumi.Input[_builtins.int] number_of_ports: The number of ports to create with this
1060
1091
  virtual switch. Default: `128`.
1061
1092
 
1062
1093
  > **NOTE:** Changing the port count requires a reboot of the host. This provider
1063
1094
  will not restart the host for you.
1064
- :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per
1065
- second if traffic shaping is enabled. Default: `0`
1066
- :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if
1067
- shaping is enabled. Default: `0`
1068
- :param pulumi.Input[bool] shaping_enabled: Set to `true` to enable the traffic shaper for
1069
- ports managed by this virtual switch. Default: `false`.
1070
- :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in
1071
- bits per second if traffic shaping is enabled. Default: `0`
1072
- :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: The list of standby network adapters used for
1073
- failover.
1074
- :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one
1075
- of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
1076
- `failover_explicit`. Default: `loadbalance_srcid`.
1095
+ :param pulumi.Input[_builtins.int] shaping_average_bandwidth: The average bandwidth in bits per second if traffic shaping is enabled.
1096
+ :param pulumi.Input[_builtins.int] shaping_burst_size: The maximum burst size allowed in bytes if traffic shaping is enabled.
1097
+ :param pulumi.Input[_builtins.bool] shaping_enabled: Enable traffic shaping on this virtual switch or port group.
1098
+ :param pulumi.Input[_builtins.int] shaping_peak_bandwidth: The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
1099
+ :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] standby_nics: List of standby network adapters used for failover.
1100
+ :param pulumi.Input[_builtins.str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or failover_explicit.
1077
1101
  """
1078
1102
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
1079
1103
 
@@ -1102,141 +1126,124 @@ class HostVirtualSwitch(pulumi.CustomResource):
1102
1126
  __props__.__dict__["teaming_policy"] = teaming_policy
1103
1127
  return HostVirtualSwitch(resource_name, opts=opts, __props__=__props__)
1104
1128
 
1105
- @property
1129
+ @_builtins.property
1106
1130
  @pulumi.getter(name="activeNics")
1107
- def active_nics(self) -> pulumi.Output[Sequence[str]]:
1131
+ def active_nics(self) -> pulumi.Output[Sequence[_builtins.str]]:
1108
1132
  """
1109
- The list of active network adapters used for load
1110
- balancing.
1133
+ List of active network adapters used for load balancing.
1111
1134
  """
1112
1135
  return pulumi.get(self, "active_nics")
1113
1136
 
1114
- @property
1137
+ @_builtins.property
1115
1138
  @pulumi.getter(name="allowForgedTransmits")
1116
- def allow_forged_transmits(self) -> pulumi.Output[Optional[bool]]:
1139
+ def allow_forged_transmits(self) -> pulumi.Output[Optional[_builtins.bool]]:
1117
1140
  """
1118
- Controls whether or not the virtual
1119
- network adapter is allowed to send network traffic with a different MAC
1120
- address than that of its own. Default: `true`.
1141
+ Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
1121
1142
  """
1122
1143
  return pulumi.get(self, "allow_forged_transmits")
1123
1144
 
1124
- @property
1145
+ @_builtins.property
1125
1146
  @pulumi.getter(name="allowMacChanges")
1126
- def allow_mac_changes(self) -> pulumi.Output[Optional[bool]]:
1147
+ def allow_mac_changes(self) -> pulumi.Output[Optional[_builtins.bool]]:
1127
1148
  """
1128
- Controls whether or not the Media Access
1129
- Control (MAC) address can be changed. Default: `true`.
1149
+ Controls whether or not the Media Access Control (MAC) address can be changed.
1130
1150
  """
1131
1151
  return pulumi.get(self, "allow_mac_changes")
1132
1152
 
1133
- @property
1153
+ @_builtins.property
1134
1154
  @pulumi.getter(name="allowPromiscuous")
1135
- def allow_promiscuous(self) -> pulumi.Output[Optional[bool]]:
1155
+ def allow_promiscuous(self) -> pulumi.Output[Optional[_builtins.bool]]:
1136
1156
  """
1137
- Enable promiscuous mode on the network. This
1138
- flag indicates whether or not all traffic is seen on a given port. Default:
1139
- `false`.
1157
+ Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
1140
1158
  """
1141
1159
  return pulumi.get(self, "allow_promiscuous")
1142
1160
 
1143
- @property
1161
+ @_builtins.property
1144
1162
  @pulumi.getter(name="beaconInterval")
1145
- def beacon_interval(self) -> pulumi.Output[Optional[int]]:
1163
+ def beacon_interval(self) -> pulumi.Output[Optional[_builtins.int]]:
1146
1164
  """
1147
- The interval, in seconds, that a NIC beacon
1148
- packet is sent out. This can be used with `check_beacon` to
1149
- offer link failure capability beyond link status only. Default: `1`.
1165
+ Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
1150
1166
  """
1151
1167
  return pulumi.get(self, "beacon_interval")
1152
1168
 
1153
- @property
1169
+ @_builtins.property
1154
1170
  @pulumi.getter(name="checkBeacon")
1155
- def check_beacon(self) -> pulumi.Output[Optional[bool]]:
1171
+ def check_beacon(self) -> pulumi.Output[Optional[_builtins.bool]]:
1156
1172
  """
1157
- Enable beacon probing - this requires that the
1158
- `beacon_interval` option has been set in the bridge
1159
- options. If this is set to `false`, only link status is used to check for
1160
- failed NICs. Default: `false`.
1173
+ Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used only.
1161
1174
  """
1162
1175
  return pulumi.get(self, "check_beacon")
1163
1176
 
1164
- @property
1177
+ @_builtins.property
1165
1178
  @pulumi.getter
1166
- def failback(self) -> pulumi.Output[Optional[bool]]:
1179
+ def failback(self) -> pulumi.Output[Optional[_builtins.bool]]:
1167
1180
  """
1168
- If set to `true`, the teaming policy will re-activate
1169
- failed interfaces higher in precedence when they come back up. Default:
1170
- `true`.
1181
+ If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
1171
1182
  """
1172
1183
  return pulumi.get(self, "failback")
1173
1184
 
1174
- @property
1185
+ @_builtins.property
1175
1186
  @pulumi.getter(name="hostSystemId")
1176
- def host_system_id(self) -> pulumi.Output[str]:
1187
+ def host_system_id(self) -> pulumi.Output[_builtins.str]:
1177
1188
  """
1178
1189
  The managed object ID of
1179
1190
  the host to set the virtual switch up on. Forces a new resource if changed.
1180
1191
  """
1181
1192
  return pulumi.get(self, "host_system_id")
1182
1193
 
1183
- @property
1194
+ @_builtins.property
1184
1195
  @pulumi.getter(name="linkDiscoveryOperation")
1185
- def link_discovery_operation(self) -> pulumi.Output[Optional[str]]:
1196
+ def link_discovery_operation(self) -> pulumi.Output[Optional[_builtins.str]]:
1186
1197
  """
1187
- Whether to `advertise` or `listen`
1188
- for link discovery traffic. Default: `listen`.
1198
+ Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
1189
1199
  """
1190
1200
  return pulumi.get(self, "link_discovery_operation")
1191
1201
 
1192
- @property
1202
+ @_builtins.property
1193
1203
  @pulumi.getter(name="linkDiscoveryProtocol")
1194
- def link_discovery_protocol(self) -> pulumi.Output[Optional[str]]:
1204
+ def link_discovery_protocol(self) -> pulumi.Output[Optional[_builtins.str]]:
1195
1205
  """
1196
- The discovery protocol type. Valid
1197
- types are `cpd` and `lldp`. Default: `cdp`.
1206
+ The discovery protocol type. Valid values are cdp and lldp.
1198
1207
  """
1199
1208
  return pulumi.get(self, "link_discovery_protocol")
1200
1209
 
1201
- @property
1210
+ @_builtins.property
1202
1211
  @pulumi.getter
1203
- def mtu(self) -> pulumi.Output[Optional[int]]:
1212
+ def mtu(self) -> pulumi.Output[Optional[_builtins.int]]:
1204
1213
  """
1205
1214
  The maximum transmission unit (MTU) for the virtual
1206
1215
  switch. Default: `1500`.
1207
1216
  """
1208
1217
  return pulumi.get(self, "mtu")
1209
1218
 
1210
- @property
1219
+ @_builtins.property
1211
1220
  @pulumi.getter
1212
- def name(self) -> pulumi.Output[str]:
1221
+ def name(self) -> pulumi.Output[_builtins.str]:
1213
1222
  """
1214
1223
  The name of the virtual switch. Forces a new resource if
1215
1224
  changed.
1216
1225
  """
1217
1226
  return pulumi.get(self, "name")
1218
1227
 
1219
- @property
1228
+ @_builtins.property
1220
1229
  @pulumi.getter(name="networkAdapters")
1221
- def network_adapters(self) -> pulumi.Output[Sequence[str]]:
1230
+ def network_adapters(self) -> pulumi.Output[Sequence[_builtins.str]]:
1222
1231
  """
1223
- The network interfaces to bind to the bridge.
1232
+ The list of network adapters to bind to this virtual switch.
1224
1233
  """
1225
1234
  return pulumi.get(self, "network_adapters")
1226
1235
 
1227
- @property
1236
+ @_builtins.property
1228
1237
  @pulumi.getter(name="notifySwitches")
1229
- def notify_switches(self) -> pulumi.Output[Optional[bool]]:
1238
+ def notify_switches(self) -> pulumi.Output[Optional[_builtins.bool]]:
1230
1239
  """
1231
- If set to `true`, the teaming policy will
1232
- notify the broadcast network of a NIC failover, triggering cache updates.
1233
- Default: `true`.
1240
+ If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
1234
1241
  """
1235
1242
  return pulumi.get(self, "notify_switches")
1236
1243
 
1237
- @property
1244
+ @_builtins.property
1238
1245
  @pulumi.getter(name="numberOfPorts")
1239
- def number_of_ports(self) -> pulumi.Output[Optional[int]]:
1246
+ def number_of_ports(self) -> pulumi.Output[Optional[_builtins.int]]:
1240
1247
  """
1241
1248
  The number of ports to create with this
1242
1249
  virtual switch. Default: `128`.
@@ -1246,58 +1253,51 @@ class HostVirtualSwitch(pulumi.CustomResource):
1246
1253
  """
1247
1254
  return pulumi.get(self, "number_of_ports")
1248
1255
 
1249
- @property
1256
+ @_builtins.property
1250
1257
  @pulumi.getter(name="shapingAverageBandwidth")
1251
- def shaping_average_bandwidth(self) -> pulumi.Output[Optional[int]]:
1258
+ def shaping_average_bandwidth(self) -> pulumi.Output[Optional[_builtins.int]]:
1252
1259
  """
1253
- The average bandwidth in bits per
1254
- second if traffic shaping is enabled. Default: `0`
1260
+ The average bandwidth in bits per second if traffic shaping is enabled.
1255
1261
  """
1256
1262
  return pulumi.get(self, "shaping_average_bandwidth")
1257
1263
 
1258
- @property
1264
+ @_builtins.property
1259
1265
  @pulumi.getter(name="shapingBurstSize")
1260
- def shaping_burst_size(self) -> pulumi.Output[Optional[int]]:
1266
+ def shaping_burst_size(self) -> pulumi.Output[Optional[_builtins.int]]:
1261
1267
  """
1262
- The maximum burst size allowed in bytes if
1263
- shaping is enabled. Default: `0`
1268
+ The maximum burst size allowed in bytes if traffic shaping is enabled.
1264
1269
  """
1265
1270
  return pulumi.get(self, "shaping_burst_size")
1266
1271
 
1267
- @property
1272
+ @_builtins.property
1268
1273
  @pulumi.getter(name="shapingEnabled")
1269
- def shaping_enabled(self) -> pulumi.Output[Optional[bool]]:
1274
+ def shaping_enabled(self) -> pulumi.Output[Optional[_builtins.bool]]:
1270
1275
  """
1271
- Set to `true` to enable the traffic shaper for
1272
- ports managed by this virtual switch. Default: `false`.
1276
+ Enable traffic shaping on this virtual switch or port group.
1273
1277
  """
1274
1278
  return pulumi.get(self, "shaping_enabled")
1275
1279
 
1276
- @property
1280
+ @_builtins.property
1277
1281
  @pulumi.getter(name="shapingPeakBandwidth")
1278
- def shaping_peak_bandwidth(self) -> pulumi.Output[Optional[int]]:
1282
+ def shaping_peak_bandwidth(self) -> pulumi.Output[Optional[_builtins.int]]:
1279
1283
  """
1280
- The peak bandwidth during bursts in
1281
- bits per second if traffic shaping is enabled. Default: `0`
1284
+ The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
1282
1285
  """
1283
1286
  return pulumi.get(self, "shaping_peak_bandwidth")
1284
1287
 
1285
- @property
1288
+ @_builtins.property
1286
1289
  @pulumi.getter(name="standbyNics")
1287
- def standby_nics(self) -> pulumi.Output[Optional[Sequence[str]]]:
1290
+ def standby_nics(self) -> pulumi.Output[Optional[Sequence[_builtins.str]]]:
1288
1291
  """
1289
- The list of standby network adapters used for
1290
- failover.
1292
+ List of standby network adapters used for failover.
1291
1293
  """
1292
1294
  return pulumi.get(self, "standby_nics")
1293
1295
 
1294
- @property
1296
+ @_builtins.property
1295
1297
  @pulumi.getter(name="teamingPolicy")
1296
- def teaming_policy(self) -> pulumi.Output[Optional[str]]:
1298
+ def teaming_policy(self) -> pulumi.Output[Optional[_builtins.str]]:
1297
1299
  """
1298
- The network adapter teaming policy. Can be one
1299
- of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
1300
- `failover_explicit`. Default: `loadbalance_srcid`.
1300
+ The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or failover_explicit.
1301
1301
  """
1302
1302
  return pulumi.get(self, "teaming_policy")
1303
1303