pulumi-vsphere 4.11.0__py3-none-any.whl → 4.11.0a1710920591__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 (65) hide show
  1. pulumi_vsphere/__init__.py +0 -28
  2. pulumi_vsphere/_inputs.py +236 -646
  3. pulumi_vsphere/_utilities.py +4 -40
  4. pulumi_vsphere/compute_cluster.py +1486 -756
  5. pulumi_vsphere/compute_cluster_vm_affinity_rule.py +34 -42
  6. pulumi_vsphere/content_library.py +10 -10
  7. pulumi_vsphere/datacenter.py +40 -33
  8. pulumi_vsphere/datastore_cluster.py +364 -154
  9. pulumi_vsphere/distributed_port_group.py +187 -131
  10. pulumi_vsphere/distributed_virtual_switch.py +828 -310
  11. pulumi_vsphere/entity_permissions.py +38 -59
  12. pulumi_vsphere/file.py +24 -16
  13. pulumi_vsphere/folder.py +28 -7
  14. pulumi_vsphere/get_compute_cluster.py +4 -0
  15. pulumi_vsphere/get_compute_cluster_host_group.py +20 -20
  16. pulumi_vsphere/get_content_library.py +10 -10
  17. pulumi_vsphere/get_content_library_item.py +8 -12
  18. pulumi_vsphere/get_custom_attribute.py +4 -0
  19. pulumi_vsphere/get_datacenter.py +4 -0
  20. pulumi_vsphere/get_datastore.py +16 -12
  21. pulumi_vsphere/get_datastore_cluster.py +4 -0
  22. pulumi_vsphere/get_datastore_stats.py +52 -46
  23. pulumi_vsphere/get_distributed_virtual_switch.py +4 -2
  24. pulumi_vsphere/get_dynamic.py +20 -18
  25. pulumi_vsphere/get_folder.py +6 -10
  26. pulumi_vsphere/get_guest_os_customization.py +47 -8
  27. pulumi_vsphere/get_host.py +4 -0
  28. pulumi_vsphere/get_host_pci_device.py +14 -8
  29. pulumi_vsphere/get_host_thumbprint.py +16 -12
  30. pulumi_vsphere/get_host_vgpu_profile.py +10 -4
  31. pulumi_vsphere/get_license.py +5 -2
  32. pulumi_vsphere/get_network.py +18 -14
  33. pulumi_vsphere/get_policy.py +4 -0
  34. pulumi_vsphere/get_resource_pool.py +18 -14
  35. pulumi_vsphere/get_role.py +8 -4
  36. pulumi_vsphere/get_tag.py +4 -0
  37. pulumi_vsphere/get_tag_category.py +4 -0
  38. pulumi_vsphere/get_vapp_container.py +4 -0
  39. pulumi_vsphere/get_virtual_machine.py +43 -60
  40. pulumi_vsphere/get_vmfs_disks.py +4 -0
  41. pulumi_vsphere/guest_os_customization.py +5 -55
  42. pulumi_vsphere/ha_vm_override.py +378 -189
  43. pulumi_vsphere/host.py +60 -49
  44. pulumi_vsphere/host_port_group.py +26 -14
  45. pulumi_vsphere/host_virtual_switch.py +287 -140
  46. pulumi_vsphere/license.py +32 -0
  47. pulumi_vsphere/nas_datastore.py +7 -7
  48. pulumi_vsphere/outputs.py +270 -672
  49. pulumi_vsphere/provider.py +6 -2
  50. pulumi_vsphere/pulumi-plugin.json +1 -2
  51. pulumi_vsphere/resource_pool.py +24 -50
  52. pulumi_vsphere/virtual_disk.py +34 -42
  53. pulumi_vsphere/virtual_machine.py +827 -598
  54. pulumi_vsphere/virtual_machine_snapshot.py +12 -8
  55. pulumi_vsphere/vm_storage_policy.py +127 -115
  56. pulumi_vsphere/vnic.py +105 -89
  57. {pulumi_vsphere-4.11.0.dist-info → pulumi_vsphere-4.11.0a1710920591.dist-info}/METADATA +1 -1
  58. pulumi_vsphere-4.11.0a1710920591.dist-info/RECORD +82 -0
  59. {pulumi_vsphere-4.11.0.dist-info → pulumi_vsphere-4.11.0a1710920591.dist-info}/WHEEL +1 -1
  60. pulumi_vsphere/get_host_base_images.py +0 -97
  61. pulumi_vsphere/offline_software_depot.py +0 -180
  62. pulumi_vsphere/supervisor.py +0 -962
  63. pulumi_vsphere/virtual_machine_class.py +0 -442
  64. pulumi_vsphere-4.11.0.dist-info/RECORD +0 -86
  65. {pulumi_vsphere-4.11.0.dist-info → pulumi_vsphere-4.11.0a1710920591.dist-info}/top_level.txt +0 -0
pulumi_vsphere/host_virtual_switch.py CHANGED
@@ -37,37 +37,58 @@ class HostVirtualSwitchArgs:
37
37
  teaming_policy: Optional[pulumi.Input[str]] = None):
38
38
  """
39
39
  The set of arguments for constructing a HostVirtualSwitch resource.
40
- :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: List of active network adapters used for load balancing.
40
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: The list of active network adapters used for load
41
+ balancing.
41
42
  :param pulumi.Input[str] host_system_id: The managed object ID of
42
43
  the host to set the virtual switch up on. Forces a new resource if changed.
43
- :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The list of network adapters to bind to this virtual switch.
44
- :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
45
- that of its own.
46
- :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
47
- :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
48
- :param pulumi.Input[int] beacon_interval: Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
49
- :param pulumi.Input[bool] check_beacon: Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
50
- only.
51
- :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
52
- :param pulumi.Input[str] link_discovery_operation: Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
53
- :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid values are cdp and lldp.
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`.
54
67
  :param pulumi.Input[int] mtu: The maximum transmission unit (MTU) for the virtual
55
68
  switch. Default: `1500`.
56
69
  :param pulumi.Input[str] name: The name of the virtual switch. Forces a new resource if
57
70
  changed.
58
- :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
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`.
59
74
  :param pulumi.Input[int] number_of_ports: The number of ports to create with this
60
75
  virtual switch. Default: `128`.
61
76
 
62
77
  > **NOTE:** Changing the port count requires a reboot of the host. This provider
63
78
  will not restart the host for you.
64
- :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per second if traffic shaping is enabled.
65
- :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if traffic shaping is enabled.
66
- :param pulumi.Input[bool] shaping_enabled: Enable traffic shaping on this virtual switch or port group.
67
- :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
68
- :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: List of standby network adapters used for failover.
69
- :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
70
- failover_explicit.
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`.
71
92
  """
72
93
  pulumi.set(__self__, "active_nics", active_nics)
73
94
  pulumi.set(__self__, "host_system_id", host_system_id)
@@ -113,7 +134,8 @@ class HostVirtualSwitchArgs:
113
134
  @pulumi.getter(name="activeNics")
114
135
  def active_nics(self) -> pulumi.Input[Sequence[pulumi.Input[str]]]:
115
136
  """
116
- List of active network adapters used for load balancing.
137
+ The list of active network adapters used for load
138
+ balancing.
117
139
  """
118
140
  return pulumi.get(self, "active_nics")
119
141
 
@@ -138,7 +160,7 @@ class HostVirtualSwitchArgs:
138
160
  @pulumi.getter(name="networkAdapters")
139
161
  def network_adapters(self) -> pulumi.Input[Sequence[pulumi.Input[str]]]:
140
162
  """
141
- The list of network adapters to bind to this virtual switch.
163
+ The network interfaces to bind to the bridge.
142
164
  """
143
165
  return pulumi.get(self, "network_adapters")
144
166
 
@@ -150,8 +172,9 @@ class HostVirtualSwitchArgs:
150
172
  @pulumi.getter(name="allowForgedTransmits")
151
173
  def allow_forged_transmits(self) -> Optional[pulumi.Input[bool]]:
152
174
  """
153
- Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
154
- that of its own.
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
178
  """
156
179
  return pulumi.get(self, "allow_forged_transmits")
157
180
 
@@ -163,7 +186,8 @@ class HostVirtualSwitchArgs:
163
186
  @pulumi.getter(name="allowMacChanges")
164
187
  def allow_mac_changes(self) -> Optional[pulumi.Input[bool]]:
165
188
  """
166
- Controls whether or not the Media Access Control (MAC) address can be changed.
189
+ Controls whether or not the Media Access
190
+ Control (MAC) address can be changed. Default: `true`.
167
191
  """
168
192
  return pulumi.get(self, "allow_mac_changes")
169
193
 
@@ -175,7 +199,9 @@ class HostVirtualSwitchArgs:
175
199
  @pulumi.getter(name="allowPromiscuous")
176
200
  def allow_promiscuous(self) -> Optional[pulumi.Input[bool]]:
177
201
  """
178
- Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
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
205
  """
180
206
  return pulumi.get(self, "allow_promiscuous")
181
207
 
@@ -187,7 +213,9 @@ class HostVirtualSwitchArgs:
187
213
  @pulumi.getter(name="beaconInterval")
188
214
  def beacon_interval(self) -> Optional[pulumi.Input[int]]:
189
215
  """
190
- Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
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
219
  """
192
220
  return pulumi.get(self, "beacon_interval")
193
221
 
@@ -199,8 +227,10 @@ class HostVirtualSwitchArgs:
199
227
  @pulumi.getter(name="checkBeacon")
200
228
  def check_beacon(self) -> Optional[pulumi.Input[bool]]:
201
229
  """
202
- Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
203
- only.
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`.
204
234
  """
205
235
  return pulumi.get(self, "check_beacon")
206
236
 
@@ -212,7 +242,9 @@ class HostVirtualSwitchArgs:
212
242
  @pulumi.getter
213
243
  def failback(self) -> Optional[pulumi.Input[bool]]:
214
244
  """
215
- If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
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`.
216
248
  """
217
249
  return pulumi.get(self, "failback")
218
250
 
@@ -224,7 +256,8 @@ class HostVirtualSwitchArgs:
224
256
  @pulumi.getter(name="linkDiscoveryOperation")
225
257
  def link_discovery_operation(self) -> Optional[pulumi.Input[str]]:
226
258
  """
227
- Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
259
+ Whether to `advertise` or `listen`
260
+ for link discovery traffic. Default: `listen`.
228
261
  """
229
262
  return pulumi.get(self, "link_discovery_operation")
230
263
 
@@ -236,7 +269,8 @@ class HostVirtualSwitchArgs:
236
269
  @pulumi.getter(name="linkDiscoveryProtocol")
237
270
  def link_discovery_protocol(self) -> Optional[pulumi.Input[str]]:
238
271
  """
239
- The discovery protocol type. Valid values are cdp and lldp.
272
+ The discovery protocol type. Valid
273
+ types are `cpd` and `lldp`. Default: `cdp`.
240
274
  """
241
275
  return pulumi.get(self, "link_discovery_protocol")
242
276
 
@@ -274,7 +308,9 @@ class HostVirtualSwitchArgs:
274
308
  @pulumi.getter(name="notifySwitches")
275
309
  def notify_switches(self) -> Optional[pulumi.Input[bool]]:
276
310
  """
277
- If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
311
+ If set to `true`, the teaming policy will
312
+ notify the broadcast network of a NIC failover, triggering cache updates.
313
+ Default: `true`.
278
314
  """
279
315
  return pulumi.get(self, "notify_switches")
280
316
 
@@ -302,7 +338,8 @@ class HostVirtualSwitchArgs:
302
338
  @pulumi.getter(name="shapingAverageBandwidth")
303
339
  def shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
304
340
  """
305
- The average bandwidth in bits per second if traffic shaping is enabled.
341
+ The average bandwidth in bits per
342
+ second if traffic shaping is enabled. Default: `0`
306
343
  """
307
344
  return pulumi.get(self, "shaping_average_bandwidth")
308
345
 
@@ -314,7 +351,8 @@ class HostVirtualSwitchArgs:
314
351
  @pulumi.getter(name="shapingBurstSize")
315
352
  def shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
316
353
  """
317
- The maximum burst size allowed in bytes if traffic shaping is enabled.
354
+ The maximum burst size allowed in bytes if
355
+ shaping is enabled. Default: `0`
318
356
  """
319
357
  return pulumi.get(self, "shaping_burst_size")
320
358
 
@@ -326,7 +364,8 @@ class HostVirtualSwitchArgs:
326
364
  @pulumi.getter(name="shapingEnabled")
327
365
  def shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
328
366
  """
329
- Enable traffic shaping on this virtual switch or port group.
367
+ Set to `true` to enable the traffic shaper for
368
+ ports managed by this virtual switch. Default: `false`.
330
369
  """
331
370
  return pulumi.get(self, "shaping_enabled")
332
371
 
@@ -338,7 +377,8 @@ class HostVirtualSwitchArgs:
338
377
  @pulumi.getter(name="shapingPeakBandwidth")
339
378
  def shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
340
379
  """
341
- The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
380
+ The peak bandwidth during bursts in
381
+ bits per second if traffic shaping is enabled. Default: `0`
342
382
  """
343
383
  return pulumi.get(self, "shaping_peak_bandwidth")
344
384
 
@@ -350,7 +390,8 @@ class HostVirtualSwitchArgs:
350
390
  @pulumi.getter(name="standbyNics")
351
391
  def standby_nics(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
352
392
  """
353
- List of standby network adapters used for failover.
393
+ The list of standby network adapters used for
394
+ failover.
354
395
  """
355
396
  return pulumi.get(self, "standby_nics")
356
397
 
@@ -362,8 +403,9 @@ class HostVirtualSwitchArgs:
362
403
  @pulumi.getter(name="teamingPolicy")
363
404
  def teaming_policy(self) -> Optional[pulumi.Input[str]]:
364
405
  """
365
- The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
366
- failover_explicit.
406
+ The network adapter teaming policy. Can be one
407
+ of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
408
+ `failover_explicit`. Default: `loadbalance_srcid`.
367
409
  """
368
410
  return pulumi.get(self, "teaming_policy")
369
411
 
@@ -398,37 +440,58 @@ class _HostVirtualSwitchState:
398
440
  teaming_policy: Optional[pulumi.Input[str]] = None):
399
441
  """
400
442
  Input properties used for looking up and filtering HostVirtualSwitch resources.
401
- :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: List of active network adapters used for load balancing.
402
- :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
403
- that of its own.
404
- :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
405
- :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
406
- :param pulumi.Input[int] beacon_interval: Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
407
- :param pulumi.Input[bool] check_beacon: Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
408
- only.
409
- :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
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`.
410
463
  :param pulumi.Input[str] host_system_id: The managed object ID of
411
464
  the host to set the virtual switch up on. Forces a new resource if changed.
412
- :param pulumi.Input[str] link_discovery_operation: Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
413
- :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid values are cdp and lldp.
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`.
414
469
  :param pulumi.Input[int] mtu: The maximum transmission unit (MTU) for the virtual
415
470
  switch. Default: `1500`.
416
471
  :param pulumi.Input[str] name: The name of the virtual switch. Forces a new resource if
417
472
  changed.
418
- :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The list of network adapters to bind to this virtual switch.
419
- :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
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`.
420
477
  :param pulumi.Input[int] number_of_ports: The number of ports to create with this
421
478
  virtual switch. Default: `128`.
422
479
 
423
480
  > **NOTE:** Changing the port count requires a reboot of the host. This provider
424
481
  will not restart the host for you.
425
- :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per second if traffic shaping is enabled.
426
- :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if traffic shaping is enabled.
427
- :param pulumi.Input[bool] shaping_enabled: Enable traffic shaping on this virtual switch or port group.
428
- :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
429
- :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: List of standby network adapters used for failover.
430
- :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
431
- failover_explicit.
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`.
432
495
  """
433
496
  if active_nics is not None:
434
497
  pulumi.set(__self__, "active_nics", active_nics)
@@ -477,7 +540,8 @@ class _HostVirtualSwitchState:
477
540
  @pulumi.getter(name="activeNics")
478
541
  def active_nics(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
479
542
  """
480
- List of active network adapters used for load balancing.
543
+ The list of active network adapters used for load
544
+ balancing.
481
545
  """
482
546
  return pulumi.get(self, "active_nics")
483
547
 
@@ -489,8 +553,9 @@ class _HostVirtualSwitchState:
489
553
  @pulumi.getter(name="allowForgedTransmits")
490
554
  def allow_forged_transmits(self) -> Optional[pulumi.Input[bool]]:
491
555
  """
492
- Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
493
- that of its own.
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`.
494
559
  """
495
560
  return pulumi.get(self, "allow_forged_transmits")
496
561
 
@@ -502,7 +567,8 @@ class _HostVirtualSwitchState:
502
567
  @pulumi.getter(name="allowMacChanges")
503
568
  def allow_mac_changes(self) -> Optional[pulumi.Input[bool]]:
504
569
  """
505
- Controls whether or not the Media Access Control (MAC) address can be changed.
570
+ Controls whether or not the Media Access
571
+ Control (MAC) address can be changed. Default: `true`.
506
572
  """
507
573
  return pulumi.get(self, "allow_mac_changes")
508
574
 
@@ -514,7 +580,9 @@ class _HostVirtualSwitchState:
514
580
  @pulumi.getter(name="allowPromiscuous")
515
581
  def allow_promiscuous(self) -> Optional[pulumi.Input[bool]]:
516
582
  """
517
- Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
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`.
518
586
  """
519
587
  return pulumi.get(self, "allow_promiscuous")
520
588
 
@@ -526,7 +594,9 @@ class _HostVirtualSwitchState:
526
594
  @pulumi.getter(name="beaconInterval")
527
595
  def beacon_interval(self) -> Optional[pulumi.Input[int]]:
528
596
  """
529
- Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
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`.
530
600
  """
531
601
  return pulumi.get(self, "beacon_interval")
532
602
 
@@ -538,8 +608,10 @@ class _HostVirtualSwitchState:
538
608
  @pulumi.getter(name="checkBeacon")
539
609
  def check_beacon(self) -> Optional[pulumi.Input[bool]]:
540
610
  """
541
- Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
542
- only.
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`.
543
615
  """
544
616
  return pulumi.get(self, "check_beacon")
545
617
 
@@ -551,7 +623,9 @@ class _HostVirtualSwitchState:
551
623
  @pulumi.getter
552
624
  def failback(self) -> Optional[pulumi.Input[bool]]:
553
625
  """
554
- If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
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`.
555
629
  """
556
630
  return pulumi.get(self, "failback")
557
631
 
@@ -576,7 +650,8 @@ class _HostVirtualSwitchState:
576
650
  @pulumi.getter(name="linkDiscoveryOperation")
577
651
  def link_discovery_operation(self) -> Optional[pulumi.Input[str]]:
578
652
  """
579
- Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
653
+ Whether to `advertise` or `listen`
654
+ for link discovery traffic. Default: `listen`.
580
655
  """
581
656
  return pulumi.get(self, "link_discovery_operation")
582
657
 
@@ -588,7 +663,8 @@ class _HostVirtualSwitchState:
588
663
  @pulumi.getter(name="linkDiscoveryProtocol")
589
664
  def link_discovery_protocol(self) -> Optional[pulumi.Input[str]]:
590
665
  """
591
- The discovery protocol type. Valid values are cdp and lldp.
666
+ The discovery protocol type. Valid
667
+ types are `cpd` and `lldp`. Default: `cdp`.
592
668
  """
593
669
  return pulumi.get(self, "link_discovery_protocol")
594
670
 
@@ -626,7 +702,7 @@ class _HostVirtualSwitchState:
626
702
  @pulumi.getter(name="networkAdapters")
627
703
  def network_adapters(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
628
704
  """
629
- The list of network adapters to bind to this virtual switch.
705
+ The network interfaces to bind to the bridge.
630
706
  """
631
707
  return pulumi.get(self, "network_adapters")
632
708
 
@@ -638,7 +714,9 @@ class _HostVirtualSwitchState:
638
714
  @pulumi.getter(name="notifySwitches")
639
715
  def notify_switches(self) -> Optional[pulumi.Input[bool]]:
640
716
  """
641
- If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
717
+ If set to `true`, the teaming policy will
718
+ notify the broadcast network of a NIC failover, triggering cache updates.
719
+ Default: `true`.
642
720
  """
643
721
  return pulumi.get(self, "notify_switches")
644
722
 
@@ -666,7 +744,8 @@ class _HostVirtualSwitchState:
666
744
  @pulumi.getter(name="shapingAverageBandwidth")
667
745
  def shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
668
746
  """
669
- The average bandwidth in bits per second if traffic shaping is enabled.
747
+ The average bandwidth in bits per
748
+ second if traffic shaping is enabled. Default: `0`
670
749
  """
671
750
  return pulumi.get(self, "shaping_average_bandwidth")
672
751
 
@@ -678,7 +757,8 @@ class _HostVirtualSwitchState:
678
757
  @pulumi.getter(name="shapingBurstSize")
679
758
  def shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
680
759
  """
681
- The maximum burst size allowed in bytes if traffic shaping is enabled.
760
+ The maximum burst size allowed in bytes if
761
+ shaping is enabled. Default: `0`
682
762
  """
683
763
  return pulumi.get(self, "shaping_burst_size")
684
764
 
@@ -690,7 +770,8 @@ class _HostVirtualSwitchState:
690
770
  @pulumi.getter(name="shapingEnabled")
691
771
  def shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
692
772
  """
693
- Enable traffic shaping on this virtual switch or port group.
773
+ Set to `true` to enable the traffic shaper for
774
+ ports managed by this virtual switch. Default: `false`.
694
775
  """
695
776
  return pulumi.get(self, "shaping_enabled")
696
777
 
@@ -702,7 +783,8 @@ class _HostVirtualSwitchState:
702
783
  @pulumi.getter(name="shapingPeakBandwidth")
703
784
  def shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
704
785
  """
705
- The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
786
+ The peak bandwidth during bursts in
787
+ bits per second if traffic shaping is enabled. Default: `0`
706
788
  """
707
789
  return pulumi.get(self, "shaping_peak_bandwidth")
708
790
 
@@ -714,7 +796,8 @@ class _HostVirtualSwitchState:
714
796
  @pulumi.getter(name="standbyNics")
715
797
  def standby_nics(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
716
798
  """
717
- List of standby network adapters used for failover.
799
+ The list of standby network adapters used for
800
+ failover.
718
801
  """
719
802
  return pulumi.get(self, "standby_nics")
720
803
 
@@ -726,8 +809,9 @@ class _HostVirtualSwitchState:
726
809
  @pulumi.getter(name="teamingPolicy")
727
810
  def teaming_policy(self) -> Optional[pulumi.Input[str]]:
728
811
  """
729
- The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
730
- failover_explicit.
812
+ The network adapter teaming policy. Can be one
813
+ of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
814
+ `failover_explicit`. Default: `loadbalance_srcid`.
731
815
  """
732
816
  return pulumi.get(self, "teaming_policy")
733
817
 
@@ -767,37 +851,58 @@ class HostVirtualSwitch(pulumi.CustomResource):
767
851
  Create a HostVirtualSwitch resource with the given unique name, props, and options.
768
852
  :param str resource_name: The name of the resource.
769
853
  :param pulumi.ResourceOptions opts: Options for the resource.
770
- :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: List of active network adapters used for load balancing.
771
- :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
772
- that of its own.
773
- :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
774
- :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
775
- :param pulumi.Input[int] beacon_interval: Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
776
- :param pulumi.Input[bool] check_beacon: Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
777
- only.
778
- :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
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`.
779
874
  :param pulumi.Input[str] host_system_id: The managed object ID of
780
875
  the host to set the virtual switch up on. Forces a new resource if changed.
781
- :param pulumi.Input[str] link_discovery_operation: Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
782
- :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid values are cdp and lldp.
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`.
783
880
  :param pulumi.Input[int] mtu: The maximum transmission unit (MTU) for the virtual
784
881
  switch. Default: `1500`.
785
882
  :param pulumi.Input[str] name: The name of the virtual switch. Forces a new resource if
786
883
  changed.
787
- :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The list of network adapters to bind to this virtual switch.
788
- :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
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`.
789
888
  :param pulumi.Input[int] number_of_ports: The number of ports to create with this
790
889
  virtual switch. Default: `128`.
791
890
 
792
891
  > **NOTE:** Changing the port count requires a reboot of the host. This provider
793
892
  will not restart the host for you.
794
- :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per second if traffic shaping is enabled.
795
- :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if traffic shaping is enabled.
796
- :param pulumi.Input[bool] shaping_enabled: Enable traffic shaping on this virtual switch or port group.
797
- :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
798
- :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: List of standby network adapters used for failover.
799
- :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
800
- failover_explicit.
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`.
801
906
  """
802
907
  ...
803
908
  @overload
@@ -917,37 +1022,58 @@ class HostVirtualSwitch(pulumi.CustomResource):
917
1022
  :param str resource_name: The unique name of the resulting resource.
918
1023
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
919
1024
  :param pulumi.ResourceOptions opts: Options for the resource.
920
- :param pulumi.Input[Sequence[pulumi.Input[str]]] active_nics: List of active network adapters used for load balancing.
921
- :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
922
- that of its own.
923
- :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
924
- :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
925
- :param pulumi.Input[int] beacon_interval: Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
926
- :param pulumi.Input[bool] check_beacon: Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
927
- only.
928
- :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
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`.
929
1045
  :param pulumi.Input[str] host_system_id: The managed object ID of
930
1046
  the host to set the virtual switch up on. Forces a new resource if changed.
931
- :param pulumi.Input[str] link_discovery_operation: Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
932
- :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid values are cdp and lldp.
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`.
933
1051
  :param pulumi.Input[int] mtu: The maximum transmission unit (MTU) for the virtual
934
1052
  switch. Default: `1500`.
935
1053
  :param pulumi.Input[str] name: The name of the virtual switch. Forces a new resource if
936
1054
  changed.
937
- :param pulumi.Input[Sequence[pulumi.Input[str]]] network_adapters: The list of network adapters to bind to this virtual switch.
938
- :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
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`.
939
1059
  :param pulumi.Input[int] number_of_ports: The number of ports to create with this
940
1060
  virtual switch. Default: `128`.
941
1061
 
942
1062
  > **NOTE:** Changing the port count requires a reboot of the host. This provider
943
1063
  will not restart the host for you.
944
- :param pulumi.Input[int] shaping_average_bandwidth: The average bandwidth in bits per second if traffic shaping is enabled.
945
- :param pulumi.Input[int] shaping_burst_size: The maximum burst size allowed in bytes if traffic shaping is enabled.
946
- :param pulumi.Input[bool] shaping_enabled: Enable traffic shaping on this virtual switch or port group.
947
- :param pulumi.Input[int] shaping_peak_bandwidth: The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
948
- :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_nics: List of standby network adapters used for failover.
949
- :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
950
- failover_explicit.
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`.
951
1077
  """
952
1078
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
953
1079
 
@@ -980,7 +1106,8 @@ class HostVirtualSwitch(pulumi.CustomResource):
980
1106
  @pulumi.getter(name="activeNics")
981
1107
  def active_nics(self) -> pulumi.Output[Sequence[str]]:
982
1108
  """
983
- List of active network adapters used for load balancing.
1109
+ The list of active network adapters used for load
1110
+ balancing.
984
1111
  """
985
1112
  return pulumi.get(self, "active_nics")
986
1113
 
@@ -988,8 +1115,9 @@ class HostVirtualSwitch(pulumi.CustomResource):
988
1115
  @pulumi.getter(name="allowForgedTransmits")
989
1116
  def allow_forged_transmits(self) -> pulumi.Output[Optional[bool]]:
990
1117
  """
991
- Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
992
- that of its own.
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`.
993
1121
  """
994
1122
  return pulumi.get(self, "allow_forged_transmits")
995
1123
 
@@ -997,7 +1125,8 @@ class HostVirtualSwitch(pulumi.CustomResource):
997
1125
  @pulumi.getter(name="allowMacChanges")
998
1126
  def allow_mac_changes(self) -> pulumi.Output[Optional[bool]]:
999
1127
  """
1000
- Controls whether or not the Media Access Control (MAC) address can be changed.
1128
+ Controls whether or not the Media Access
1129
+ Control (MAC) address can be changed. Default: `true`.
1001
1130
  """
1002
1131
  return pulumi.get(self, "allow_mac_changes")
1003
1132
 
@@ -1005,7 +1134,9 @@ class HostVirtualSwitch(pulumi.CustomResource):
1005
1134
  @pulumi.getter(name="allowPromiscuous")
1006
1135
  def allow_promiscuous(self) -> pulumi.Output[Optional[bool]]:
1007
1136
  """
1008
- Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
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`.
1009
1140
  """
1010
1141
  return pulumi.get(self, "allow_promiscuous")
1011
1142
 
@@ -1013,7 +1144,9 @@ class HostVirtualSwitch(pulumi.CustomResource):
1013
1144
  @pulumi.getter(name="beaconInterval")
1014
1145
  def beacon_interval(self) -> pulumi.Output[Optional[int]]:
1015
1146
  """
1016
- Determines how often, in seconds, a beacon should be sent to probe for the validity of a link.
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`.
1017
1150
  """
1018
1151
  return pulumi.get(self, "beacon_interval")
1019
1152
 
@@ -1021,8 +1154,10 @@ class HostVirtualSwitch(pulumi.CustomResource):
1021
1154
  @pulumi.getter(name="checkBeacon")
1022
1155
  def check_beacon(self) -> pulumi.Output[Optional[bool]]:
1023
1156
  """
1024
- Enable beacon probing. Requires that the vSwitch has been configured to use a beacon. If disabled, link status is used
1025
- only.
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`.
1026
1161
  """
1027
1162
  return pulumi.get(self, "check_beacon")
1028
1163
 
@@ -1030,7 +1165,9 @@ class HostVirtualSwitch(pulumi.CustomResource):
1030
1165
  @pulumi.getter
1031
1166
  def failback(self) -> pulumi.Output[Optional[bool]]:
1032
1167
  """
1033
- If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
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`.
1034
1171
  """
1035
1172
  return pulumi.get(self, "failback")
1036
1173
 
@@ -1047,7 +1184,8 @@ class HostVirtualSwitch(pulumi.CustomResource):
1047
1184
  @pulumi.getter(name="linkDiscoveryOperation")
1048
1185
  def link_discovery_operation(self) -> pulumi.Output[Optional[str]]:
1049
1186
  """
1050
- Whether to advertise or listen for link discovery. Valid values are advertise, both, listen, and none.
1187
+ Whether to `advertise` or `listen`
1188
+ for link discovery traffic. Default: `listen`.
1051
1189
  """
1052
1190
  return pulumi.get(self, "link_discovery_operation")
1053
1191
 
@@ -1055,7 +1193,8 @@ class HostVirtualSwitch(pulumi.CustomResource):
1055
1193
  @pulumi.getter(name="linkDiscoveryProtocol")
1056
1194
  def link_discovery_protocol(self) -> pulumi.Output[Optional[str]]:
1057
1195
  """
1058
- The discovery protocol type. Valid values are cdp and lldp.
1196
+ The discovery protocol type. Valid
1197
+ types are `cpd` and `lldp`. Default: `cdp`.
1059
1198
  """
1060
1199
  return pulumi.get(self, "link_discovery_protocol")
1061
1200
 
@@ -1081,7 +1220,7 @@ class HostVirtualSwitch(pulumi.CustomResource):
1081
1220
  @pulumi.getter(name="networkAdapters")
1082
1221
  def network_adapters(self) -> pulumi.Output[Sequence[str]]:
1083
1222
  """
1084
- The list of network adapters to bind to this virtual switch.
1223
+ The network interfaces to bind to the bridge.
1085
1224
  """
1086
1225
  return pulumi.get(self, "network_adapters")
1087
1226
 
@@ -1089,7 +1228,9 @@ class HostVirtualSwitch(pulumi.CustomResource):
1089
1228
  @pulumi.getter(name="notifySwitches")
1090
1229
  def notify_switches(self) -> pulumi.Output[Optional[bool]]:
1091
1230
  """
1092
- If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
1231
+ If set to `true`, the teaming policy will
1232
+ notify the broadcast network of a NIC failover, triggering cache updates.
1233
+ Default: `true`.
1093
1234
  """
1094
1235
  return pulumi.get(self, "notify_switches")
1095
1236
 
@@ -1109,7 +1250,8 @@ class HostVirtualSwitch(pulumi.CustomResource):
1109
1250
  @pulumi.getter(name="shapingAverageBandwidth")
1110
1251
  def shaping_average_bandwidth(self) -> pulumi.Output[Optional[int]]:
1111
1252
  """
1112
- The average bandwidth in bits per second if traffic shaping is enabled.
1253
+ The average bandwidth in bits per
1254
+ second if traffic shaping is enabled. Default: `0`
1113
1255
  """
1114
1256
  return pulumi.get(self, "shaping_average_bandwidth")
1115
1257
 
@@ -1117,7 +1259,8 @@ class HostVirtualSwitch(pulumi.CustomResource):
1117
1259
  @pulumi.getter(name="shapingBurstSize")
1118
1260
  def shaping_burst_size(self) -> pulumi.Output[Optional[int]]:
1119
1261
  """
1120
- The maximum burst size allowed in bytes if traffic shaping is enabled.
1262
+ The maximum burst size allowed in bytes if
1263
+ shaping is enabled. Default: `0`
1121
1264
  """
1122
1265
  return pulumi.get(self, "shaping_burst_size")
1123
1266
 
@@ -1125,7 +1268,8 @@ class HostVirtualSwitch(pulumi.CustomResource):
1125
1268
  @pulumi.getter(name="shapingEnabled")
1126
1269
  def shaping_enabled(self) -> pulumi.Output[Optional[bool]]:
1127
1270
  """
1128
- Enable traffic shaping on this virtual switch or port group.
1271
+ Set to `true` to enable the traffic shaper for
1272
+ ports managed by this virtual switch. Default: `false`.
1129
1273
  """
1130
1274
  return pulumi.get(self, "shaping_enabled")
1131
1275
 
@@ -1133,7 +1277,8 @@ class HostVirtualSwitch(pulumi.CustomResource):
1133
1277
  @pulumi.getter(name="shapingPeakBandwidth")
1134
1278
  def shaping_peak_bandwidth(self) -> pulumi.Output[Optional[int]]:
1135
1279
  """
1136
- The peak bandwidth during bursts in bits per second if traffic shaping is enabled.
1280
+ The peak bandwidth during bursts in
1281
+ bits per second if traffic shaping is enabled. Default: `0`
1137
1282
  """
1138
1283
  return pulumi.get(self, "shaping_peak_bandwidth")
1139
1284
 
@@ -1141,7 +1286,8 @@ class HostVirtualSwitch(pulumi.CustomResource):
1141
1286
  @pulumi.getter(name="standbyNics")
1142
1287
  def standby_nics(self) -> pulumi.Output[Optional[Sequence[str]]]:
1143
1288
  """
1144
- List of standby network adapters used for failover.
1289
+ The list of standby network adapters used for
1290
+ failover.
1145
1291
  """
1146
1292
  return pulumi.get(self, "standby_nics")
1147
1293
 
@@ -1149,8 +1295,9 @@ class HostVirtualSwitch(pulumi.CustomResource):
1149
1295
  @pulumi.getter(name="teamingPolicy")
1150
1296
  def teaming_policy(self) -> pulumi.Output[Optional[str]]:
1151
1297
  """
1152
- The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, or
1153
- failover_explicit.
1298
+ The network adapter teaming policy. Can be one
1299
+ of `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`, or
1300
+ `failover_explicit`. Default: `loadbalance_srcid`.
1154
1301
  """
1155
1302
  return pulumi.get(self, "teaming_policy")
1156
1303