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/distributed_virtual_switch.py CHANGED
@@ -114,17 +114,29 @@ class DistributedVirtualSwitchArgs:
114
114
  The set of arguments for constructing a DistributedVirtualSwitch resource.
115
115
  :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VDS will be
116
116
  created. Forces a new resource if changed.
117
- :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
118
- :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
119
- that of its own.
120
- :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
121
- :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.
117
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: A list of active uplinks to be used in load
118
+ balancing. These uplinks need to match the definitions in the
119
+ `uplinks` VDS argument. See
120
+ here for more details.
121
+ :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not a virtual
122
+ network adapter is allowed to send network traffic with a different MAC
123
+ address than that of its own.
124
+ :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
125
+ Control (MAC) address can be changed.
126
+ :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
127
+ flag indicates whether or not all traffic is seen on a given port.
122
128
  :param pulumi.Input[int] backupnfc_maximum_mbit: The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
123
129
  :param pulumi.Input[int] backupnfc_reservation_mbit: The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
124
130
  :param pulumi.Input[int] backupnfc_share_count: The amount of shares to allocate to the backupNfc traffic class for a custom share level.
125
131
  :param pulumi.Input[str] backupnfc_share_level: The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
126
- :param pulumi.Input[bool] block_all_ports: Indicates whether to block all ports by default.
127
- :param pulumi.Input[bool] check_beacon: Enable beacon probing on the ports this policy applies to.
132
+ :param pulumi.Input[bool] block_all_ports: Shuts down all ports in the port groups that
133
+ this policy applies to, effectively blocking all network access to connected
134
+ virtual devices.
135
+ :param pulumi.Input[bool] check_beacon: Enables beacon probing as an additional measure
136
+ to detect NIC failure.
137
+
138
+ > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
139
+ probing.
128
140
  :param pulumi.Input[str] contact_detail: The detailed contact information for the person
129
141
  who is responsible for the VDS.
130
142
  :param pulumi.Input[str] contact_name: The name of the person who is responsible for the
@@ -135,12 +147,18 @@ class DistributedVirtualSwitchArgs:
135
147
  > **NOTE:** Custom attributes are unsupported on direct ESXi host connections
136
148
  and requires vCenter Server.
137
149
  :param pulumi.Input[str] description: A detailed description for the VDS.
138
- :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 on the ports this policy applies to.
139
- :param pulumi.Input[int] egress_shaping_average_bandwidth: The average egress bandwidth in bits per second if egress shaping is enabled on the port.
140
- :param pulumi.Input[int] egress_shaping_burst_size: The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
141
- :param pulumi.Input[bool] egress_shaping_enabled: True if the traffic shaper is enabled for egress traffic on the port.
142
- :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
143
- :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
150
+ :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 for the ports
151
+ for which this policy applies to.
152
+ :param pulumi.Input[int] egress_shaping_average_bandwidth: The average bandwidth in bits
153
+ per second if egress traffic shaping is enabled on the port.
154
+ :param pulumi.Input[int] egress_shaping_burst_size: The maximum burst size allowed in
155
+ bytes if egress traffic shaping is enabled on the port.
156
+ :param pulumi.Input[bool] egress_shaping_enabled: `true` if the traffic shaper is enabled
157
+ on the port for egress traffic.
158
+ :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak bandwidth during bursts
159
+ in bits per second if egress traffic shaping is enabled on the port.
160
+ :param pulumi.Input[bool] failback: If `true`, the teaming policy will re-activate failed
161
+ uplinks higher in precedence when they come back up.
144
162
  :param pulumi.Input[int] faulttolerance_maximum_mbit: The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
145
163
  :param pulumi.Input[int] faulttolerance_reservation_mbit: The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
146
164
  :param pulumi.Input[int] faulttolerance_share_count: The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
@@ -151,12 +169,18 @@ class DistributedVirtualSwitchArgs:
151
169
  :param pulumi.Input[int] hbr_reservation_mbit: The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
152
170
  :param pulumi.Input[int] hbr_share_count: The amount of shares to allocate to the hbr traffic class for a custom share level.
153
171
  :param pulumi.Input[str] hbr_share_level: The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
154
- :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchHostArgs']]] hosts: A host member specification.
155
- :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
156
- :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
157
- :param pulumi.Input[int] ingress_shaping_burst_size: The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
158
- :param pulumi.Input[bool] ingress_shaping_enabled: True if the traffic shaper is enabled for ingress traffic on the port.
159
- :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
172
+ :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchHostArgs']]] hosts: Use the `host` block to declare a host specification. The
173
+ options are:
174
+ :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN
175
+ mappings not managed by this resource. Defaults to false.
176
+ :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average bandwidth in
177
+ bits per second if ingress traffic shaping is enabled on the port.
178
+ :param pulumi.Input[int] ingress_shaping_burst_size: The maximum burst size allowed in
179
+ bytes if ingress traffic shaping is enabled on the port.
180
+ :param pulumi.Input[bool] ingress_shaping_enabled: `true` if the traffic shaper is
181
+ enabled on the port for ingress traffic.
182
+ :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak bandwidth during
183
+ bursts in bits per second if ingress traffic shaping is enabled on the port.
160
184
  :param pulumi.Input[str] ipv4_address: An IPv4 address to identify the switch. This is
161
185
  mostly useful when used with the Netflow arguments.
162
186
  :param pulumi.Input[int] iscsi_maximum_mbit: The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
@@ -166,8 +190,9 @@ class DistributedVirtualSwitchArgs:
166
190
  :param pulumi.Input[str] lacp_api_version: The Link Aggregation Control Protocol group
167
191
  version to use with the VDS. Possible values are `singleLag` and
168
192
  `multipleLag`.
169
- :param pulumi.Input[bool] lacp_enabled: Whether or not to enable LACP on all uplink ports.
170
- :param pulumi.Input[str] lacp_mode: The uplink LACP mode to use. Can be one of active or passive.
193
+ :param pulumi.Input[bool] lacp_enabled: Enables LACP for the ports that this policy
194
+ applies to.
195
+ :param pulumi.Input[str] lacp_mode: The LACP mode. Can be one of `active` or `passive`.
171
196
  :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
172
197
  for link discovery traffic.
173
198
  :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid
@@ -180,32 +205,60 @@ class DistributedVirtualSwitchArgs:
180
205
  :param pulumi.Input[str] multicast_filtering_mode: The multicast filtering mode to use
181
206
  with the VDS. Can be one of `legacyFiltering` or `snooping`.
182
207
  :param pulumi.Input[str] name: The name of the VDS.
183
- :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which active flows are forced to be exported to the collector.
184
- :param pulumi.Input[str] netflow_collector_ip_address: IP address for the netflow collector, using IPv4 or IPv6.
185
- :param pulumi.Input[int] netflow_collector_port: The port for the netflow collector.
186
- :param pulumi.Input[bool] netflow_enabled: Indicates whether to enable netflow on all ports.
187
- :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which idle flows are forced to be exported to the collector.
188
- :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to traffic that has both source and destination served by the same host.
189
- :param pulumi.Input[int] netflow_observation_domain_id: The observation Domain ID for the netflow collector.
190
- :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
191
- packets are analyzed.
192
- :param pulumi.Input[bool] network_resource_control_enabled: Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
193
- :param pulumi.Input[str] network_resource_control_version: The network I/O control version to use. Can be one of version2 or version3.
208
+ :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which
209
+ active flows are forced to be exported to the collector. Allowed range is
210
+ `60` to `3600`. Default: `60`.
211
+ :param pulumi.Input[str] netflow_collector_ip_address: IP address for the Netflow
212
+ collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
213
+ Must be set before Netflow can be enabled.
214
+ :param pulumi.Input[int] netflow_collector_port: Port for the Netflow collector. This
215
+ must be set before Netflow can be enabled.
216
+ :param pulumi.Input[bool] netflow_enabled: Enables Netflow on all ports that this policy
217
+ applies to.
218
+ :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which
219
+ idle flows are forced to be exported to the collector. Allowed range is `10`
220
+ to `600`. Default: `15`.
221
+ :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to
222
+ traffic that has both source and destination served by the same host.
223
+ Default: `false`.
224
+ :param pulumi.Input[int] netflow_observation_domain_id: The observation domain ID for
225
+ the Netflow collector.
226
+ :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to
227
+ the number of packets analyzed. The default is `0`, which indicates that the
228
+ VDS should analyze all packets. The maximum value is `1000`, which
229
+ indicates an analysis rate of 0.001%!
230
+ (MISSING)
231
+ :param pulumi.Input[bool] network_resource_control_enabled: Set to `true` to enable
232
+ network I/O control. Default: `false`.
233
+ :param pulumi.Input[str] network_resource_control_version: The version of network I/O
234
+ control to use. Can be one of `version2` or `version3`. Default: `version2`.
194
235
  :param pulumi.Input[int] nfs_maximum_mbit: The maximum allowed usage for the nfs traffic class, in Mbits/sec.
195
236
  :param pulumi.Input[int] nfs_reservation_mbit: The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
196
237
  :param pulumi.Input[int] nfs_share_count: The amount of shares to allocate to the nfs traffic class for a custom share level.
197
238
  :param pulumi.Input[str] nfs_share_level: The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
198
- :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
199
- :param pulumi.Input[int] port_private_secondary_vlan_id: The secondary VLAN ID for this port.
200
- :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchPvlanMappingArgs']]] pvlan_mappings: A private VLAN (PVLAN) mapping.
201
- :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
239
+ :param pulumi.Input[bool] notify_switches: If `true`, the teaming policy will notify the
240
+ broadcast network of an uplink failover, triggering cache updates.
241
+ :param pulumi.Input[int] port_private_secondary_vlan_id: Used to define a secondary VLAN
242
+ ID when using private VLANs.
243
+ :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchPvlanMappingArgs']]] pvlan_mappings: Use the `pvlan_mapping` block to declare a
244
+ private VLAN mapping. The options are:
245
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: A list of standby uplinks to be used in
246
+ failover. These uplinks need to match the definitions in the
247
+ `uplinks` VDS argument. See
248
+ here for more details.
202
249
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
203
- :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
204
- failover_explicit, or loadbalance_loadbased.
205
- :param pulumi.Input[bool] tx_uplink: If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
206
- forwarded done by the switch.
207
- :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
208
- across hosts.
250
+
251
+ > **NOTE:** Tagging support requires vCenter Server 6.0 or higher.
252
+ :param pulumi.Input[str] teaming_policy: The uplink teaming policy. Can be one of
253
+ `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
254
+ `failover_explicit`, or `loadbalance_loadbased`.
255
+ :param pulumi.Input[bool] tx_uplink: Forward all traffic transmitted by ports for which
256
+ this policy applies to its VDS uplinks.
257
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of strings that uniquely identifies the names
258
+ of the uplinks on the VDS across hosts. The number of items in this list
259
+ controls the number of uplinks that exist on the VDS, in addition to the
260
+ names. See here for an example on how to
261
+ use this option.
209
262
  :param pulumi.Input[int] vdp_maximum_mbit: The maximum allowed usage for the vdp traffic class, in Mbits/sec.
210
263
  :param pulumi.Input[int] vdp_reservation_mbit: The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
211
264
  :param pulumi.Input[int] vdp_share_count: The amount of shares to allocate to the vdp traffic class for a custom share level.
@@ -218,7 +271,28 @@ class DistributedVirtualSwitchArgs:
218
271
  :param pulumi.Input[int] virtualmachine_share_count: The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
219
272
  :param pulumi.Input[str] virtualmachine_share_level: The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
220
273
  :param pulumi.Input[int] vlan_id: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
221
- :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchVlanRangeArgs']]] vlan_ranges: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
274
+ :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchVlanRangeArgs']]] vlan_ranges: Used to denote VLAN trunking. Use the `min_vlan`
275
+ and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
276
+ `vlan_range` definitions are allowed, but they must not overlap. Example
277
+ below:
278
+
279
+ <!--Start PulumiCodeChooser -->
280
+ ```python
281
+ import pulumi
282
+ import pulumi_vsphere as vsphere
283
+
284
+ vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
285
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
286
+ max_vlan=199,
287
+ min_vlan=100,
288
+ ),
289
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
290
+ max_vlan=399,
291
+ min_vlan=300,
292
+ ),
293
+ ])
294
+ ```
295
+ <!--End PulumiCodeChooser -->
222
296
  :param pulumi.Input[int] vmotion_maximum_mbit: The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
223
297
  :param pulumi.Input[int] vmotion_reservation_mbit: The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
224
298
  :param pulumi.Input[int] vmotion_share_count: The amount of shares to allocate to the vmotion traffic class for a custom share level.
@@ -433,7 +507,10 @@ class DistributedVirtualSwitchArgs:
433
507
  @pulumi.getter(name="activeUplinks")
434
508
  def active_uplinks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
435
509
  """
436
- List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
510
+ A list of active uplinks to be used in load
511
+ balancing. These uplinks need to match the definitions in the
512
+ `uplinks` VDS argument. See
513
+ here for more details.
437
514
  """
438
515
  return pulumi.get(self, "active_uplinks")
439
516
 
@@ -445,8 +522,9 @@ class DistributedVirtualSwitchArgs:
445
522
  @pulumi.getter(name="allowForgedTransmits")
446
523
  def allow_forged_transmits(self) -> Optional[pulumi.Input[bool]]:
447
524
  """
448
- Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
449
- that of its own.
525
+ Controls whether or not a virtual
526
+ network adapter is allowed to send network traffic with a different MAC
527
+ address than that of its own.
450
528
  """
451
529
  return pulumi.get(self, "allow_forged_transmits")
452
530
 
@@ -458,7 +536,8 @@ class DistributedVirtualSwitchArgs:
458
536
  @pulumi.getter(name="allowMacChanges")
459
537
  def allow_mac_changes(self) -> Optional[pulumi.Input[bool]]:
460
538
  """
461
- Controls whether or not the Media Access Control (MAC) address can be changed.
539
+ Controls whether or not the Media Access
540
+ Control (MAC) address can be changed.
462
541
  """
463
542
  return pulumi.get(self, "allow_mac_changes")
464
543
 
@@ -470,7 +549,8 @@ class DistributedVirtualSwitchArgs:
470
549
  @pulumi.getter(name="allowPromiscuous")
471
550
  def allow_promiscuous(self) -> Optional[pulumi.Input[bool]]:
472
551
  """
473
- Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
552
+ Enable promiscuous mode on the network. This
553
+ flag indicates whether or not all traffic is seen on a given port.
474
554
  """
475
555
  return pulumi.get(self, "allow_promiscuous")
476
556
 
@@ -530,7 +610,9 @@ class DistributedVirtualSwitchArgs:
530
610
  @pulumi.getter(name="blockAllPorts")
531
611
  def block_all_ports(self) -> Optional[pulumi.Input[bool]]:
532
612
  """
533
- Indicates whether to block all ports by default.
613
+ Shuts down all ports in the port groups that
614
+ this policy applies to, effectively blocking all network access to connected
615
+ virtual devices.
534
616
  """
535
617
  return pulumi.get(self, "block_all_ports")
536
618
 
@@ -542,7 +624,11 @@ class DistributedVirtualSwitchArgs:
542
624
  @pulumi.getter(name="checkBeacon")
543
625
  def check_beacon(self) -> Optional[pulumi.Input[bool]]:
544
626
  """
545
- Enable beacon probing on the ports this policy applies to.
627
+ Enables beacon probing as an additional measure
628
+ to detect NIC failure.
629
+
630
+ > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
631
+ probing.
546
632
  """
547
633
  return pulumi.get(self, "check_beacon")
548
634
 
@@ -608,7 +694,8 @@ class DistributedVirtualSwitchArgs:
608
694
  @pulumi.getter(name="directpathGen2Allowed")
609
695
  def directpath_gen2_allowed(self) -> Optional[pulumi.Input[bool]]:
610
696
  """
611
- Allow VMDirectPath Gen2 on the ports this policy applies to.
697
+ Allow VMDirectPath Gen2 for the ports
698
+ for which this policy applies to.
612
699
  """
613
700
  return pulumi.get(self, "directpath_gen2_allowed")
614
701
 
@@ -620,7 +707,8 @@ class DistributedVirtualSwitchArgs:
620
707
  @pulumi.getter(name="egressShapingAverageBandwidth")
621
708
  def egress_shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
622
709
  """
623
- The average egress bandwidth in bits per second if egress shaping is enabled on the port.
710
+ The average bandwidth in bits
711
+ per second if egress traffic shaping is enabled on the port.
624
712
  """
625
713
  return pulumi.get(self, "egress_shaping_average_bandwidth")
626
714
 
@@ -632,7 +720,8 @@ class DistributedVirtualSwitchArgs:
632
720
  @pulumi.getter(name="egressShapingBurstSize")
633
721
  def egress_shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
634
722
  """
635
- The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
723
+ The maximum burst size allowed in
724
+ bytes if egress traffic shaping is enabled on the port.
636
725
  """
637
726
  return pulumi.get(self, "egress_shaping_burst_size")
638
727
 
@@ -644,7 +733,8 @@ class DistributedVirtualSwitchArgs:
644
733
  @pulumi.getter(name="egressShapingEnabled")
645
734
  def egress_shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
646
735
  """
647
- True if the traffic shaper is enabled for egress traffic on the port.
736
+ `true` if the traffic shaper is enabled
737
+ on the port for egress traffic.
648
738
  """
649
739
  return pulumi.get(self, "egress_shaping_enabled")
650
740
 
@@ -656,7 +746,8 @@ class DistributedVirtualSwitchArgs:
656
746
  @pulumi.getter(name="egressShapingPeakBandwidth")
657
747
  def egress_shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
658
748
  """
659
- The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
749
+ The peak bandwidth during bursts
750
+ in bits per second if egress traffic shaping is enabled on the port.
660
751
  """
661
752
  return pulumi.get(self, "egress_shaping_peak_bandwidth")
662
753
 
@@ -668,7 +759,8 @@ class DistributedVirtualSwitchArgs:
668
759
  @pulumi.getter
669
760
  def failback(self) -> Optional[pulumi.Input[bool]]:
670
761
  """
671
- If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
762
+ If `true`, the teaming policy will re-activate failed
763
+ uplinks higher in precedence when they come back up.
672
764
  """
673
765
  return pulumi.get(self, "failback")
674
766
 
@@ -789,7 +881,8 @@ class DistributedVirtualSwitchArgs:
789
881
  @pulumi.getter
790
882
  def hosts(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchHostArgs']]]]:
791
883
  """
792
- A host member specification.
884
+ Use the `host` block to declare a host specification. The
885
+ options are:
793
886
  """
794
887
  return pulumi.get(self, "hosts")
795
888
 
@@ -801,7 +894,8 @@ class DistributedVirtualSwitchArgs:
801
894
  @pulumi.getter(name="ignoreOtherPvlanMappings")
802
895
  def ignore_other_pvlan_mappings(self) -> Optional[pulumi.Input[bool]]:
803
896
  """
804
- Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
897
+ Whether to ignore existing PVLAN
898
+ mappings not managed by this resource. Defaults to false.
805
899
  """
806
900
  return pulumi.get(self, "ignore_other_pvlan_mappings")
807
901
 
@@ -813,7 +907,8 @@ class DistributedVirtualSwitchArgs:
813
907
  @pulumi.getter(name="ingressShapingAverageBandwidth")
814
908
  def ingress_shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
815
909
  """
816
- The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
910
+ The average bandwidth in
911
+ bits per second if ingress traffic shaping is enabled on the port.
817
912
  """
818
913
  return pulumi.get(self, "ingress_shaping_average_bandwidth")
819
914
 
@@ -825,7 +920,8 @@ class DistributedVirtualSwitchArgs:
825
920
  @pulumi.getter(name="ingressShapingBurstSize")
826
921
  def ingress_shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
827
922
  """
828
- The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
923
+ The maximum burst size allowed in
924
+ bytes if ingress traffic shaping is enabled on the port.
829
925
  """
830
926
  return pulumi.get(self, "ingress_shaping_burst_size")
831
927
 
@@ -837,7 +933,8 @@ class DistributedVirtualSwitchArgs:
837
933
  @pulumi.getter(name="ingressShapingEnabled")
838
934
  def ingress_shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
839
935
  """
840
- True if the traffic shaper is enabled for ingress traffic on the port.
936
+ `true` if the traffic shaper is
937
+ enabled on the port for ingress traffic.
841
938
  """
842
939
  return pulumi.get(self, "ingress_shaping_enabled")
843
940
 
@@ -849,7 +946,8 @@ class DistributedVirtualSwitchArgs:
849
946
  @pulumi.getter(name="ingressShapingPeakBandwidth")
850
947
  def ingress_shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
851
948
  """
852
- The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
949
+ The peak bandwidth during
950
+ bursts in bits per second if ingress traffic shaping is enabled on the port.
853
951
  """
854
952
  return pulumi.get(self, "ingress_shaping_peak_bandwidth")
855
953
 
@@ -936,7 +1034,8 @@ class DistributedVirtualSwitchArgs:
936
1034
  @pulumi.getter(name="lacpEnabled")
937
1035
  def lacp_enabled(self) -> Optional[pulumi.Input[bool]]:
938
1036
  """
939
- Whether or not to enable LACP on all uplink ports.
1037
+ Enables LACP for the ports that this policy
1038
+ applies to.
940
1039
  """
941
1040
  return pulumi.get(self, "lacp_enabled")
942
1041
 
@@ -948,7 +1047,7 @@ class DistributedVirtualSwitchArgs:
948
1047
  @pulumi.getter(name="lacpMode")
949
1048
  def lacp_mode(self) -> Optional[pulumi.Input[str]]:
950
1049
  """
951
- The uplink LACP mode to use. Can be one of active or passive.
1050
+ The LACP mode. Can be one of `active` or `passive`.
952
1051
  """
953
1052
  return pulumi.get(self, "lacp_mode")
954
1053
 
@@ -1071,7 +1170,9 @@ class DistributedVirtualSwitchArgs:
1071
1170
  @pulumi.getter(name="netflowActiveFlowTimeout")
1072
1171
  def netflow_active_flow_timeout(self) -> Optional[pulumi.Input[int]]:
1073
1172
  """
1074
- The number of seconds after which active flows are forced to be exported to the collector.
1173
+ The number of seconds after which
1174
+ active flows are forced to be exported to the collector. Allowed range is
1175
+ `60` to `3600`. Default: `60`.
1075
1176
  """
1076
1177
  return pulumi.get(self, "netflow_active_flow_timeout")
1077
1178
 
@@ -1083,7 +1184,9 @@ class DistributedVirtualSwitchArgs:
1083
1184
  @pulumi.getter(name="netflowCollectorIpAddress")
1084
1185
  def netflow_collector_ip_address(self) -> Optional[pulumi.Input[str]]:
1085
1186
  """
1086
- IP address for the netflow collector, using IPv4 or IPv6.
1187
+ IP address for the Netflow
1188
+ collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
1189
+ Must be set before Netflow can be enabled.
1087
1190
  """
1088
1191
  return pulumi.get(self, "netflow_collector_ip_address")
1089
1192
 
@@ -1095,7 +1198,8 @@ class DistributedVirtualSwitchArgs:
1095
1198
  @pulumi.getter(name="netflowCollectorPort")
1096
1199
  def netflow_collector_port(self) -> Optional[pulumi.Input[int]]:
1097
1200
  """
1098
- The port for the netflow collector.
1201
+ Port for the Netflow collector. This
1202
+ must be set before Netflow can be enabled.
1099
1203
  """
1100
1204
  return pulumi.get(self, "netflow_collector_port")
1101
1205
 
@@ -1107,7 +1211,8 @@ class DistributedVirtualSwitchArgs:
1107
1211
  @pulumi.getter(name="netflowEnabled")
1108
1212
  def netflow_enabled(self) -> Optional[pulumi.Input[bool]]:
1109
1213
  """
1110
- Indicates whether to enable netflow on all ports.
1214
+ Enables Netflow on all ports that this policy
1215
+ applies to.
1111
1216
  """
1112
1217
  return pulumi.get(self, "netflow_enabled")
1113
1218
 
@@ -1119,7 +1224,9 @@ class DistributedVirtualSwitchArgs:
1119
1224
  @pulumi.getter(name="netflowIdleFlowTimeout")
1120
1225
  def netflow_idle_flow_timeout(self) -> Optional[pulumi.Input[int]]:
1121
1226
  """
1122
- The number of seconds after which idle flows are forced to be exported to the collector.
1227
+ The number of seconds after which
1228
+ idle flows are forced to be exported to the collector. Allowed range is `10`
1229
+ to `600`. Default: `15`.
1123
1230
  """
1124
1231
  return pulumi.get(self, "netflow_idle_flow_timeout")
1125
1232
 
@@ -1131,7 +1238,9 @@ class DistributedVirtualSwitchArgs:
1131
1238
  @pulumi.getter(name="netflowInternalFlowsOnly")
1132
1239
  def netflow_internal_flows_only(self) -> Optional[pulumi.Input[bool]]:
1133
1240
  """
1134
- Whether to limit analysis to traffic that has both source and destination served by the same host.
1241
+ Whether to limit analysis to
1242
+ traffic that has both source and destination served by the same host.
1243
+ Default: `false`.
1135
1244
  """
1136
1245
  return pulumi.get(self, "netflow_internal_flows_only")
1137
1246
 
@@ -1143,7 +1252,8 @@ class DistributedVirtualSwitchArgs:
1143
1252
  @pulumi.getter(name="netflowObservationDomainId")
1144
1253
  def netflow_observation_domain_id(self) -> Optional[pulumi.Input[int]]:
1145
1254
  """
1146
- The observation Domain ID for the netflow collector.
1255
+ The observation domain ID for
1256
+ the Netflow collector.
1147
1257
  """
1148
1258
  return pulumi.get(self, "netflow_observation_domain_id")
1149
1259
 
@@ -1155,8 +1265,11 @@ class DistributedVirtualSwitchArgs:
1155
1265
  @pulumi.getter(name="netflowSamplingRate")
1156
1266
  def netflow_sampling_rate(self) -> Optional[pulumi.Input[int]]:
1157
1267
  """
1158
- The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
1159
- packets are analyzed.
1268
+ The ratio of total number of packets to
1269
+ the number of packets analyzed. The default is `0`, which indicates that the
1270
+ VDS should analyze all packets. The maximum value is `1000`, which
1271
+ indicates an analysis rate of 0.001%!
1272
+ (MISSING)
1160
1273
  """
1161
1274
  return pulumi.get(self, "netflow_sampling_rate")
1162
1275
 
@@ -1168,7 +1281,8 @@ class DistributedVirtualSwitchArgs:
1168
1281
  @pulumi.getter(name="networkResourceControlEnabled")
1169
1282
  def network_resource_control_enabled(self) -> Optional[pulumi.Input[bool]]:
1170
1283
  """
1171
- Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
1284
+ Set to `true` to enable
1285
+ network I/O control. Default: `false`.
1172
1286
  """
1173
1287
  return pulumi.get(self, "network_resource_control_enabled")
1174
1288
 
@@ -1180,7 +1294,8 @@ class DistributedVirtualSwitchArgs:
1180
1294
  @pulumi.getter(name="networkResourceControlVersion")
1181
1295
  def network_resource_control_version(self) -> Optional[pulumi.Input[str]]:
1182
1296
  """
1183
- The network I/O control version to use. Can be one of version2 or version3.
1297
+ The version of network I/O
1298
+ control to use. Can be one of `version2` or `version3`. Default: `version2`.
1184
1299
  """
1185
1300
  return pulumi.get(self, "network_resource_control_version")
1186
1301
 
@@ -1240,7 +1355,8 @@ class DistributedVirtualSwitchArgs:
1240
1355
  @pulumi.getter(name="notifySwitches")
1241
1356
  def notify_switches(self) -> Optional[pulumi.Input[bool]]:
1242
1357
  """
1243
- If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
1358
+ If `true`, the teaming policy will notify the
1359
+ broadcast network of an uplink failover, triggering cache updates.
1244
1360
  """
1245
1361
  return pulumi.get(self, "notify_switches")
1246
1362
 
@@ -1252,7 +1368,8 @@ class DistributedVirtualSwitchArgs:
1252
1368
  @pulumi.getter(name="portPrivateSecondaryVlanId")
1253
1369
  def port_private_secondary_vlan_id(self) -> Optional[pulumi.Input[int]]:
1254
1370
  """
1255
- The secondary VLAN ID for this port.
1371
+ Used to define a secondary VLAN
1372
+ ID when using private VLANs.
1256
1373
  """
1257
1374
  return pulumi.get(self, "port_private_secondary_vlan_id")
1258
1375
 
@@ -1264,7 +1381,8 @@ class DistributedVirtualSwitchArgs:
1264
1381
  @pulumi.getter(name="pvlanMappings")
1265
1382
  def pvlan_mappings(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchPvlanMappingArgs']]]]:
1266
1383
  """
1267
- A private VLAN (PVLAN) mapping.
1384
+ Use the `pvlan_mapping` block to declare a
1385
+ private VLAN mapping. The options are:
1268
1386
  """
1269
1387
  return pulumi.get(self, "pvlan_mappings")
1270
1388
 
@@ -1276,7 +1394,10 @@ class DistributedVirtualSwitchArgs:
1276
1394
  @pulumi.getter(name="standbyUplinks")
1277
1395
  def standby_uplinks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
1278
1396
  """
1279
- List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
1397
+ A list of standby uplinks to be used in
1398
+ failover. These uplinks need to match the definitions in the
1399
+ `uplinks` VDS argument. See
1400
+ here for more details.
1280
1401
  """
1281
1402
  return pulumi.get(self, "standby_uplinks")
1282
1403
 
@@ -1289,6 +1410,8 @@ class DistributedVirtualSwitchArgs:
1289
1410
  def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
1290
1411
  """
1291
1412
  The IDs of any tags to attach to this resource.
1413
+
1414
+ > **NOTE:** Tagging support requires vCenter Server 6.0 or higher.
1292
1415
  """
1293
1416
  return pulumi.get(self, "tags")
1294
1417
 
@@ -1300,8 +1423,9 @@ class DistributedVirtualSwitchArgs:
1300
1423
  @pulumi.getter(name="teamingPolicy")
1301
1424
  def teaming_policy(self) -> Optional[pulumi.Input[str]]:
1302
1425
  """
1303
- The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
1304
- failover_explicit, or loadbalance_loadbased.
1426
+ The uplink teaming policy. Can be one of
1427
+ `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
1428
+ `failover_explicit`, or `loadbalance_loadbased`.
1305
1429
  """
1306
1430
  return pulumi.get(self, "teaming_policy")
1307
1431
 
@@ -1313,8 +1437,8 @@ class DistributedVirtualSwitchArgs:
1313
1437
  @pulumi.getter(name="txUplink")
1314
1438
  def tx_uplink(self) -> Optional[pulumi.Input[bool]]:
1315
1439
  """
1316
- If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
1317
- forwarded done by the switch.
1440
+ Forward all traffic transmitted by ports for which
1441
+ this policy applies to its VDS uplinks.
1318
1442
  """
1319
1443
  return pulumi.get(self, "tx_uplink")
1320
1444
 
@@ -1326,8 +1450,11 @@ class DistributedVirtualSwitchArgs:
1326
1450
  @pulumi.getter
1327
1451
  def uplinks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
1328
1452
  """
1329
- A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
1330
- across hosts.
1453
+ A list of strings that uniquely identifies the names
1454
+ of the uplinks on the VDS across hosts. The number of items in this list
1455
+ controls the number of uplinks that exist on the VDS, in addition to the
1456
+ names. See here for an example on how to
1457
+ use this option.
1331
1458
  """
1332
1459
  return pulumi.get(self, "uplinks")
1333
1460
 
@@ -1461,7 +1588,28 @@ class DistributedVirtualSwitchArgs:
1461
1588
  @pulumi.getter(name="vlanRanges")
1462
1589
  def vlan_ranges(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchVlanRangeArgs']]]]:
1463
1590
  """
1464
- The VLAN ID for single VLAN mode. 0 denotes no VLAN.
1591
+ Used to denote VLAN trunking. Use the `min_vlan`
1592
+ and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
1593
+ `vlan_range` definitions are allowed, but they must not overlap. Example
1594
+ below:
1595
+
1596
+ <!--Start PulumiCodeChooser -->
1597
+ ```python
1598
+ import pulumi
1599
+ import pulumi_vsphere as vsphere
1600
+
1601
+ vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
1602
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
1603
+ max_vlan=199,
1604
+ min_vlan=100,
1605
+ ),
1606
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
1607
+ max_vlan=399,
1608
+ min_vlan=300,
1609
+ ),
1610
+ ])
1611
+ ```
1612
+ <!--End PulumiCodeChooser -->
1465
1613
  """
1466
1614
  return pulumi.get(self, "vlan_ranges")
1467
1615
 
@@ -1666,17 +1814,29 @@ class _DistributedVirtualSwitchState:
1666
1814
  vsan_share_level: Optional[pulumi.Input[str]] = None):
1667
1815
  """
1668
1816
  Input properties used for looking up and filtering DistributedVirtualSwitch resources.
1669
- :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
1670
- :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
1671
- that of its own.
1672
- :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
1673
- :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.
1817
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: A list of active uplinks to be used in load
1818
+ balancing. These uplinks need to match the definitions in the
1819
+ `uplinks` VDS argument. See
1820
+ here for more details.
1821
+ :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not a virtual
1822
+ network adapter is allowed to send network traffic with a different MAC
1823
+ address than that of its own.
1824
+ :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
1825
+ Control (MAC) address can be changed.
1826
+ :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
1827
+ flag indicates whether or not all traffic is seen on a given port.
1674
1828
  :param pulumi.Input[int] backupnfc_maximum_mbit: The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
1675
1829
  :param pulumi.Input[int] backupnfc_reservation_mbit: The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
1676
1830
  :param pulumi.Input[int] backupnfc_share_count: The amount of shares to allocate to the backupNfc traffic class for a custom share level.
1677
1831
  :param pulumi.Input[str] backupnfc_share_level: The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
1678
- :param pulumi.Input[bool] block_all_ports: Indicates whether to block all ports by default.
1679
- :param pulumi.Input[bool] check_beacon: Enable beacon probing on the ports this policy applies to.
1832
+ :param pulumi.Input[bool] block_all_ports: Shuts down all ports in the port groups that
1833
+ this policy applies to, effectively blocking all network access to connected
1834
+ virtual devices.
1835
+ :param pulumi.Input[bool] check_beacon: Enables beacon probing as an additional measure
1836
+ to detect NIC failure.
1837
+
1838
+ > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
1839
+ probing.
1680
1840
  :param pulumi.Input[str] config_version: The current version of the VDS configuration, incremented
1681
1841
  by subsequent updates to the VDS.
1682
1842
  :param pulumi.Input[str] contact_detail: The detailed contact information for the person
@@ -1691,12 +1851,18 @@ class _DistributedVirtualSwitchState:
1691
1851
  :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VDS will be
1692
1852
  created. Forces a new resource if changed.
1693
1853
  :param pulumi.Input[str] description: A detailed description for the VDS.
1694
- :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 on the ports this policy applies to.
1695
- :param pulumi.Input[int] egress_shaping_average_bandwidth: The average egress bandwidth in bits per second if egress shaping is enabled on the port.
1696
- :param pulumi.Input[int] egress_shaping_burst_size: The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
1697
- :param pulumi.Input[bool] egress_shaping_enabled: True if the traffic shaper is enabled for egress traffic on the port.
1698
- :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
1699
- :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
1854
+ :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 for the ports
1855
+ for which this policy applies to.
1856
+ :param pulumi.Input[int] egress_shaping_average_bandwidth: The average bandwidth in bits
1857
+ per second if egress traffic shaping is enabled on the port.
1858
+ :param pulumi.Input[int] egress_shaping_burst_size: The maximum burst size allowed in
1859
+ bytes if egress traffic shaping is enabled on the port.
1860
+ :param pulumi.Input[bool] egress_shaping_enabled: `true` if the traffic shaper is enabled
1861
+ on the port for egress traffic.
1862
+ :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak bandwidth during bursts
1863
+ in bits per second if egress traffic shaping is enabled on the port.
1864
+ :param pulumi.Input[bool] failback: If `true`, the teaming policy will re-activate failed
1865
+ uplinks higher in precedence when they come back up.
1700
1866
  :param pulumi.Input[int] faulttolerance_maximum_mbit: The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
1701
1867
  :param pulumi.Input[int] faulttolerance_reservation_mbit: The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
1702
1868
  :param pulumi.Input[int] faulttolerance_share_count: The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
@@ -1707,12 +1873,18 @@ class _DistributedVirtualSwitchState:
1707
1873
  :param pulumi.Input[int] hbr_reservation_mbit: The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
1708
1874
  :param pulumi.Input[int] hbr_share_count: The amount of shares to allocate to the hbr traffic class for a custom share level.
1709
1875
  :param pulumi.Input[str] hbr_share_level: The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
1710
- :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchHostArgs']]] hosts: A host member specification.
1711
- :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
1712
- :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
1713
- :param pulumi.Input[int] ingress_shaping_burst_size: The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
1714
- :param pulumi.Input[bool] ingress_shaping_enabled: True if the traffic shaper is enabled for ingress traffic on the port.
1715
- :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
1876
+ :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchHostArgs']]] hosts: Use the `host` block to declare a host specification. The
1877
+ options are:
1878
+ :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN
1879
+ mappings not managed by this resource. Defaults to false.
1880
+ :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average bandwidth in
1881
+ bits per second if ingress traffic shaping is enabled on the port.
1882
+ :param pulumi.Input[int] ingress_shaping_burst_size: The maximum burst size allowed in
1883
+ bytes if ingress traffic shaping is enabled on the port.
1884
+ :param pulumi.Input[bool] ingress_shaping_enabled: `true` if the traffic shaper is
1885
+ enabled on the port for ingress traffic.
1886
+ :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak bandwidth during
1887
+ bursts in bits per second if ingress traffic shaping is enabled on the port.
1716
1888
  :param pulumi.Input[str] ipv4_address: An IPv4 address to identify the switch. This is
1717
1889
  mostly useful when used with the Netflow arguments.
1718
1890
  :param pulumi.Input[int] iscsi_maximum_mbit: The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
@@ -1722,8 +1894,9 @@ class _DistributedVirtualSwitchState:
1722
1894
  :param pulumi.Input[str] lacp_api_version: The Link Aggregation Control Protocol group
1723
1895
  version to use with the VDS. Possible values are `singleLag` and
1724
1896
  `multipleLag`.
1725
- :param pulumi.Input[bool] lacp_enabled: Whether or not to enable LACP on all uplink ports.
1726
- :param pulumi.Input[str] lacp_mode: The uplink LACP mode to use. Can be one of active or passive.
1897
+ :param pulumi.Input[bool] lacp_enabled: Enables LACP for the ports that this policy
1898
+ applies to.
1899
+ :param pulumi.Input[str] lacp_mode: The LACP mode. Can be one of `active` or `passive`.
1727
1900
  :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
1728
1901
  for link discovery traffic.
1729
1902
  :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid
@@ -1736,32 +1909,60 @@ class _DistributedVirtualSwitchState:
1736
1909
  :param pulumi.Input[str] multicast_filtering_mode: The multicast filtering mode to use
1737
1910
  with the VDS. Can be one of `legacyFiltering` or `snooping`.
1738
1911
  :param pulumi.Input[str] name: The name of the VDS.
1739
- :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which active flows are forced to be exported to the collector.
1740
- :param pulumi.Input[str] netflow_collector_ip_address: IP address for the netflow collector, using IPv4 or IPv6.
1741
- :param pulumi.Input[int] netflow_collector_port: The port for the netflow collector.
1742
- :param pulumi.Input[bool] netflow_enabled: Indicates whether to enable netflow on all ports.
1743
- :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which idle flows are forced to be exported to the collector.
1744
- :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to traffic that has both source and destination served by the same host.
1745
- :param pulumi.Input[int] netflow_observation_domain_id: The observation Domain ID for the netflow collector.
1746
- :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
1747
- packets are analyzed.
1748
- :param pulumi.Input[bool] network_resource_control_enabled: Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
1749
- :param pulumi.Input[str] network_resource_control_version: The network I/O control version to use. Can be one of version2 or version3.
1912
+ :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which
1913
+ active flows are forced to be exported to the collector. Allowed range is
1914
+ `60` to `3600`. Default: `60`.
1915
+ :param pulumi.Input[str] netflow_collector_ip_address: IP address for the Netflow
1916
+ collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
1917
+ Must be set before Netflow can be enabled.
1918
+ :param pulumi.Input[int] netflow_collector_port: Port for the Netflow collector. This
1919
+ must be set before Netflow can be enabled.
1920
+ :param pulumi.Input[bool] netflow_enabled: Enables Netflow on all ports that this policy
1921
+ applies to.
1922
+ :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which
1923
+ idle flows are forced to be exported to the collector. Allowed range is `10`
1924
+ to `600`. Default: `15`.
1925
+ :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to
1926
+ traffic that has both source and destination served by the same host.
1927
+ Default: `false`.
1928
+ :param pulumi.Input[int] netflow_observation_domain_id: The observation domain ID for
1929
+ the Netflow collector.
1930
+ :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to
1931
+ the number of packets analyzed. The default is `0`, which indicates that the
1932
+ VDS should analyze all packets. The maximum value is `1000`, which
1933
+ indicates an analysis rate of 0.001%!
1934
+ (MISSING)
1935
+ :param pulumi.Input[bool] network_resource_control_enabled: Set to `true` to enable
1936
+ network I/O control. Default: `false`.
1937
+ :param pulumi.Input[str] network_resource_control_version: The version of network I/O
1938
+ control to use. Can be one of `version2` or `version3`. Default: `version2`.
1750
1939
  :param pulumi.Input[int] nfs_maximum_mbit: The maximum allowed usage for the nfs traffic class, in Mbits/sec.
1751
1940
  :param pulumi.Input[int] nfs_reservation_mbit: The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
1752
1941
  :param pulumi.Input[int] nfs_share_count: The amount of shares to allocate to the nfs traffic class for a custom share level.
1753
1942
  :param pulumi.Input[str] nfs_share_level: The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
1754
- :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
1755
- :param pulumi.Input[int] port_private_secondary_vlan_id: The secondary VLAN ID for this port.
1756
- :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchPvlanMappingArgs']]] pvlan_mappings: A private VLAN (PVLAN) mapping.
1757
- :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
1943
+ :param pulumi.Input[bool] notify_switches: If `true`, the teaming policy will notify the
1944
+ broadcast network of an uplink failover, triggering cache updates.
1945
+ :param pulumi.Input[int] port_private_secondary_vlan_id: Used to define a secondary VLAN
1946
+ ID when using private VLANs.
1947
+ :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchPvlanMappingArgs']]] pvlan_mappings: Use the `pvlan_mapping` block to declare a
1948
+ private VLAN mapping. The options are:
1949
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: A list of standby uplinks to be used in
1950
+ failover. These uplinks need to match the definitions in the
1951
+ `uplinks` VDS argument. See
1952
+ here for more details.
1758
1953
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
1759
- :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
1760
- failover_explicit, or loadbalance_loadbased.
1761
- :param pulumi.Input[bool] tx_uplink: If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
1762
- forwarded done by the switch.
1763
- :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
1764
- across hosts.
1954
+
1955
+ > **NOTE:** Tagging support requires vCenter Server 6.0 or higher.
1956
+ :param pulumi.Input[str] teaming_policy: The uplink teaming policy. Can be one of
1957
+ `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
1958
+ `failover_explicit`, or `loadbalance_loadbased`.
1959
+ :param pulumi.Input[bool] tx_uplink: Forward all traffic transmitted by ports for which
1960
+ this policy applies to its VDS uplinks.
1961
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of strings that uniquely identifies the names
1962
+ of the uplinks on the VDS across hosts. The number of items in this list
1963
+ controls the number of uplinks that exist on the VDS, in addition to the
1964
+ names. See here for an example on how to
1965
+ use this option.
1765
1966
  :param pulumi.Input[int] vdp_maximum_mbit: The maximum allowed usage for the vdp traffic class, in Mbits/sec.
1766
1967
  :param pulumi.Input[int] vdp_reservation_mbit: The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
1767
1968
  :param pulumi.Input[int] vdp_share_count: The amount of shares to allocate to the vdp traffic class for a custom share level.
@@ -1774,7 +1975,28 @@ class _DistributedVirtualSwitchState:
1774
1975
  :param pulumi.Input[int] virtualmachine_share_count: The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
1775
1976
  :param pulumi.Input[str] virtualmachine_share_level: The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
1776
1977
  :param pulumi.Input[int] vlan_id: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
1777
- :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchVlanRangeArgs']]] vlan_ranges: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
1978
+ :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchVlanRangeArgs']]] vlan_ranges: Used to denote VLAN trunking. Use the `min_vlan`
1979
+ and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
1980
+ `vlan_range` definitions are allowed, but they must not overlap. Example
1981
+ below:
1982
+
1983
+ <!--Start PulumiCodeChooser -->
1984
+ ```python
1985
+ import pulumi
1986
+ import pulumi_vsphere as vsphere
1987
+
1988
+ vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
1989
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
1990
+ max_vlan=199,
1991
+ min_vlan=100,
1992
+ ),
1993
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
1994
+ max_vlan=399,
1995
+ min_vlan=300,
1996
+ ),
1997
+ ])
1998
+ ```
1999
+ <!--End PulumiCodeChooser -->
1778
2000
  :param pulumi.Input[int] vmotion_maximum_mbit: The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
1779
2001
  :param pulumi.Input[int] vmotion_reservation_mbit: The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
1780
2002
  :param pulumi.Input[int] vmotion_share_count: The amount of shares to allocate to the vmotion traffic class for a custom share level.
@@ -1979,7 +2201,10 @@ class _DistributedVirtualSwitchState:
1979
2201
  @pulumi.getter(name="activeUplinks")
1980
2202
  def active_uplinks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
1981
2203
  """
1982
- List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
2204
+ A list of active uplinks to be used in load
2205
+ balancing. These uplinks need to match the definitions in the
2206
+ `uplinks` VDS argument. See
2207
+ here for more details.
1983
2208
  """
1984
2209
  return pulumi.get(self, "active_uplinks")
1985
2210
 
@@ -1991,8 +2216,9 @@ class _DistributedVirtualSwitchState:
1991
2216
  @pulumi.getter(name="allowForgedTransmits")
1992
2217
  def allow_forged_transmits(self) -> Optional[pulumi.Input[bool]]:
1993
2218
  """
1994
- Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
1995
- that of its own.
2219
+ Controls whether or not a virtual
2220
+ network adapter is allowed to send network traffic with a different MAC
2221
+ address than that of its own.
1996
2222
  """
1997
2223
  return pulumi.get(self, "allow_forged_transmits")
1998
2224
 
@@ -2004,7 +2230,8 @@ class _DistributedVirtualSwitchState:
2004
2230
  @pulumi.getter(name="allowMacChanges")
2005
2231
  def allow_mac_changes(self) -> Optional[pulumi.Input[bool]]:
2006
2232
  """
2007
- Controls whether or not the Media Access Control (MAC) address can be changed.
2233
+ Controls whether or not the Media Access
2234
+ Control (MAC) address can be changed.
2008
2235
  """
2009
2236
  return pulumi.get(self, "allow_mac_changes")
2010
2237
 
@@ -2016,7 +2243,8 @@ class _DistributedVirtualSwitchState:
2016
2243
  @pulumi.getter(name="allowPromiscuous")
2017
2244
  def allow_promiscuous(self) -> Optional[pulumi.Input[bool]]:
2018
2245
  """
2019
- Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
2246
+ Enable promiscuous mode on the network. This
2247
+ flag indicates whether or not all traffic is seen on a given port.
2020
2248
  """
2021
2249
  return pulumi.get(self, "allow_promiscuous")
2022
2250
 
@@ -2076,7 +2304,9 @@ class _DistributedVirtualSwitchState:
2076
2304
  @pulumi.getter(name="blockAllPorts")
2077
2305
  def block_all_ports(self) -> Optional[pulumi.Input[bool]]:
2078
2306
  """
2079
- Indicates whether to block all ports by default.
2307
+ Shuts down all ports in the port groups that
2308
+ this policy applies to, effectively blocking all network access to connected
2309
+ virtual devices.
2080
2310
  """
2081
2311
  return pulumi.get(self, "block_all_ports")
2082
2312
 
@@ -2088,7 +2318,11 @@ class _DistributedVirtualSwitchState:
2088
2318
  @pulumi.getter(name="checkBeacon")
2089
2319
  def check_beacon(self) -> Optional[pulumi.Input[bool]]:
2090
2320
  """
2091
- Enable beacon probing on the ports this policy applies to.
2321
+ Enables beacon probing as an additional measure
2322
+ to detect NIC failure.
2323
+
2324
+ > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
2325
+ probing.
2092
2326
  """
2093
2327
  return pulumi.get(self, "check_beacon")
2094
2328
 
@@ -2180,7 +2414,8 @@ class _DistributedVirtualSwitchState:
2180
2414
  @pulumi.getter(name="directpathGen2Allowed")
2181
2415
  def directpath_gen2_allowed(self) -> Optional[pulumi.Input[bool]]:
2182
2416
  """
2183
- Allow VMDirectPath Gen2 on the ports this policy applies to.
2417
+ Allow VMDirectPath Gen2 for the ports
2418
+ for which this policy applies to.
2184
2419
  """
2185
2420
  return pulumi.get(self, "directpath_gen2_allowed")
2186
2421
 
@@ -2192,7 +2427,8 @@ class _DistributedVirtualSwitchState:
2192
2427
  @pulumi.getter(name="egressShapingAverageBandwidth")
2193
2428
  def egress_shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
2194
2429
  """
2195
- The average egress bandwidth in bits per second if egress shaping is enabled on the port.
2430
+ The average bandwidth in bits
2431
+ per second if egress traffic shaping is enabled on the port.
2196
2432
  """
2197
2433
  return pulumi.get(self, "egress_shaping_average_bandwidth")
2198
2434
 
@@ -2204,7 +2440,8 @@ class _DistributedVirtualSwitchState:
2204
2440
  @pulumi.getter(name="egressShapingBurstSize")
2205
2441
  def egress_shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
2206
2442
  """
2207
- The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
2443
+ The maximum burst size allowed in
2444
+ bytes if egress traffic shaping is enabled on the port.
2208
2445
  """
2209
2446
  return pulumi.get(self, "egress_shaping_burst_size")
2210
2447
 
@@ -2216,7 +2453,8 @@ class _DistributedVirtualSwitchState:
2216
2453
  @pulumi.getter(name="egressShapingEnabled")
2217
2454
  def egress_shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
2218
2455
  """
2219
- True if the traffic shaper is enabled for egress traffic on the port.
2456
+ `true` if the traffic shaper is enabled
2457
+ on the port for egress traffic.
2220
2458
  """
2221
2459
  return pulumi.get(self, "egress_shaping_enabled")
2222
2460
 
@@ -2228,7 +2466,8 @@ class _DistributedVirtualSwitchState:
2228
2466
  @pulumi.getter(name="egressShapingPeakBandwidth")
2229
2467
  def egress_shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
2230
2468
  """
2231
- The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
2469
+ The peak bandwidth during bursts
2470
+ in bits per second if egress traffic shaping is enabled on the port.
2232
2471
  """
2233
2472
  return pulumi.get(self, "egress_shaping_peak_bandwidth")
2234
2473
 
@@ -2240,7 +2479,8 @@ class _DistributedVirtualSwitchState:
2240
2479
  @pulumi.getter
2241
2480
  def failback(self) -> Optional[pulumi.Input[bool]]:
2242
2481
  """
2243
- If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
2482
+ If `true`, the teaming policy will re-activate failed
2483
+ uplinks higher in precedence when they come back up.
2244
2484
  """
2245
2485
  return pulumi.get(self, "failback")
2246
2486
 
@@ -2361,7 +2601,8 @@ class _DistributedVirtualSwitchState:
2361
2601
  @pulumi.getter
2362
2602
  def hosts(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchHostArgs']]]]:
2363
2603
  """
2364
- A host member specification.
2604
+ Use the `host` block to declare a host specification. The
2605
+ options are:
2365
2606
  """
2366
2607
  return pulumi.get(self, "hosts")
2367
2608
 
@@ -2373,7 +2614,8 @@ class _DistributedVirtualSwitchState:
2373
2614
  @pulumi.getter(name="ignoreOtherPvlanMappings")
2374
2615
  def ignore_other_pvlan_mappings(self) -> Optional[pulumi.Input[bool]]:
2375
2616
  """
2376
- Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
2617
+ Whether to ignore existing PVLAN
2618
+ mappings not managed by this resource. Defaults to false.
2377
2619
  """
2378
2620
  return pulumi.get(self, "ignore_other_pvlan_mappings")
2379
2621
 
@@ -2385,7 +2627,8 @@ class _DistributedVirtualSwitchState:
2385
2627
  @pulumi.getter(name="ingressShapingAverageBandwidth")
2386
2628
  def ingress_shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
2387
2629
  """
2388
- The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
2630
+ The average bandwidth in
2631
+ bits per second if ingress traffic shaping is enabled on the port.
2389
2632
  """
2390
2633
  return pulumi.get(self, "ingress_shaping_average_bandwidth")
2391
2634
 
@@ -2397,7 +2640,8 @@ class _DistributedVirtualSwitchState:
2397
2640
  @pulumi.getter(name="ingressShapingBurstSize")
2398
2641
  def ingress_shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
2399
2642
  """
2400
- The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
2643
+ The maximum burst size allowed in
2644
+ bytes if ingress traffic shaping is enabled on the port.
2401
2645
  """
2402
2646
  return pulumi.get(self, "ingress_shaping_burst_size")
2403
2647
 
@@ -2409,7 +2653,8 @@ class _DistributedVirtualSwitchState:
2409
2653
  @pulumi.getter(name="ingressShapingEnabled")
2410
2654
  def ingress_shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
2411
2655
  """
2412
- True if the traffic shaper is enabled for ingress traffic on the port.
2656
+ `true` if the traffic shaper is
2657
+ enabled on the port for ingress traffic.
2413
2658
  """
2414
2659
  return pulumi.get(self, "ingress_shaping_enabled")
2415
2660
 
@@ -2421,7 +2666,8 @@ class _DistributedVirtualSwitchState:
2421
2666
  @pulumi.getter(name="ingressShapingPeakBandwidth")
2422
2667
  def ingress_shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
2423
2668
  """
2424
- The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
2669
+ The peak bandwidth during
2670
+ bursts in bits per second if ingress traffic shaping is enabled on the port.
2425
2671
  """
2426
2672
  return pulumi.get(self, "ingress_shaping_peak_bandwidth")
2427
2673
 
@@ -2508,7 +2754,8 @@ class _DistributedVirtualSwitchState:
2508
2754
  @pulumi.getter(name="lacpEnabled")
2509
2755
  def lacp_enabled(self) -> Optional[pulumi.Input[bool]]:
2510
2756
  """
2511
- Whether or not to enable LACP on all uplink ports.
2757
+ Enables LACP for the ports that this policy
2758
+ applies to.
2512
2759
  """
2513
2760
  return pulumi.get(self, "lacp_enabled")
2514
2761
 
@@ -2520,7 +2767,7 @@ class _DistributedVirtualSwitchState:
2520
2767
  @pulumi.getter(name="lacpMode")
2521
2768
  def lacp_mode(self) -> Optional[pulumi.Input[str]]:
2522
2769
  """
2523
- The uplink LACP mode to use. Can be one of active or passive.
2770
+ The LACP mode. Can be one of `active` or `passive`.
2524
2771
  """
2525
2772
  return pulumi.get(self, "lacp_mode")
2526
2773
 
@@ -2643,7 +2890,9 @@ class _DistributedVirtualSwitchState:
2643
2890
  @pulumi.getter(name="netflowActiveFlowTimeout")
2644
2891
  def netflow_active_flow_timeout(self) -> Optional[pulumi.Input[int]]:
2645
2892
  """
2646
- The number of seconds after which active flows are forced to be exported to the collector.
2893
+ The number of seconds after which
2894
+ active flows are forced to be exported to the collector. Allowed range is
2895
+ `60` to `3600`. Default: `60`.
2647
2896
  """
2648
2897
  return pulumi.get(self, "netflow_active_flow_timeout")
2649
2898
 
@@ -2655,7 +2904,9 @@ class _DistributedVirtualSwitchState:
2655
2904
  @pulumi.getter(name="netflowCollectorIpAddress")
2656
2905
  def netflow_collector_ip_address(self) -> Optional[pulumi.Input[str]]:
2657
2906
  """
2658
- IP address for the netflow collector, using IPv4 or IPv6.
2907
+ IP address for the Netflow
2908
+ collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
2909
+ Must be set before Netflow can be enabled.
2659
2910
  """
2660
2911
  return pulumi.get(self, "netflow_collector_ip_address")
2661
2912
 
@@ -2667,7 +2918,8 @@ class _DistributedVirtualSwitchState:
2667
2918
  @pulumi.getter(name="netflowCollectorPort")
2668
2919
  def netflow_collector_port(self) -> Optional[pulumi.Input[int]]:
2669
2920
  """
2670
- The port for the netflow collector.
2921
+ Port for the Netflow collector. This
2922
+ must be set before Netflow can be enabled.
2671
2923
  """
2672
2924
  return pulumi.get(self, "netflow_collector_port")
2673
2925
 
@@ -2679,7 +2931,8 @@ class _DistributedVirtualSwitchState:
2679
2931
  @pulumi.getter(name="netflowEnabled")
2680
2932
  def netflow_enabled(self) -> Optional[pulumi.Input[bool]]:
2681
2933
  """
2682
- Indicates whether to enable netflow on all ports.
2934
+ Enables Netflow on all ports that this policy
2935
+ applies to.
2683
2936
  """
2684
2937
  return pulumi.get(self, "netflow_enabled")
2685
2938
 
@@ -2691,7 +2944,9 @@ class _DistributedVirtualSwitchState:
2691
2944
  @pulumi.getter(name="netflowIdleFlowTimeout")
2692
2945
  def netflow_idle_flow_timeout(self) -> Optional[pulumi.Input[int]]:
2693
2946
  """
2694
- The number of seconds after which idle flows are forced to be exported to the collector.
2947
+ The number of seconds after which
2948
+ idle flows are forced to be exported to the collector. Allowed range is `10`
2949
+ to `600`. Default: `15`.
2695
2950
  """
2696
2951
  return pulumi.get(self, "netflow_idle_flow_timeout")
2697
2952
 
@@ -2703,7 +2958,9 @@ class _DistributedVirtualSwitchState:
2703
2958
  @pulumi.getter(name="netflowInternalFlowsOnly")
2704
2959
  def netflow_internal_flows_only(self) -> Optional[pulumi.Input[bool]]:
2705
2960
  """
2706
- Whether to limit analysis to traffic that has both source and destination served by the same host.
2961
+ Whether to limit analysis to
2962
+ traffic that has both source and destination served by the same host.
2963
+ Default: `false`.
2707
2964
  """
2708
2965
  return pulumi.get(self, "netflow_internal_flows_only")
2709
2966
 
@@ -2715,7 +2972,8 @@ class _DistributedVirtualSwitchState:
2715
2972
  @pulumi.getter(name="netflowObservationDomainId")
2716
2973
  def netflow_observation_domain_id(self) -> Optional[pulumi.Input[int]]:
2717
2974
  """
2718
- The observation Domain ID for the netflow collector.
2975
+ The observation domain ID for
2976
+ the Netflow collector.
2719
2977
  """
2720
2978
  return pulumi.get(self, "netflow_observation_domain_id")
2721
2979
 
@@ -2727,8 +2985,11 @@ class _DistributedVirtualSwitchState:
2727
2985
  @pulumi.getter(name="netflowSamplingRate")
2728
2986
  def netflow_sampling_rate(self) -> Optional[pulumi.Input[int]]:
2729
2987
  """
2730
- The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
2731
- packets are analyzed.
2988
+ The ratio of total number of packets to
2989
+ the number of packets analyzed. The default is `0`, which indicates that the
2990
+ VDS should analyze all packets. The maximum value is `1000`, which
2991
+ indicates an analysis rate of 0.001%!
2992
+ (MISSING)
2732
2993
  """
2733
2994
  return pulumi.get(self, "netflow_sampling_rate")
2734
2995
 
@@ -2740,7 +3001,8 @@ class _DistributedVirtualSwitchState:
2740
3001
  @pulumi.getter(name="networkResourceControlEnabled")
2741
3002
  def network_resource_control_enabled(self) -> Optional[pulumi.Input[bool]]:
2742
3003
  """
2743
- Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
3004
+ Set to `true` to enable
3005
+ network I/O control. Default: `false`.
2744
3006
  """
2745
3007
  return pulumi.get(self, "network_resource_control_enabled")
2746
3008
 
@@ -2752,7 +3014,8 @@ class _DistributedVirtualSwitchState:
2752
3014
  @pulumi.getter(name="networkResourceControlVersion")
2753
3015
  def network_resource_control_version(self) -> Optional[pulumi.Input[str]]:
2754
3016
  """
2755
- The network I/O control version to use. Can be one of version2 or version3.
3017
+ The version of network I/O
3018
+ control to use. Can be one of `version2` or `version3`. Default: `version2`.
2756
3019
  """
2757
3020
  return pulumi.get(self, "network_resource_control_version")
2758
3021
 
@@ -2812,7 +3075,8 @@ class _DistributedVirtualSwitchState:
2812
3075
  @pulumi.getter(name="notifySwitches")
2813
3076
  def notify_switches(self) -> Optional[pulumi.Input[bool]]:
2814
3077
  """
2815
- If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
3078
+ If `true`, the teaming policy will notify the
3079
+ broadcast network of an uplink failover, triggering cache updates.
2816
3080
  """
2817
3081
  return pulumi.get(self, "notify_switches")
2818
3082
 
@@ -2824,7 +3088,8 @@ class _DistributedVirtualSwitchState:
2824
3088
  @pulumi.getter(name="portPrivateSecondaryVlanId")
2825
3089
  def port_private_secondary_vlan_id(self) -> Optional[pulumi.Input[int]]:
2826
3090
  """
2827
- The secondary VLAN ID for this port.
3091
+ Used to define a secondary VLAN
3092
+ ID when using private VLANs.
2828
3093
  """
2829
3094
  return pulumi.get(self, "port_private_secondary_vlan_id")
2830
3095
 
@@ -2836,7 +3101,8 @@ class _DistributedVirtualSwitchState:
2836
3101
  @pulumi.getter(name="pvlanMappings")
2837
3102
  def pvlan_mappings(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchPvlanMappingArgs']]]]:
2838
3103
  """
2839
- A private VLAN (PVLAN) mapping.
3104
+ Use the `pvlan_mapping` block to declare a
3105
+ private VLAN mapping. The options are:
2840
3106
  """
2841
3107
  return pulumi.get(self, "pvlan_mappings")
2842
3108
 
@@ -2848,7 +3114,10 @@ class _DistributedVirtualSwitchState:
2848
3114
  @pulumi.getter(name="standbyUplinks")
2849
3115
  def standby_uplinks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
2850
3116
  """
2851
- List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
3117
+ A list of standby uplinks to be used in
3118
+ failover. These uplinks need to match the definitions in the
3119
+ `uplinks` VDS argument. See
3120
+ here for more details.
2852
3121
  """
2853
3122
  return pulumi.get(self, "standby_uplinks")
2854
3123
 
@@ -2861,6 +3130,8 @@ class _DistributedVirtualSwitchState:
2861
3130
  def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
2862
3131
  """
2863
3132
  The IDs of any tags to attach to this resource.
3133
+
3134
+ > **NOTE:** Tagging support requires vCenter Server 6.0 or higher.
2864
3135
  """
2865
3136
  return pulumi.get(self, "tags")
2866
3137
 
@@ -2872,8 +3143,9 @@ class _DistributedVirtualSwitchState:
2872
3143
  @pulumi.getter(name="teamingPolicy")
2873
3144
  def teaming_policy(self) -> Optional[pulumi.Input[str]]:
2874
3145
  """
2875
- The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
2876
- failover_explicit, or loadbalance_loadbased.
3146
+ The uplink teaming policy. Can be one of
3147
+ `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
3148
+ `failover_explicit`, or `loadbalance_loadbased`.
2877
3149
  """
2878
3150
  return pulumi.get(self, "teaming_policy")
2879
3151
 
@@ -2885,8 +3157,8 @@ class _DistributedVirtualSwitchState:
2885
3157
  @pulumi.getter(name="txUplink")
2886
3158
  def tx_uplink(self) -> Optional[pulumi.Input[bool]]:
2887
3159
  """
2888
- If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
2889
- forwarded done by the switch.
3160
+ Forward all traffic transmitted by ports for which
3161
+ this policy applies to its VDS uplinks.
2890
3162
  """
2891
3163
  return pulumi.get(self, "tx_uplink")
2892
3164
 
@@ -2898,8 +3170,11 @@ class _DistributedVirtualSwitchState:
2898
3170
  @pulumi.getter
2899
3171
  def uplinks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
2900
3172
  """
2901
- A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
2902
- across hosts.
3173
+ A list of strings that uniquely identifies the names
3174
+ of the uplinks on the VDS across hosts. The number of items in this list
3175
+ controls the number of uplinks that exist on the VDS, in addition to the
3176
+ names. See here for an example on how to
3177
+ use this option.
2903
3178
  """
2904
3179
  return pulumi.get(self, "uplinks")
2905
3180
 
@@ -3033,7 +3308,28 @@ class _DistributedVirtualSwitchState:
3033
3308
  @pulumi.getter(name="vlanRanges")
3034
3309
  def vlan_ranges(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchVlanRangeArgs']]]]:
3035
3310
  """
3036
- The VLAN ID for single VLAN mode. 0 denotes no VLAN.
3311
+ Used to denote VLAN trunking. Use the `min_vlan`
3312
+ and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
3313
+ `vlan_range` definitions are allowed, but they must not overlap. Example
3314
+ below:
3315
+
3316
+ <!--Start PulumiCodeChooser -->
3317
+ ```python
3318
+ import pulumi
3319
+ import pulumi_vsphere as vsphere
3320
+
3321
+ vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
3322
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
3323
+ max_vlan=199,
3324
+ min_vlan=100,
3325
+ ),
3326
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
3327
+ max_vlan=399,
3328
+ min_vlan=300,
3329
+ ),
3330
+ ])
3331
+ ```
3332
+ <!--End PulumiCodeChooser -->
3037
3333
  """
3038
3334
  return pulumi.get(self, "vlan_ranges")
3039
3335
 
@@ -3173,7 +3469,7 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3173
3469
  hbr_reservation_mbit: Optional[pulumi.Input[int]] = None,
3174
3470
  hbr_share_count: Optional[pulumi.Input[int]] = None,
3175
3471
  hbr_share_level: Optional[pulumi.Input[str]] = None,
3176
- hosts: Optional[pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchHostArgs', 'DistributedVirtualSwitchHostArgsDict']]]]] = None,
3472
+ hosts: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchHostArgs']]]]] = None,
3177
3473
  ignore_other_pvlan_mappings: Optional[pulumi.Input[bool]] = None,
3178
3474
  ingress_shaping_average_bandwidth: Optional[pulumi.Input[int]] = None,
3179
3475
  ingress_shaping_burst_size: Optional[pulumi.Input[int]] = None,
@@ -3212,7 +3508,7 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3212
3508
  nfs_share_level: Optional[pulumi.Input[str]] = None,
3213
3509
  notify_switches: Optional[pulumi.Input[bool]] = None,
3214
3510
  port_private_secondary_vlan_id: Optional[pulumi.Input[int]] = None,
3215
- pvlan_mappings: Optional[pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchPvlanMappingArgs', 'DistributedVirtualSwitchPvlanMappingArgsDict']]]]] = None,
3511
+ pvlan_mappings: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchPvlanMappingArgs']]]]] = None,
3216
3512
  standby_uplinks: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
3217
3513
  tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
3218
3514
  teaming_policy: Optional[pulumi.Input[str]] = None,
@@ -3228,7 +3524,7 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3228
3524
  virtualmachine_share_count: Optional[pulumi.Input[int]] = None,
3229
3525
  virtualmachine_share_level: Optional[pulumi.Input[str]] = None,
3230
3526
  vlan_id: Optional[pulumi.Input[int]] = None,
3231
- vlan_ranges: Optional[pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchVlanRangeArgs', 'DistributedVirtualSwitchVlanRangeArgsDict']]]]] = None,
3527
+ vlan_ranges: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchVlanRangeArgs']]]]] = None,
3232
3528
  vmotion_maximum_mbit: Optional[pulumi.Input[int]] = None,
3233
3529
  vmotion_reservation_mbit: Optional[pulumi.Input[int]] = None,
3234
3530
  vmotion_share_count: Optional[pulumi.Input[int]] = None,
@@ -3242,17 +3538,29 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3242
3538
  Create a DistributedVirtualSwitch resource with the given unique name, props, and options.
3243
3539
  :param str resource_name: The name of the resource.
3244
3540
  :param pulumi.ResourceOptions opts: Options for the resource.
3245
- :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
3246
- :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
3247
- that of its own.
3248
- :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
3249
- :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.
3541
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: A list of active uplinks to be used in load
3542
+ balancing. These uplinks need to match the definitions in the
3543
+ `uplinks` VDS argument. See
3544
+ here for more details.
3545
+ :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not a virtual
3546
+ network adapter is allowed to send network traffic with a different MAC
3547
+ address than that of its own.
3548
+ :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
3549
+ Control (MAC) address can be changed.
3550
+ :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
3551
+ flag indicates whether or not all traffic is seen on a given port.
3250
3552
  :param pulumi.Input[int] backupnfc_maximum_mbit: The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
3251
3553
  :param pulumi.Input[int] backupnfc_reservation_mbit: The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
3252
3554
  :param pulumi.Input[int] backupnfc_share_count: The amount of shares to allocate to the backupNfc traffic class for a custom share level.
3253
3555
  :param pulumi.Input[str] backupnfc_share_level: The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
3254
- :param pulumi.Input[bool] block_all_ports: Indicates whether to block all ports by default.
3255
- :param pulumi.Input[bool] check_beacon: Enable beacon probing on the ports this policy applies to.
3556
+ :param pulumi.Input[bool] block_all_ports: Shuts down all ports in the port groups that
3557
+ this policy applies to, effectively blocking all network access to connected
3558
+ virtual devices.
3559
+ :param pulumi.Input[bool] check_beacon: Enables beacon probing as an additional measure
3560
+ to detect NIC failure.
3561
+
3562
+ > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
3563
+ probing.
3256
3564
  :param pulumi.Input[str] contact_detail: The detailed contact information for the person
3257
3565
  who is responsible for the VDS.
3258
3566
  :param pulumi.Input[str] contact_name: The name of the person who is responsible for the
@@ -3265,12 +3573,18 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3265
3573
  :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VDS will be
3266
3574
  created. Forces a new resource if changed.
3267
3575
  :param pulumi.Input[str] description: A detailed description for the VDS.
3268
- :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 on the ports this policy applies to.
3269
- :param pulumi.Input[int] egress_shaping_average_bandwidth: The average egress bandwidth in bits per second if egress shaping is enabled on the port.
3270
- :param pulumi.Input[int] egress_shaping_burst_size: The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
3271
- :param pulumi.Input[bool] egress_shaping_enabled: True if the traffic shaper is enabled for egress traffic on the port.
3272
- :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
3273
- :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
3576
+ :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 for the ports
3577
+ for which this policy applies to.
3578
+ :param pulumi.Input[int] egress_shaping_average_bandwidth: The average bandwidth in bits
3579
+ per second if egress traffic shaping is enabled on the port.
3580
+ :param pulumi.Input[int] egress_shaping_burst_size: The maximum burst size allowed in
3581
+ bytes if egress traffic shaping is enabled on the port.
3582
+ :param pulumi.Input[bool] egress_shaping_enabled: `true` if the traffic shaper is enabled
3583
+ on the port for egress traffic.
3584
+ :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak bandwidth during bursts
3585
+ in bits per second if egress traffic shaping is enabled on the port.
3586
+ :param pulumi.Input[bool] failback: If `true`, the teaming policy will re-activate failed
3587
+ uplinks higher in precedence when they come back up.
3274
3588
  :param pulumi.Input[int] faulttolerance_maximum_mbit: The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
3275
3589
  :param pulumi.Input[int] faulttolerance_reservation_mbit: The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
3276
3590
  :param pulumi.Input[int] faulttolerance_share_count: The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
@@ -3281,12 +3595,18 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3281
3595
  :param pulumi.Input[int] hbr_reservation_mbit: The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
3282
3596
  :param pulumi.Input[int] hbr_share_count: The amount of shares to allocate to the hbr traffic class for a custom share level.
3283
3597
  :param pulumi.Input[str] hbr_share_level: The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
3284
- :param pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchHostArgs', 'DistributedVirtualSwitchHostArgsDict']]]] hosts: A host member specification.
3285
- :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
3286
- :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
3287
- :param pulumi.Input[int] ingress_shaping_burst_size: The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
3288
- :param pulumi.Input[bool] ingress_shaping_enabled: True if the traffic shaper is enabled for ingress traffic on the port.
3289
- :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
3598
+ :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchHostArgs']]]] hosts: Use the `host` block to declare a host specification. The
3599
+ options are:
3600
+ :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN
3601
+ mappings not managed by this resource. Defaults to false.
3602
+ :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average bandwidth in
3603
+ bits per second if ingress traffic shaping is enabled on the port.
3604
+ :param pulumi.Input[int] ingress_shaping_burst_size: The maximum burst size allowed in
3605
+ bytes if ingress traffic shaping is enabled on the port.
3606
+ :param pulumi.Input[bool] ingress_shaping_enabled: `true` if the traffic shaper is
3607
+ enabled on the port for ingress traffic.
3608
+ :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak bandwidth during
3609
+ bursts in bits per second if ingress traffic shaping is enabled on the port.
3290
3610
  :param pulumi.Input[str] ipv4_address: An IPv4 address to identify the switch. This is
3291
3611
  mostly useful when used with the Netflow arguments.
3292
3612
  :param pulumi.Input[int] iscsi_maximum_mbit: The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
@@ -3296,8 +3616,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3296
3616
  :param pulumi.Input[str] lacp_api_version: The Link Aggregation Control Protocol group
3297
3617
  version to use with the VDS. Possible values are `singleLag` and
3298
3618
  `multipleLag`.
3299
- :param pulumi.Input[bool] lacp_enabled: Whether or not to enable LACP on all uplink ports.
3300
- :param pulumi.Input[str] lacp_mode: The uplink LACP mode to use. Can be one of active or passive.
3619
+ :param pulumi.Input[bool] lacp_enabled: Enables LACP for the ports that this policy
3620
+ applies to.
3621
+ :param pulumi.Input[str] lacp_mode: The LACP mode. Can be one of `active` or `passive`.
3301
3622
  :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
3302
3623
  for link discovery traffic.
3303
3624
  :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid
@@ -3310,32 +3631,60 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3310
3631
  :param pulumi.Input[str] multicast_filtering_mode: The multicast filtering mode to use
3311
3632
  with the VDS. Can be one of `legacyFiltering` or `snooping`.
3312
3633
  :param pulumi.Input[str] name: The name of the VDS.
3313
- :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which active flows are forced to be exported to the collector.
3314
- :param pulumi.Input[str] netflow_collector_ip_address: IP address for the netflow collector, using IPv4 or IPv6.
3315
- :param pulumi.Input[int] netflow_collector_port: The port for the netflow collector.
3316
- :param pulumi.Input[bool] netflow_enabled: Indicates whether to enable netflow on all ports.
3317
- :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which idle flows are forced to be exported to the collector.
3318
- :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to traffic that has both source and destination served by the same host.
3319
- :param pulumi.Input[int] netflow_observation_domain_id: The observation Domain ID for the netflow collector.
3320
- :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
3321
- packets are analyzed.
3322
- :param pulumi.Input[bool] network_resource_control_enabled: Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
3323
- :param pulumi.Input[str] network_resource_control_version: The network I/O control version to use. Can be one of version2 or version3.
3634
+ :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which
3635
+ active flows are forced to be exported to the collector. Allowed range is
3636
+ `60` to `3600`. Default: `60`.
3637
+ :param pulumi.Input[str] netflow_collector_ip_address: IP address for the Netflow
3638
+ collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
3639
+ Must be set before Netflow can be enabled.
3640
+ :param pulumi.Input[int] netflow_collector_port: Port for the Netflow collector. This
3641
+ must be set before Netflow can be enabled.
3642
+ :param pulumi.Input[bool] netflow_enabled: Enables Netflow on all ports that this policy
3643
+ applies to.
3644
+ :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which
3645
+ idle flows are forced to be exported to the collector. Allowed range is `10`
3646
+ to `600`. Default: `15`.
3647
+ :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to
3648
+ traffic that has both source and destination served by the same host.
3649
+ Default: `false`.
3650
+ :param pulumi.Input[int] netflow_observation_domain_id: The observation domain ID for
3651
+ the Netflow collector.
3652
+ :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to
3653
+ the number of packets analyzed. The default is `0`, which indicates that the
3654
+ VDS should analyze all packets. The maximum value is `1000`, which
3655
+ indicates an analysis rate of 0.001%!
3656
+ (MISSING)
3657
+ :param pulumi.Input[bool] network_resource_control_enabled: Set to `true` to enable
3658
+ network I/O control. Default: `false`.
3659
+ :param pulumi.Input[str] network_resource_control_version: The version of network I/O
3660
+ control to use. Can be one of `version2` or `version3`. Default: `version2`.
3324
3661
  :param pulumi.Input[int] nfs_maximum_mbit: The maximum allowed usage for the nfs traffic class, in Mbits/sec.
3325
3662
  :param pulumi.Input[int] nfs_reservation_mbit: The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
3326
3663
  :param pulumi.Input[int] nfs_share_count: The amount of shares to allocate to the nfs traffic class for a custom share level.
3327
3664
  :param pulumi.Input[str] nfs_share_level: The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
3328
- :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
3329
- :param pulumi.Input[int] port_private_secondary_vlan_id: The secondary VLAN ID for this port.
3330
- :param pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchPvlanMappingArgs', 'DistributedVirtualSwitchPvlanMappingArgsDict']]]] pvlan_mappings: A private VLAN (PVLAN) mapping.
3331
- :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
3665
+ :param pulumi.Input[bool] notify_switches: If `true`, the teaming policy will notify the
3666
+ broadcast network of an uplink failover, triggering cache updates.
3667
+ :param pulumi.Input[int] port_private_secondary_vlan_id: Used to define a secondary VLAN
3668
+ ID when using private VLANs.
3669
+ :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchPvlanMappingArgs']]]] pvlan_mappings: Use the `pvlan_mapping` block to declare a
3670
+ private VLAN mapping. The options are:
3671
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: A list of standby uplinks to be used in
3672
+ failover. These uplinks need to match the definitions in the
3673
+ `uplinks` VDS argument. See
3674
+ here for more details.
3332
3675
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
3333
- :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
3334
- failover_explicit, or loadbalance_loadbased.
3335
- :param pulumi.Input[bool] tx_uplink: If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
3336
- forwarded done by the switch.
3337
- :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
3338
- across hosts.
3676
+
3677
+ > **NOTE:** Tagging support requires vCenter Server 6.0 or higher.
3678
+ :param pulumi.Input[str] teaming_policy: The uplink teaming policy. Can be one of
3679
+ `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
3680
+ `failover_explicit`, or `loadbalance_loadbased`.
3681
+ :param pulumi.Input[bool] tx_uplink: Forward all traffic transmitted by ports for which
3682
+ this policy applies to its VDS uplinks.
3683
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of strings that uniquely identifies the names
3684
+ of the uplinks on the VDS across hosts. The number of items in this list
3685
+ controls the number of uplinks that exist on the VDS, in addition to the
3686
+ names. See here for an example on how to
3687
+ use this option.
3339
3688
  :param pulumi.Input[int] vdp_maximum_mbit: The maximum allowed usage for the vdp traffic class, in Mbits/sec.
3340
3689
  :param pulumi.Input[int] vdp_reservation_mbit: The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
3341
3690
  :param pulumi.Input[int] vdp_share_count: The amount of shares to allocate to the vdp traffic class for a custom share level.
@@ -3348,7 +3697,28 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3348
3697
  :param pulumi.Input[int] virtualmachine_share_count: The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
3349
3698
  :param pulumi.Input[str] virtualmachine_share_level: The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
3350
3699
  :param pulumi.Input[int] vlan_id: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
3351
- :param pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchVlanRangeArgs', 'DistributedVirtualSwitchVlanRangeArgsDict']]]] vlan_ranges: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
3700
+ :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchVlanRangeArgs']]]] vlan_ranges: Used to denote VLAN trunking. Use the `min_vlan`
3701
+ and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
3702
+ `vlan_range` definitions are allowed, but they must not overlap. Example
3703
+ below:
3704
+
3705
+ <!--Start PulumiCodeChooser -->
3706
+ ```python
3707
+ import pulumi
3708
+ import pulumi_vsphere as vsphere
3709
+
3710
+ vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
3711
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
3712
+ max_vlan=199,
3713
+ min_vlan=100,
3714
+ ),
3715
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
3716
+ max_vlan=399,
3717
+ min_vlan=300,
3718
+ ),
3719
+ ])
3720
+ ```
3721
+ <!--End PulumiCodeChooser -->
3352
3722
  :param pulumi.Input[int] vmotion_maximum_mbit: The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
3353
3723
  :param pulumi.Input[int] vmotion_reservation_mbit: The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
3354
3724
  :param pulumi.Input[int] vmotion_share_count: The amount of shares to allocate to the vmotion traffic class for a custom share level.
@@ -3411,7 +3781,7 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3411
3781
  hbr_reservation_mbit: Optional[pulumi.Input[int]] = None,
3412
3782
  hbr_share_count: Optional[pulumi.Input[int]] = None,
3413
3783
  hbr_share_level: Optional[pulumi.Input[str]] = None,
3414
- hosts: Optional[pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchHostArgs', 'DistributedVirtualSwitchHostArgsDict']]]]] = None,
3784
+ hosts: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchHostArgs']]]]] = None,
3415
3785
  ignore_other_pvlan_mappings: Optional[pulumi.Input[bool]] = None,
3416
3786
  ingress_shaping_average_bandwidth: Optional[pulumi.Input[int]] = None,
3417
3787
  ingress_shaping_burst_size: Optional[pulumi.Input[int]] = None,
@@ -3450,7 +3820,7 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3450
3820
  nfs_share_level: Optional[pulumi.Input[str]] = None,
3451
3821
  notify_switches: Optional[pulumi.Input[bool]] = None,
3452
3822
  port_private_secondary_vlan_id: Optional[pulumi.Input[int]] = None,
3453
- pvlan_mappings: Optional[pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchPvlanMappingArgs', 'DistributedVirtualSwitchPvlanMappingArgsDict']]]]] = None,
3823
+ pvlan_mappings: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchPvlanMappingArgs']]]]] = None,
3454
3824
  standby_uplinks: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
3455
3825
  tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
3456
3826
  teaming_policy: Optional[pulumi.Input[str]] = None,
@@ -3466,7 +3836,7 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3466
3836
  virtualmachine_share_count: Optional[pulumi.Input[int]] = None,
3467
3837
  virtualmachine_share_level: Optional[pulumi.Input[str]] = None,
3468
3838
  vlan_id: Optional[pulumi.Input[int]] = None,
3469
- vlan_ranges: Optional[pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchVlanRangeArgs', 'DistributedVirtualSwitchVlanRangeArgsDict']]]]] = None,
3839
+ vlan_ranges: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchVlanRangeArgs']]]]] = None,
3470
3840
  vmotion_maximum_mbit: Optional[pulumi.Input[int]] = None,
3471
3841
  vmotion_reservation_mbit: Optional[pulumi.Input[int]] = None,
3472
3842
  vmotion_share_count: Optional[pulumi.Input[int]] = None,
@@ -3622,7 +3992,7 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3622
3992
  hbr_reservation_mbit: Optional[pulumi.Input[int]] = None,
3623
3993
  hbr_share_count: Optional[pulumi.Input[int]] = None,
3624
3994
  hbr_share_level: Optional[pulumi.Input[str]] = None,
3625
- hosts: Optional[pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchHostArgs', 'DistributedVirtualSwitchHostArgsDict']]]]] = None,
3995
+ hosts: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchHostArgs']]]]] = None,
3626
3996
  ignore_other_pvlan_mappings: Optional[pulumi.Input[bool]] = None,
3627
3997
  ingress_shaping_average_bandwidth: Optional[pulumi.Input[int]] = None,
3628
3998
  ingress_shaping_burst_size: Optional[pulumi.Input[int]] = None,
@@ -3661,7 +4031,7 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3661
4031
  nfs_share_level: Optional[pulumi.Input[str]] = None,
3662
4032
  notify_switches: Optional[pulumi.Input[bool]] = None,
3663
4033
  port_private_secondary_vlan_id: Optional[pulumi.Input[int]] = None,
3664
- pvlan_mappings: Optional[pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchPvlanMappingArgs', 'DistributedVirtualSwitchPvlanMappingArgsDict']]]]] = None,
4034
+ pvlan_mappings: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchPvlanMappingArgs']]]]] = None,
3665
4035
  standby_uplinks: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
3666
4036
  tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
3667
4037
  teaming_policy: Optional[pulumi.Input[str]] = None,
@@ -3677,7 +4047,7 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3677
4047
  virtualmachine_share_count: Optional[pulumi.Input[int]] = None,
3678
4048
  virtualmachine_share_level: Optional[pulumi.Input[str]] = None,
3679
4049
  vlan_id: Optional[pulumi.Input[int]] = None,
3680
- vlan_ranges: Optional[pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchVlanRangeArgs', 'DistributedVirtualSwitchVlanRangeArgsDict']]]]] = None,
4050
+ vlan_ranges: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchVlanRangeArgs']]]]] = None,
3681
4051
  vmotion_maximum_mbit: Optional[pulumi.Input[int]] = None,
3682
4052
  vmotion_reservation_mbit: Optional[pulumi.Input[int]] = None,
3683
4053
  vmotion_share_count: Optional[pulumi.Input[int]] = None,
@@ -3693,17 +4063,29 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3693
4063
  :param str resource_name: The unique name of the resulting resource.
3694
4064
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
3695
4065
  :param pulumi.ResourceOptions opts: Options for the resource.
3696
- :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
3697
- :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
3698
- that of its own.
3699
- :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
3700
- :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.
4066
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: A list of active uplinks to be used in load
4067
+ balancing. These uplinks need to match the definitions in the
4068
+ `uplinks` VDS argument. See
4069
+ here for more details.
4070
+ :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not a virtual
4071
+ network adapter is allowed to send network traffic with a different MAC
4072
+ address than that of its own.
4073
+ :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
4074
+ Control (MAC) address can be changed.
4075
+ :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
4076
+ flag indicates whether or not all traffic is seen on a given port.
3701
4077
  :param pulumi.Input[int] backupnfc_maximum_mbit: The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
3702
4078
  :param pulumi.Input[int] backupnfc_reservation_mbit: The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
3703
4079
  :param pulumi.Input[int] backupnfc_share_count: The amount of shares to allocate to the backupNfc traffic class for a custom share level.
3704
4080
  :param pulumi.Input[str] backupnfc_share_level: The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
3705
- :param pulumi.Input[bool] block_all_ports: Indicates whether to block all ports by default.
3706
- :param pulumi.Input[bool] check_beacon: Enable beacon probing on the ports this policy applies to.
4081
+ :param pulumi.Input[bool] block_all_ports: Shuts down all ports in the port groups that
4082
+ this policy applies to, effectively blocking all network access to connected
4083
+ virtual devices.
4084
+ :param pulumi.Input[bool] check_beacon: Enables beacon probing as an additional measure
4085
+ to detect NIC failure.
4086
+
4087
+ > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
4088
+ probing.
3707
4089
  :param pulumi.Input[str] config_version: The current version of the VDS configuration, incremented
3708
4090
  by subsequent updates to the VDS.
3709
4091
  :param pulumi.Input[str] contact_detail: The detailed contact information for the person
@@ -3718,12 +4100,18 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3718
4100
  :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VDS will be
3719
4101
  created. Forces a new resource if changed.
3720
4102
  :param pulumi.Input[str] description: A detailed description for the VDS.
3721
- :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 on the ports this policy applies to.
3722
- :param pulumi.Input[int] egress_shaping_average_bandwidth: The average egress bandwidth in bits per second if egress shaping is enabled on the port.
3723
- :param pulumi.Input[int] egress_shaping_burst_size: The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
3724
- :param pulumi.Input[bool] egress_shaping_enabled: True if the traffic shaper is enabled for egress traffic on the port.
3725
- :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
3726
- :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
4103
+ :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 for the ports
4104
+ for which this policy applies to.
4105
+ :param pulumi.Input[int] egress_shaping_average_bandwidth: The average bandwidth in bits
4106
+ per second if egress traffic shaping is enabled on the port.
4107
+ :param pulumi.Input[int] egress_shaping_burst_size: The maximum burst size allowed in
4108
+ bytes if egress traffic shaping is enabled on the port.
4109
+ :param pulumi.Input[bool] egress_shaping_enabled: `true` if the traffic shaper is enabled
4110
+ on the port for egress traffic.
4111
+ :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak bandwidth during bursts
4112
+ in bits per second if egress traffic shaping is enabled on the port.
4113
+ :param pulumi.Input[bool] failback: If `true`, the teaming policy will re-activate failed
4114
+ uplinks higher in precedence when they come back up.
3727
4115
  :param pulumi.Input[int] faulttolerance_maximum_mbit: The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
3728
4116
  :param pulumi.Input[int] faulttolerance_reservation_mbit: The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
3729
4117
  :param pulumi.Input[int] faulttolerance_share_count: The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
@@ -3734,12 +4122,18 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3734
4122
  :param pulumi.Input[int] hbr_reservation_mbit: The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
3735
4123
  :param pulumi.Input[int] hbr_share_count: The amount of shares to allocate to the hbr traffic class for a custom share level.
3736
4124
  :param pulumi.Input[str] hbr_share_level: The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
3737
- :param pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchHostArgs', 'DistributedVirtualSwitchHostArgsDict']]]] hosts: A host member specification.
3738
- :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
3739
- :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
3740
- :param pulumi.Input[int] ingress_shaping_burst_size: The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
3741
- :param pulumi.Input[bool] ingress_shaping_enabled: True if the traffic shaper is enabled for ingress traffic on the port.
3742
- :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
4125
+ :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchHostArgs']]]] hosts: Use the `host` block to declare a host specification. The
4126
+ options are:
4127
+ :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN
4128
+ mappings not managed by this resource. Defaults to false.
4129
+ :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average bandwidth in
4130
+ bits per second if ingress traffic shaping is enabled on the port.
4131
+ :param pulumi.Input[int] ingress_shaping_burst_size: The maximum burst size allowed in
4132
+ bytes if ingress traffic shaping is enabled on the port.
4133
+ :param pulumi.Input[bool] ingress_shaping_enabled: `true` if the traffic shaper is
4134
+ enabled on the port for ingress traffic.
4135
+ :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak bandwidth during
4136
+ bursts in bits per second if ingress traffic shaping is enabled on the port.
3743
4137
  :param pulumi.Input[str] ipv4_address: An IPv4 address to identify the switch. This is
3744
4138
  mostly useful when used with the Netflow arguments.
3745
4139
  :param pulumi.Input[int] iscsi_maximum_mbit: The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
@@ -3749,8 +4143,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3749
4143
  :param pulumi.Input[str] lacp_api_version: The Link Aggregation Control Protocol group
3750
4144
  version to use with the VDS. Possible values are `singleLag` and
3751
4145
  `multipleLag`.
3752
- :param pulumi.Input[bool] lacp_enabled: Whether or not to enable LACP on all uplink ports.
3753
- :param pulumi.Input[str] lacp_mode: The uplink LACP mode to use. Can be one of active or passive.
4146
+ :param pulumi.Input[bool] lacp_enabled: Enables LACP for the ports that this policy
4147
+ applies to.
4148
+ :param pulumi.Input[str] lacp_mode: The LACP mode. Can be one of `active` or `passive`.
3754
4149
  :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
3755
4150
  for link discovery traffic.
3756
4151
  :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid
@@ -3763,32 +4158,60 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3763
4158
  :param pulumi.Input[str] multicast_filtering_mode: The multicast filtering mode to use
3764
4159
  with the VDS. Can be one of `legacyFiltering` or `snooping`.
3765
4160
  :param pulumi.Input[str] name: The name of the VDS.
3766
- :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which active flows are forced to be exported to the collector.
3767
- :param pulumi.Input[str] netflow_collector_ip_address: IP address for the netflow collector, using IPv4 or IPv6.
3768
- :param pulumi.Input[int] netflow_collector_port: The port for the netflow collector.
3769
- :param pulumi.Input[bool] netflow_enabled: Indicates whether to enable netflow on all ports.
3770
- :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which idle flows are forced to be exported to the collector.
3771
- :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to traffic that has both source and destination served by the same host.
3772
- :param pulumi.Input[int] netflow_observation_domain_id: The observation Domain ID for the netflow collector.
3773
- :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
3774
- packets are analyzed.
3775
- :param pulumi.Input[bool] network_resource_control_enabled: Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
3776
- :param pulumi.Input[str] network_resource_control_version: The network I/O control version to use. Can be one of version2 or version3.
4161
+ :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which
4162
+ active flows are forced to be exported to the collector. Allowed range is
4163
+ `60` to `3600`. Default: `60`.
4164
+ :param pulumi.Input[str] netflow_collector_ip_address: IP address for the Netflow
4165
+ collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
4166
+ Must be set before Netflow can be enabled.
4167
+ :param pulumi.Input[int] netflow_collector_port: Port for the Netflow collector. This
4168
+ must be set before Netflow can be enabled.
4169
+ :param pulumi.Input[bool] netflow_enabled: Enables Netflow on all ports that this policy
4170
+ applies to.
4171
+ :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which
4172
+ idle flows are forced to be exported to the collector. Allowed range is `10`
4173
+ to `600`. Default: `15`.
4174
+ :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to
4175
+ traffic that has both source and destination served by the same host.
4176
+ Default: `false`.
4177
+ :param pulumi.Input[int] netflow_observation_domain_id: The observation domain ID for
4178
+ the Netflow collector.
4179
+ :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to
4180
+ the number of packets analyzed. The default is `0`, which indicates that the
4181
+ VDS should analyze all packets. The maximum value is `1000`, which
4182
+ indicates an analysis rate of 0.001%!
4183
+ (MISSING)
4184
+ :param pulumi.Input[bool] network_resource_control_enabled: Set to `true` to enable
4185
+ network I/O control. Default: `false`.
4186
+ :param pulumi.Input[str] network_resource_control_version: The version of network I/O
4187
+ control to use. Can be one of `version2` or `version3`. Default: `version2`.
3777
4188
  :param pulumi.Input[int] nfs_maximum_mbit: The maximum allowed usage for the nfs traffic class, in Mbits/sec.
3778
4189
  :param pulumi.Input[int] nfs_reservation_mbit: The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
3779
4190
  :param pulumi.Input[int] nfs_share_count: The amount of shares to allocate to the nfs traffic class for a custom share level.
3780
4191
  :param pulumi.Input[str] nfs_share_level: The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
3781
- :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
3782
- :param pulumi.Input[int] port_private_secondary_vlan_id: The secondary VLAN ID for this port.
3783
- :param pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchPvlanMappingArgs', 'DistributedVirtualSwitchPvlanMappingArgsDict']]]] pvlan_mappings: A private VLAN (PVLAN) mapping.
3784
- :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
4192
+ :param pulumi.Input[bool] notify_switches: If `true`, the teaming policy will notify the
4193
+ broadcast network of an uplink failover, triggering cache updates.
4194
+ :param pulumi.Input[int] port_private_secondary_vlan_id: Used to define a secondary VLAN
4195
+ ID when using private VLANs.
4196
+ :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchPvlanMappingArgs']]]] pvlan_mappings: Use the `pvlan_mapping` block to declare a
4197
+ private VLAN mapping. The options are:
4198
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: A list of standby uplinks to be used in
4199
+ failover. These uplinks need to match the definitions in the
4200
+ `uplinks` VDS argument. See
4201
+ here for more details.
3785
4202
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
3786
- :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
3787
- failover_explicit, or loadbalance_loadbased.
3788
- :param pulumi.Input[bool] tx_uplink: If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
3789
- forwarded done by the switch.
3790
- :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
3791
- across hosts.
4203
+
4204
+ > **NOTE:** Tagging support requires vCenter Server 6.0 or higher.
4205
+ :param pulumi.Input[str] teaming_policy: The uplink teaming policy. Can be one of
4206
+ `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
4207
+ `failover_explicit`, or `loadbalance_loadbased`.
4208
+ :param pulumi.Input[bool] tx_uplink: Forward all traffic transmitted by ports for which
4209
+ this policy applies to its VDS uplinks.
4210
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of strings that uniquely identifies the names
4211
+ of the uplinks on the VDS across hosts. The number of items in this list
4212
+ controls the number of uplinks that exist on the VDS, in addition to the
4213
+ names. See here for an example on how to
4214
+ use this option.
3792
4215
  :param pulumi.Input[int] vdp_maximum_mbit: The maximum allowed usage for the vdp traffic class, in Mbits/sec.
3793
4216
  :param pulumi.Input[int] vdp_reservation_mbit: The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
3794
4217
  :param pulumi.Input[int] vdp_share_count: The amount of shares to allocate to the vdp traffic class for a custom share level.
@@ -3801,7 +4224,28 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3801
4224
  :param pulumi.Input[int] virtualmachine_share_count: The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
3802
4225
  :param pulumi.Input[str] virtualmachine_share_level: The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
3803
4226
  :param pulumi.Input[int] vlan_id: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
3804
- :param pulumi.Input[Sequence[pulumi.Input[Union['DistributedVirtualSwitchVlanRangeArgs', 'DistributedVirtualSwitchVlanRangeArgsDict']]]] vlan_ranges: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
4227
+ :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchVlanRangeArgs']]]] vlan_ranges: Used to denote VLAN trunking. Use the `min_vlan`
4228
+ and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
4229
+ `vlan_range` definitions are allowed, but they must not overlap. Example
4230
+ below:
4231
+
4232
+ <!--Start PulumiCodeChooser -->
4233
+ ```python
4234
+ import pulumi
4235
+ import pulumi_vsphere as vsphere
4236
+
4237
+ vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
4238
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
4239
+ max_vlan=199,
4240
+ min_vlan=100,
4241
+ ),
4242
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
4243
+ max_vlan=399,
4244
+ min_vlan=300,
4245
+ ),
4246
+ ])
4247
+ ```
4248
+ <!--End PulumiCodeChooser -->
3805
4249
  :param pulumi.Input[int] vmotion_maximum_mbit: The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
3806
4250
  :param pulumi.Input[int] vmotion_reservation_mbit: The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
3807
4251
  :param pulumi.Input[int] vmotion_share_count: The amount of shares to allocate to the vmotion traffic class for a custom share level.
@@ -3916,7 +4360,10 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3916
4360
  @pulumi.getter(name="activeUplinks")
3917
4361
  def active_uplinks(self) -> pulumi.Output[Sequence[str]]:
3918
4362
  """
3919
- List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
4363
+ A list of active uplinks to be used in load
4364
+ balancing. These uplinks need to match the definitions in the
4365
+ `uplinks` VDS argument. See
4366
+ here for more details.
3920
4367
  """
3921
4368
  return pulumi.get(self, "active_uplinks")
3922
4369
 
@@ -3924,8 +4371,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3924
4371
  @pulumi.getter(name="allowForgedTransmits")
3925
4372
  def allow_forged_transmits(self) -> pulumi.Output[bool]:
3926
4373
  """
3927
- Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
3928
- that of its own.
4374
+ Controls whether or not a virtual
4375
+ network adapter is allowed to send network traffic with a different MAC
4376
+ address than that of its own.
3929
4377
  """
3930
4378
  return pulumi.get(self, "allow_forged_transmits")
3931
4379
 
@@ -3933,7 +4381,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3933
4381
  @pulumi.getter(name="allowMacChanges")
3934
4382
  def allow_mac_changes(self) -> pulumi.Output[bool]:
3935
4383
  """
3936
- Controls whether or not the Media Access Control (MAC) address can be changed.
4384
+ Controls whether or not the Media Access
4385
+ Control (MAC) address can be changed.
3937
4386
  """
3938
4387
  return pulumi.get(self, "allow_mac_changes")
3939
4388
 
@@ -3941,7 +4390,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3941
4390
  @pulumi.getter(name="allowPromiscuous")
3942
4391
  def allow_promiscuous(self) -> pulumi.Output[bool]:
3943
4392
  """
3944
- Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
4393
+ Enable promiscuous mode on the network. This
4394
+ flag indicates whether or not all traffic is seen on a given port.
3945
4395
  """
3946
4396
  return pulumi.get(self, "allow_promiscuous")
3947
4397
 
@@ -3981,7 +4431,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3981
4431
  @pulumi.getter(name="blockAllPorts")
3982
4432
  def block_all_ports(self) -> pulumi.Output[bool]:
3983
4433
  """
3984
- Indicates whether to block all ports by default.
4434
+ Shuts down all ports in the port groups that
4435
+ this policy applies to, effectively blocking all network access to connected
4436
+ virtual devices.
3985
4437
  """
3986
4438
  return pulumi.get(self, "block_all_ports")
3987
4439
 
@@ -3989,7 +4441,11 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
3989
4441
  @pulumi.getter(name="checkBeacon")
3990
4442
  def check_beacon(self) -> pulumi.Output[bool]:
3991
4443
  """
3992
- Enable beacon probing on the ports this policy applies to.
4444
+ Enables beacon probing as an additional measure
4445
+ to detect NIC failure.
4446
+
4447
+ > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
4448
+ probing.
3993
4449
  """
3994
4450
  return pulumi.get(self, "check_beacon")
3995
4451
 
@@ -4053,7 +4509,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4053
4509
  @pulumi.getter(name="directpathGen2Allowed")
4054
4510
  def directpath_gen2_allowed(self) -> pulumi.Output[bool]:
4055
4511
  """
4056
- Allow VMDirectPath Gen2 on the ports this policy applies to.
4512
+ Allow VMDirectPath Gen2 for the ports
4513
+ for which this policy applies to.
4057
4514
  """
4058
4515
  return pulumi.get(self, "directpath_gen2_allowed")
4059
4516
 
@@ -4061,7 +4518,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4061
4518
  @pulumi.getter(name="egressShapingAverageBandwidth")
4062
4519
  def egress_shaping_average_bandwidth(self) -> pulumi.Output[int]:
4063
4520
  """
4064
- The average egress bandwidth in bits per second if egress shaping is enabled on the port.
4521
+ The average bandwidth in bits
4522
+ per second if egress traffic shaping is enabled on the port.
4065
4523
  """
4066
4524
  return pulumi.get(self, "egress_shaping_average_bandwidth")
4067
4525
 
@@ -4069,7 +4527,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4069
4527
  @pulumi.getter(name="egressShapingBurstSize")
4070
4528
  def egress_shaping_burst_size(self) -> pulumi.Output[int]:
4071
4529
  """
4072
- The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
4530
+ The maximum burst size allowed in
4531
+ bytes if egress traffic shaping is enabled on the port.
4073
4532
  """
4074
4533
  return pulumi.get(self, "egress_shaping_burst_size")
4075
4534
 
@@ -4077,7 +4536,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4077
4536
  @pulumi.getter(name="egressShapingEnabled")
4078
4537
  def egress_shaping_enabled(self) -> pulumi.Output[bool]:
4079
4538
  """
4080
- True if the traffic shaper is enabled for egress traffic on the port.
4539
+ `true` if the traffic shaper is enabled
4540
+ on the port for egress traffic.
4081
4541
  """
4082
4542
  return pulumi.get(self, "egress_shaping_enabled")
4083
4543
 
@@ -4085,7 +4545,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4085
4545
  @pulumi.getter(name="egressShapingPeakBandwidth")
4086
4546
  def egress_shaping_peak_bandwidth(self) -> pulumi.Output[int]:
4087
4547
  """
4088
- The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
4548
+ The peak bandwidth during bursts
4549
+ in bits per second if egress traffic shaping is enabled on the port.
4089
4550
  """
4090
4551
  return pulumi.get(self, "egress_shaping_peak_bandwidth")
4091
4552
 
@@ -4093,7 +4554,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4093
4554
  @pulumi.getter
4094
4555
  def failback(self) -> pulumi.Output[bool]:
4095
4556
  """
4096
- If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
4557
+ If `true`, the teaming policy will re-activate failed
4558
+ uplinks higher in precedence when they come back up.
4097
4559
  """
4098
4560
  return pulumi.get(self, "failback")
4099
4561
 
@@ -4174,7 +4636,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4174
4636
  @pulumi.getter
4175
4637
  def hosts(self) -> pulumi.Output[Optional[Sequence['outputs.DistributedVirtualSwitchHost']]]:
4176
4638
  """
4177
- A host member specification.
4639
+ Use the `host` block to declare a host specification. The
4640
+ options are:
4178
4641
  """
4179
4642
  return pulumi.get(self, "hosts")
4180
4643
 
@@ -4182,7 +4645,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4182
4645
  @pulumi.getter(name="ignoreOtherPvlanMappings")
4183
4646
  def ignore_other_pvlan_mappings(self) -> pulumi.Output[Optional[bool]]:
4184
4647
  """
4185
- Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
4648
+ Whether to ignore existing PVLAN
4649
+ mappings not managed by this resource. Defaults to false.
4186
4650
  """
4187
4651
  return pulumi.get(self, "ignore_other_pvlan_mappings")
4188
4652
 
@@ -4190,7 +4654,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4190
4654
  @pulumi.getter(name="ingressShapingAverageBandwidth")
4191
4655
  def ingress_shaping_average_bandwidth(self) -> pulumi.Output[int]:
4192
4656
  """
4193
- The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
4657
+ The average bandwidth in
4658
+ bits per second if ingress traffic shaping is enabled on the port.
4194
4659
  """
4195
4660
  return pulumi.get(self, "ingress_shaping_average_bandwidth")
4196
4661
 
@@ -4198,7 +4663,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4198
4663
  @pulumi.getter(name="ingressShapingBurstSize")
4199
4664
  def ingress_shaping_burst_size(self) -> pulumi.Output[int]:
4200
4665
  """
4201
- The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
4666
+ The maximum burst size allowed in
4667
+ bytes if ingress traffic shaping is enabled on the port.
4202
4668
  """
4203
4669
  return pulumi.get(self, "ingress_shaping_burst_size")
4204
4670
 
@@ -4206,7 +4672,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4206
4672
  @pulumi.getter(name="ingressShapingEnabled")
4207
4673
  def ingress_shaping_enabled(self) -> pulumi.Output[bool]:
4208
4674
  """
4209
- True if the traffic shaper is enabled for ingress traffic on the port.
4675
+ `true` if the traffic shaper is
4676
+ enabled on the port for ingress traffic.
4210
4677
  """
4211
4678
  return pulumi.get(self, "ingress_shaping_enabled")
4212
4679
 
@@ -4214,7 +4681,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4214
4681
  @pulumi.getter(name="ingressShapingPeakBandwidth")
4215
4682
  def ingress_shaping_peak_bandwidth(self) -> pulumi.Output[int]:
4216
4683
  """
4217
- The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
4684
+ The peak bandwidth during
4685
+ bursts in bits per second if ingress traffic shaping is enabled on the port.
4218
4686
  """
4219
4687
  return pulumi.get(self, "ingress_shaping_peak_bandwidth")
4220
4688
 
@@ -4273,7 +4741,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4273
4741
  @pulumi.getter(name="lacpEnabled")
4274
4742
  def lacp_enabled(self) -> pulumi.Output[bool]:
4275
4743
  """
4276
- Whether or not to enable LACP on all uplink ports.
4744
+ Enables LACP for the ports that this policy
4745
+ applies to.
4277
4746
  """
4278
4747
  return pulumi.get(self, "lacp_enabled")
4279
4748
 
@@ -4281,7 +4750,7 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4281
4750
  @pulumi.getter(name="lacpMode")
4282
4751
  def lacp_mode(self) -> pulumi.Output[str]:
4283
4752
  """
4284
- The uplink LACP mode to use. Can be one of active or passive.
4753
+ The LACP mode. Can be one of `active` or `passive`.
4285
4754
  """
4286
4755
  return pulumi.get(self, "lacp_mode")
4287
4756
 
@@ -4364,7 +4833,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4364
4833
  @pulumi.getter(name="netflowActiveFlowTimeout")
4365
4834
  def netflow_active_flow_timeout(self) -> pulumi.Output[Optional[int]]:
4366
4835
  """
4367
- The number of seconds after which active flows are forced to be exported to the collector.
4836
+ The number of seconds after which
4837
+ active flows are forced to be exported to the collector. Allowed range is
4838
+ `60` to `3600`. Default: `60`.
4368
4839
  """
4369
4840
  return pulumi.get(self, "netflow_active_flow_timeout")
4370
4841
 
@@ -4372,7 +4843,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4372
4843
  @pulumi.getter(name="netflowCollectorIpAddress")
4373
4844
  def netflow_collector_ip_address(self) -> pulumi.Output[Optional[str]]:
4374
4845
  """
4375
- IP address for the netflow collector, using IPv4 or IPv6.
4846
+ IP address for the Netflow
4847
+ collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
4848
+ Must be set before Netflow can be enabled.
4376
4849
  """
4377
4850
  return pulumi.get(self, "netflow_collector_ip_address")
4378
4851
 
@@ -4380,7 +4853,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4380
4853
  @pulumi.getter(name="netflowCollectorPort")
4381
4854
  def netflow_collector_port(self) -> pulumi.Output[Optional[int]]:
4382
4855
  """
4383
- The port for the netflow collector.
4856
+ Port for the Netflow collector. This
4857
+ must be set before Netflow can be enabled.
4384
4858
  """
4385
4859
  return pulumi.get(self, "netflow_collector_port")
4386
4860
 
@@ -4388,7 +4862,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4388
4862
  @pulumi.getter(name="netflowEnabled")
4389
4863
  def netflow_enabled(self) -> pulumi.Output[bool]:
4390
4864
  """
4391
- Indicates whether to enable netflow on all ports.
4865
+ Enables Netflow on all ports that this policy
4866
+ applies to.
4392
4867
  """
4393
4868
  return pulumi.get(self, "netflow_enabled")
4394
4869
 
@@ -4396,7 +4871,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4396
4871
  @pulumi.getter(name="netflowIdleFlowTimeout")
4397
4872
  def netflow_idle_flow_timeout(self) -> pulumi.Output[Optional[int]]:
4398
4873
  """
4399
- The number of seconds after which idle flows are forced to be exported to the collector.
4874
+ The number of seconds after which
4875
+ idle flows are forced to be exported to the collector. Allowed range is `10`
4876
+ to `600`. Default: `15`.
4400
4877
  """
4401
4878
  return pulumi.get(self, "netflow_idle_flow_timeout")
4402
4879
 
@@ -4404,7 +4881,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4404
4881
  @pulumi.getter(name="netflowInternalFlowsOnly")
4405
4882
  def netflow_internal_flows_only(self) -> pulumi.Output[Optional[bool]]:
4406
4883
  """
4407
- Whether to limit analysis to traffic that has both source and destination served by the same host.
4884
+ Whether to limit analysis to
4885
+ traffic that has both source and destination served by the same host.
4886
+ Default: `false`.
4408
4887
  """
4409
4888
  return pulumi.get(self, "netflow_internal_flows_only")
4410
4889
 
@@ -4412,7 +4891,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4412
4891
  @pulumi.getter(name="netflowObservationDomainId")
4413
4892
  def netflow_observation_domain_id(self) -> pulumi.Output[Optional[int]]:
4414
4893
  """
4415
- The observation Domain ID for the netflow collector.
4894
+ The observation domain ID for
4895
+ the Netflow collector.
4416
4896
  """
4417
4897
  return pulumi.get(self, "netflow_observation_domain_id")
4418
4898
 
@@ -4420,8 +4900,11 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4420
4900
  @pulumi.getter(name="netflowSamplingRate")
4421
4901
  def netflow_sampling_rate(self) -> pulumi.Output[Optional[int]]:
4422
4902
  """
4423
- The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
4424
- packets are analyzed.
4903
+ The ratio of total number of packets to
4904
+ the number of packets analyzed. The default is `0`, which indicates that the
4905
+ VDS should analyze all packets. The maximum value is `1000`, which
4906
+ indicates an analysis rate of 0.001%!
4907
+ (MISSING)
4425
4908
  """
4426
4909
  return pulumi.get(self, "netflow_sampling_rate")
4427
4910
 
@@ -4429,7 +4912,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4429
4912
  @pulumi.getter(name="networkResourceControlEnabled")
4430
4913
  def network_resource_control_enabled(self) -> pulumi.Output[Optional[bool]]:
4431
4914
  """
4432
- Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
4915
+ Set to `true` to enable
4916
+ network I/O control. Default: `false`.
4433
4917
  """
4434
4918
  return pulumi.get(self, "network_resource_control_enabled")
4435
4919
 
@@ -4437,7 +4921,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4437
4921
  @pulumi.getter(name="networkResourceControlVersion")
4438
4922
  def network_resource_control_version(self) -> pulumi.Output[str]:
4439
4923
  """
4440
- The network I/O control version to use. Can be one of version2 or version3.
4924
+ The version of network I/O
4925
+ control to use. Can be one of `version2` or `version3`. Default: `version2`.
4441
4926
  """
4442
4927
  return pulumi.get(self, "network_resource_control_version")
4443
4928
 
@@ -4477,7 +4962,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4477
4962
  @pulumi.getter(name="notifySwitches")
4478
4963
  def notify_switches(self) -> pulumi.Output[bool]:
4479
4964
  """
4480
- If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
4965
+ If `true`, the teaming policy will notify the
4966
+ broadcast network of an uplink failover, triggering cache updates.
4481
4967
  """
4482
4968
  return pulumi.get(self, "notify_switches")
4483
4969
 
@@ -4485,7 +4971,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4485
4971
  @pulumi.getter(name="portPrivateSecondaryVlanId")
4486
4972
  def port_private_secondary_vlan_id(self) -> pulumi.Output[int]:
4487
4973
  """
4488
- The secondary VLAN ID for this port.
4974
+ Used to define a secondary VLAN
4975
+ ID when using private VLANs.
4489
4976
  """
4490
4977
  return pulumi.get(self, "port_private_secondary_vlan_id")
4491
4978
 
@@ -4493,7 +4980,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4493
4980
  @pulumi.getter(name="pvlanMappings")
4494
4981
  def pvlan_mappings(self) -> pulumi.Output[Optional[Sequence['outputs.DistributedVirtualSwitchPvlanMapping']]]:
4495
4982
  """
4496
- A private VLAN (PVLAN) mapping.
4983
+ Use the `pvlan_mapping` block to declare a
4984
+ private VLAN mapping. The options are:
4497
4985
  """
4498
4986
  return pulumi.get(self, "pvlan_mappings")
4499
4987
 
@@ -4501,7 +4989,10 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4501
4989
  @pulumi.getter(name="standbyUplinks")
4502
4990
  def standby_uplinks(self) -> pulumi.Output[Sequence[str]]:
4503
4991
  """
4504
- List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
4992
+ A list of standby uplinks to be used in
4993
+ failover. These uplinks need to match the definitions in the
4994
+ `uplinks` VDS argument. See
4995
+ here for more details.
4505
4996
  """
4506
4997
  return pulumi.get(self, "standby_uplinks")
4507
4998
 
@@ -4510,6 +5001,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4510
5001
  def tags(self) -> pulumi.Output[Optional[Sequence[str]]]:
4511
5002
  """
4512
5003
  The IDs of any tags to attach to this resource.
5004
+
5005
+ > **NOTE:** Tagging support requires vCenter Server 6.0 or higher.
4513
5006
  """
4514
5007
  return pulumi.get(self, "tags")
4515
5008
 
@@ -4517,8 +5010,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4517
5010
  @pulumi.getter(name="teamingPolicy")
4518
5011
  def teaming_policy(self) -> pulumi.Output[str]:
4519
5012
  """
4520
- The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
4521
- failover_explicit, or loadbalance_loadbased.
5013
+ The uplink teaming policy. Can be one of
5014
+ `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
5015
+ `failover_explicit`, or `loadbalance_loadbased`.
4522
5016
  """
4523
5017
  return pulumi.get(self, "teaming_policy")
4524
5018
 
@@ -4526,8 +5020,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4526
5020
  @pulumi.getter(name="txUplink")
4527
5021
  def tx_uplink(self) -> pulumi.Output[bool]:
4528
5022
  """
4529
- If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
4530
- forwarded done by the switch.
5023
+ Forward all traffic transmitted by ports for which
5024
+ this policy applies to its VDS uplinks.
4531
5025
  """
4532
5026
  return pulumi.get(self, "tx_uplink")
4533
5027
 
@@ -4535,8 +5029,11 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4535
5029
  @pulumi.getter
4536
5030
  def uplinks(self) -> pulumi.Output[Sequence[str]]:
4537
5031
  """
4538
- A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
4539
- across hosts.
5032
+ A list of strings that uniquely identifies the names
5033
+ of the uplinks on the VDS across hosts. The number of items in this list
5034
+ controls the number of uplinks that exist on the VDS, in addition to the
5035
+ names. See here for an example on how to
5036
+ use this option.
4540
5037
  """
4541
5038
  return pulumi.get(self, "uplinks")
4542
5039
 
@@ -4626,7 +5123,28 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
4626
5123
  @pulumi.getter(name="vlanRanges")
4627
5124
  def vlan_ranges(self) -> pulumi.Output[Sequence['outputs.DistributedVirtualSwitchVlanRange']]:
4628
5125
  """
4629
- The VLAN ID for single VLAN mode. 0 denotes no VLAN.
5126
+ Used to denote VLAN trunking. Use the `min_vlan`
5127
+ and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
5128
+ `vlan_range` definitions are allowed, but they must not overlap. Example
5129
+ below:
5130
+
5131
+ <!--Start PulumiCodeChooser -->
5132
+ ```python
5133
+ import pulumi
5134
+ import pulumi_vsphere as vsphere
5135
+
5136
+ vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
5137
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
5138
+ max_vlan=199,
5139
+ min_vlan=100,
5140
+ ),
5141
+ vsphere.DistributedVirtualSwitchVlanRangeArgs(
5142
+ max_vlan=399,
5143
+ min_vlan=300,
5144
+ ),
5145
+ ])
5146
+ ```
5147
+ <!--End PulumiCodeChooser -->
4630
5148
  """
4631
5149
  return pulumi.get(self, "vlan_ranges")
4632
5150