vsphere.DistributedVirtualSwitch
Explore with Pulumi AI
Create DistributedVirtualSwitch Resource
new DistributedVirtualSwitch(name: string, args: DistributedVirtualSwitchArgs, opts?: CustomResourceOptions);
@overload
def DistributedVirtualSwitch(resource_name: str,
opts: Optional[ResourceOptions] = None,
active_uplinks: Optional[Sequence[str]] = None,
allow_forged_transmits: Optional[bool] = None,
allow_mac_changes: Optional[bool] = None,
allow_promiscuous: Optional[bool] = None,
backupnfc_maximum_mbit: Optional[int] = None,
backupnfc_reservation_mbit: Optional[int] = None,
backupnfc_share_count: Optional[int] = None,
backupnfc_share_level: Optional[str] = None,
block_all_ports: Optional[bool] = None,
check_beacon: Optional[bool] = None,
contact_detail: Optional[str] = None,
contact_name: Optional[str] = None,
custom_attributes: Optional[Mapping[str, str]] = None,
datacenter_id: Optional[str] = None,
description: Optional[str] = None,
directpath_gen2_allowed: Optional[bool] = None,
egress_shaping_average_bandwidth: Optional[int] = None,
egress_shaping_burst_size: Optional[int] = None,
egress_shaping_enabled: Optional[bool] = None,
egress_shaping_peak_bandwidth: Optional[int] = None,
failback: Optional[bool] = None,
faulttolerance_maximum_mbit: Optional[int] = None,
faulttolerance_reservation_mbit: Optional[int] = None,
faulttolerance_share_count: Optional[int] = None,
faulttolerance_share_level: Optional[str] = None,
folder: Optional[str] = None,
hbr_maximum_mbit: Optional[int] = None,
hbr_reservation_mbit: Optional[int] = None,
hbr_share_count: Optional[int] = None,
hbr_share_level: Optional[str] = None,
hosts: Optional[Sequence[DistributedVirtualSwitchHostArgs]] = None,
ignore_other_pvlan_mappings: Optional[bool] = None,
ingress_shaping_average_bandwidth: Optional[int] = None,
ingress_shaping_burst_size: Optional[int] = None,
ingress_shaping_enabled: Optional[bool] = None,
ingress_shaping_peak_bandwidth: Optional[int] = None,
ipv4_address: Optional[str] = None,
iscsi_maximum_mbit: Optional[int] = None,
iscsi_reservation_mbit: Optional[int] = None,
iscsi_share_count: Optional[int] = None,
iscsi_share_level: Optional[str] = None,
lacp_api_version: Optional[str] = None,
lacp_enabled: Optional[bool] = None,
lacp_mode: Optional[str] = None,
link_discovery_operation: Optional[str] = None,
link_discovery_protocol: Optional[str] = None,
management_maximum_mbit: Optional[int] = None,
management_reservation_mbit: Optional[int] = None,
management_share_count: Optional[int] = None,
management_share_level: Optional[str] = None,
max_mtu: Optional[int] = None,
multicast_filtering_mode: Optional[str] = None,
name: Optional[str] = None,
netflow_active_flow_timeout: Optional[int] = None,
netflow_collector_ip_address: Optional[str] = None,
netflow_collector_port: Optional[int] = None,
netflow_enabled: Optional[bool] = None,
netflow_idle_flow_timeout: Optional[int] = None,
netflow_internal_flows_only: Optional[bool] = None,
netflow_observation_domain_id: Optional[int] = None,
netflow_sampling_rate: Optional[int] = None,
network_resource_control_enabled: Optional[bool] = None,
network_resource_control_version: Optional[str] = None,
nfs_maximum_mbit: Optional[int] = None,
nfs_reservation_mbit: Optional[int] = None,
nfs_share_count: Optional[int] = None,
nfs_share_level: Optional[str] = None,
notify_switches: Optional[bool] = None,
port_private_secondary_vlan_id: Optional[int] = None,
pvlan_mappings: Optional[Sequence[DistributedVirtualSwitchPvlanMappingArgs]] = None,
standby_uplinks: Optional[Sequence[str]] = None,
tags: Optional[Sequence[str]] = None,
teaming_policy: Optional[str] = None,
tx_uplink: Optional[bool] = None,
uplinks: Optional[Sequence[str]] = None,
vdp_maximum_mbit: Optional[int] = None,
vdp_reservation_mbit: Optional[int] = None,
vdp_share_count: Optional[int] = None,
vdp_share_level: Optional[str] = None,
version: Optional[str] = None,
virtualmachine_maximum_mbit: Optional[int] = None,
virtualmachine_reservation_mbit: Optional[int] = None,
virtualmachine_share_count: Optional[int] = None,
virtualmachine_share_level: Optional[str] = None,
vlan_id: Optional[int] = None,
vlan_ranges: Optional[Sequence[DistributedVirtualSwitchVlanRangeArgs]] = None,
vmotion_maximum_mbit: Optional[int] = None,
vmotion_reservation_mbit: Optional[int] = None,
vmotion_share_count: Optional[int] = None,
vmotion_share_level: Optional[str] = None,
vsan_maximum_mbit: Optional[int] = None,
vsan_reservation_mbit: Optional[int] = None,
vsan_share_count: Optional[int] = None,
vsan_share_level: Optional[str] = None)
@overload
def DistributedVirtualSwitch(resource_name: str,
args: DistributedVirtualSwitchArgs,
opts: Optional[ResourceOptions] = None)
func NewDistributedVirtualSwitch(ctx *Context, name string, args DistributedVirtualSwitchArgs, opts ...ResourceOption) (*DistributedVirtualSwitch, error)
public DistributedVirtualSwitch(string name, DistributedVirtualSwitchArgs args, CustomResourceOptions? opts = null)
public DistributedVirtualSwitch(String name, DistributedVirtualSwitchArgs args)
public DistributedVirtualSwitch(String name, DistributedVirtualSwitchArgs args, CustomResourceOptions options)
type: vsphere:DistributedVirtualSwitch
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args DistributedVirtualSwitchArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args DistributedVirtualSwitchArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args DistributedVirtualSwitchArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args DistributedVirtualSwitchArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args DistributedVirtualSwitchArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
DistributedVirtualSwitch Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The DistributedVirtualSwitch resource accepts the following input properties:
- Datacenter
Id string The ID of the datacenter where the VDS will be created. Forces a new resource if changed.
- Active
Uplinks List<string> A list of active uplinks to be used in load balancing. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- Allow
Forged boolTransmits Controls whether or not a virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
- Allow
Mac boolChanges Controls whether or not the Media Access Control (MAC) address can be changed.
- Allow
Promiscuous bool Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
- Backupnfc
Maximum intMbit The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
- Backupnfc
Reservation intMbit The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the backupNfc traffic class for a custom share level.
- string
The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
- Block
All boolPorts Shuts down all ports in the port groups that this policy applies to, effectively blocking all network access to connected virtual devices.
- Check
Beacon bool Enables beacon probing as an additional measure to detect NIC failure.
NOTE: VMware recommends using a minimum of 3 NICs when using beacon probing.
- Contact
Detail string The detailed contact information for the person who is responsible for the VDS.
- Contact
Name string The name of the person who is responsible for the VDS.
- Custom
Attributes Dictionary<string, string> Map of custom attribute ids to attribute value strings to set for VDS.
NOTE: Custom attributes are unsupported on direct ESXi host connections and requires vCenter Server.
- Description string
A detailed description for the VDS.
- Directpath
Gen2Allowed bool Allow VMDirectPath Gen2 for the ports for which this policy applies to.
- Egress
Shaping intAverage Bandwidth The average bandwidth in bits per second if egress traffic shaping is enabled on the port.
- Egress
Shaping intBurst Size The maximum burst size allowed in bytes if egress traffic shaping is enabled on the port.
- Egress
Shaping boolEnabled true
if the traffic shaper is enabled on the port for egress traffic.- Egress
Shaping intPeak Bandwidth The peak bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
- Failback bool
If
true
, the teaming policy will re-activate failed uplinks higher in precedence when they come back up.- Faulttolerance
Maximum intMbit The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
- Faulttolerance
Reservation intMbit The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
- string
The allocation level for the faultTolerance traffic class. Can be one of high, low, normal, or custom.
- Folder string
The folder in which to create the VDS. Forces a new resource if changed.
- Hbr
Maximum intMbit The maximum allowed usage for the hbr traffic class, in Mbits/sec.
- Hbr
Reservation intMbit The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the hbr traffic class for a custom share level.
- string
The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
- Hosts
List<Pulumi.
VSphere. Inputs. Distributed Virtual Switch Host> Use the
host
block to declare a host specification. The options are:- Ignore
Other boolPvlan Mappings Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
- Ingress
Shaping intAverage Bandwidth The average bandwidth in bits per second if ingress traffic shaping is enabled on the port.
- Ingress
Shaping intBurst Size The maximum burst size allowed in bytes if ingress traffic shaping is enabled on the port.
- Ingress
Shaping boolEnabled true
if the traffic shaper is enabled on the port for ingress traffic.- Ingress
Shaping intPeak Bandwidth The peak bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
- Ipv4Address string
An IPv4 address to identify the switch. This is mostly useful when used with the Netflow arguments.
- Iscsi
Maximum intMbit The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
- Iscsi
Reservation intMbit The amount of guaranteed bandwidth for the iSCSI traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the iSCSI traffic class for a custom share level.
- string
The allocation level for the iSCSI traffic class. Can be one of high, low, normal, or custom.
- Lacp
Api stringVersion The Link Aggregation Control Protocol group version to use with the VDS. Possible values are
singleLag
andmultipleLag
.- Lacp
Enabled bool Enables LACP for the ports that this policy applies to.
- Lacp
Mode string The LACP mode. Can be one of
active
orpassive
.- Link
Discovery stringOperation Whether to
advertise
orlisten
for link discovery traffic.- Link
Discovery stringProtocol The discovery protocol type. Valid types are
cdp
andlldp
.- Management
Maximum intMbit The maximum allowed usage for the management traffic class, in Mbits/sec.
- Management
Reservation intMbit The amount of guaranteed bandwidth for the management traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the management traffic class for a custom share level.
- string
The allocation level for the management traffic class. Can be one of high, low, normal, or custom.
- Max
Mtu int The maximum transmission unit (MTU) for the VDS.
- Multicast
Filtering stringMode The multicast filtering mode to use with the VDS. Can be one of
legacyFiltering
orsnooping
.- Name string
The name of the VDS.
- Netflow
Active intFlow Timeout The number of seconds after which active flows are forced to be exported to the collector. Allowed range is
60
to3600
. Default:60
.- Netflow
Collector stringIp Address IP address for the Netflow collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later. Must be set before Netflow can be enabled.
- Netflow
Collector intPort Port for the Netflow collector. This must be set before Netflow can be enabled.
- Netflow
Enabled bool Enables Netflow on all ports that this policy applies to.
- Netflow
Idle intFlow Timeout The number of seconds after which idle flows are forced to be exported to the collector. Allowed range is
10
to600
. Default:15
.- Netflow
Internal boolFlows Only Whether to limit analysis to traffic that has both source and destination served by the same host. Default:
false
.- Netflow
Observation intDomain Id The observation domain ID for the Netflow collector.
- Netflow
Sampling intRate The ratio of total number of packets to the number of packets analyzed. The default is
0
, which indicates that the VDS should analyze all packets. The maximum value is1000
, which indicates an analysis rate of 0.001%.- Network
Resource boolControl Enabled Set to
true
to enable network I/O control. Default:false
.- Network
Resource stringControl Version The version of network I/O control to use. Can be one of
version2
orversion3
. Default:version2
.- Nfs
Maximum intMbit The maximum allowed usage for the nfs traffic class, in Mbits/sec.
- Nfs
Reservation intMbit The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the nfs traffic class for a custom share level.
- string
The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
- Notify
Switches bool If
true
, the teaming policy will notify the broadcast network of an uplink failover, triggering cache updates.- Port
Private intSecondary Vlan Id Used to define a secondary VLAN ID when using private VLANs.
- Pvlan
Mappings List<Pulumi.VSphere. Inputs. Distributed Virtual Switch Pvlan Mapping> Use the
pvlan_mapping
block to declare a private VLAN mapping. The options are:- Standby
Uplinks List<string> A list of standby uplinks to be used in failover. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- List<string>
The IDs of any tags to attach to this resource.
NOTE: Tagging support requires vCenter Server 6.0 or higher.
- Teaming
Policy string The uplink teaming policy. Can be one of
loadbalance_ip
,loadbalance_srcmac
,loadbalance_srcid
,failover_explicit
, orloadbalance_loadbased
.- Tx
Uplink bool Forward all traffic transmitted by ports for which this policy applies to its VDS uplinks.
- Uplinks List<string>
A list of strings that uniquely identifies the names of the uplinks on the VDS across hosts. The number of items in this list controls the number of uplinks that exist on the VDS, in addition to the names. See here for an example on how to use this option.
- Vdp
Maximum intMbit The maximum allowed usage for the vdp traffic class, in Mbits/sec.
- Vdp
Reservation intMbit The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vdp traffic class for a custom share level.
- string
The allocation level for the vdp traffic class. Can be one of high, low, normal, or custom.
- Version string
The version of the VDS. BY default, a VDS is created at the latest version supported by the vSphere version if not specified. A VDS can be upgraded to a newer version, but can not be downgraded.
- Virtualmachine
Maximum intMbit The maximum allowed usage for the virtualMachine traffic class, in Mbits/sec.
- Virtualmachine
Reservation intMbit The amount of guaranteed bandwidth for the virtualMachine traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
- string
The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
- Vlan
Id int The VLAN ID for single VLAN mode. 0 denotes no VLAN.
- Vlan
Ranges List<Pulumi.VSphere. Inputs. Distributed Virtual Switch Vlan Range> Used to denote VLAN trunking. Use the
min_vlan
andmax_vlan
sub-arguments to define the tagged VLAN range. Multiplevlan_range
definitions are allowed, but they must not overlap. Example below:import * as pulumi from "@pulumi/pulumi"; import * as vsphere from "@pulumi/vsphere";
const vds = new vsphere.DistributedVirtualSwitch("vds", {vlanRanges: [ { maxVlan: 199, minVlan: 100, }, { maxVlan: 399, minVlan: 300, }, ]});
import pulumi import pulumi_vsphere as vsphere vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[ vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=199, min_vlan=100, ), vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=399, min_vlan=300, ), ])
using System.Collections.Generic; using System.Linq; using Pulumi; using VSphere = Pulumi.VSphere; return await Deployment.RunAsync(() => { var vds = new VSphere.DistributedVirtualSwitch("vds", new() { VlanRanges = new[] { new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 199, MinVlan = 100, }, new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 399, MinVlan = 300, }, }, }); });
package main import ( "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" "github.com/pulumi/pulumi/sdk/v3/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := vsphere.NewDistributedVirtualSwitch(ctx, "vds", &vsphere.DistributedVirtualSwitchArgs{ VlanRanges: vsphere.DistributedVirtualSwitchVlanRangeArray{ &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(199), MinVlan: pulumi.Int(100), }, &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(399), MinVlan: pulumi.Int(300), }, }, }) if err != nil { return err } return nil }) }
package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.vsphere.DistributedVirtualSwitch; import com.pulumi.vsphere.DistributedVirtualSwitchArgs; import com.pulumi.vsphere.inputs.DistributedVirtualSwitchVlanRangeArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var vds = new DistributedVirtualSwitch("vds", DistributedVirtualSwitchArgs.builder() .vlanRanges( DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(199) .minVlan(100) .build(), DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(399) .minVlan(300) .build()) .build()); } }
resources: vds: type: vsphere:DistributedVirtualSwitch properties: vlanRanges: - maxVlan: 199 minVlan: 100 - maxVlan: 399 minVlan: 300
- Vmotion
Maximum intMbit The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
- Vmotion
Reservation intMbit The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vmotion traffic class for a custom share level.
- string
The allocation level for the vmotion traffic class. Can be one of high, low, normal, or custom.
- Vsan
Maximum intMbit The maximum allowed usage for the vsan traffic class, in Mbits/sec.
- Vsan
Reservation intMbit The amount of guaranteed bandwidth for the vsan traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vsan traffic class for a custom share level.
- string
The allocation level for the vsan traffic class. Can be one of high, low, normal, or custom.
- Datacenter
Id string The ID of the datacenter where the VDS will be created. Forces a new resource if changed.
- Active
Uplinks []string A list of active uplinks to be used in load balancing. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- Allow
Forged boolTransmits Controls whether or not a virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
- Allow
Mac boolChanges Controls whether or not the Media Access Control (MAC) address can be changed.
- Allow
Promiscuous bool Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
- Backupnfc
Maximum intMbit The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
- Backupnfc
Reservation intMbit The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the backupNfc traffic class for a custom share level.
- string
The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
- Block
All boolPorts Shuts down all ports in the port groups that this policy applies to, effectively blocking all network access to connected virtual devices.
- Check
Beacon bool Enables beacon probing as an additional measure to detect NIC failure.
NOTE: VMware recommends using a minimum of 3 NICs when using beacon probing.
- Contact
Detail string The detailed contact information for the person who is responsible for the VDS.
- Contact
Name string The name of the person who is responsible for the VDS.
- Custom
Attributes map[string]string Map of custom attribute ids to attribute value strings to set for VDS.
NOTE: Custom attributes are unsupported on direct ESXi host connections and requires vCenter Server.
- Description string
A detailed description for the VDS.
- Directpath
Gen2Allowed bool Allow VMDirectPath Gen2 for the ports for which this policy applies to.
- Egress
Shaping intAverage Bandwidth The average bandwidth in bits per second if egress traffic shaping is enabled on the port.
- Egress
Shaping intBurst Size The maximum burst size allowed in bytes if egress traffic shaping is enabled on the port.
- Egress
Shaping boolEnabled true
if the traffic shaper is enabled on the port for egress traffic.- Egress
Shaping intPeak Bandwidth The peak bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
- Failback bool
If
true
, the teaming policy will re-activate failed uplinks higher in precedence when they come back up.- Faulttolerance
Maximum intMbit The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
- Faulttolerance
Reservation intMbit The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
- string
The allocation level for the faultTolerance traffic class. Can be one of high, low, normal, or custom.
- Folder string
The folder in which to create the VDS. Forces a new resource if changed.
- Hbr
Maximum intMbit The maximum allowed usage for the hbr traffic class, in Mbits/sec.
- Hbr
Reservation intMbit The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the hbr traffic class for a custom share level.
- string
The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
- Hosts
[]Distributed
Virtual Switch Host Args Use the
host
block to declare a host specification. The options are:- Ignore
Other boolPvlan Mappings Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
- Ingress
Shaping intAverage Bandwidth The average bandwidth in bits per second if ingress traffic shaping is enabled on the port.
- Ingress
Shaping intBurst Size The maximum burst size allowed in bytes if ingress traffic shaping is enabled on the port.
- Ingress
Shaping boolEnabled true
if the traffic shaper is enabled on the port for ingress traffic.- Ingress
Shaping intPeak Bandwidth The peak bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
- Ipv4Address string
An IPv4 address to identify the switch. This is mostly useful when used with the Netflow arguments.
- Iscsi
Maximum intMbit The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
- Iscsi
Reservation intMbit The amount of guaranteed bandwidth for the iSCSI traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the iSCSI traffic class for a custom share level.
- string
The allocation level for the iSCSI traffic class. Can be one of high, low, normal, or custom.
- Lacp
Api stringVersion The Link Aggregation Control Protocol group version to use with the VDS. Possible values are
singleLag
andmultipleLag
.- Lacp
Enabled bool Enables LACP for the ports that this policy applies to.
- Lacp
Mode string The LACP mode. Can be one of
active
orpassive
.- Link
Discovery stringOperation Whether to
advertise
orlisten
for link discovery traffic.- Link
Discovery stringProtocol The discovery protocol type. Valid types are
cdp
andlldp
.- Management
Maximum intMbit The maximum allowed usage for the management traffic class, in Mbits/sec.
- Management
Reservation intMbit The amount of guaranteed bandwidth for the management traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the management traffic class for a custom share level.
- string
The allocation level for the management traffic class. Can be one of high, low, normal, or custom.
- Max
Mtu int The maximum transmission unit (MTU) for the VDS.
- Multicast
Filtering stringMode The multicast filtering mode to use with the VDS. Can be one of
legacyFiltering
orsnooping
.- Name string
The name of the VDS.
- Netflow
Active intFlow Timeout The number of seconds after which active flows are forced to be exported to the collector. Allowed range is
60
to3600
. Default:60
.- Netflow
Collector stringIp Address IP address for the Netflow collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later. Must be set before Netflow can be enabled.
- Netflow
Collector intPort Port for the Netflow collector. This must be set before Netflow can be enabled.
- Netflow
Enabled bool Enables Netflow on all ports that this policy applies to.
- Netflow
Idle intFlow Timeout The number of seconds after which idle flows are forced to be exported to the collector. Allowed range is
10
to600
. Default:15
.- Netflow
Internal boolFlows Only Whether to limit analysis to traffic that has both source and destination served by the same host. Default:
false
.- Netflow
Observation intDomain Id The observation domain ID for the Netflow collector.
- Netflow
Sampling intRate The ratio of total number of packets to the number of packets analyzed. The default is
0
, which indicates that the VDS should analyze all packets. The maximum value is1000
, which indicates an analysis rate of 0.001%.- Network
Resource boolControl Enabled Set to
true
to enable network I/O control. Default:false
.- Network
Resource stringControl Version The version of network I/O control to use. Can be one of
version2
orversion3
. Default:version2
.- Nfs
Maximum intMbit The maximum allowed usage for the nfs traffic class, in Mbits/sec.
- Nfs
Reservation intMbit The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the nfs traffic class for a custom share level.
- string
The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
- Notify
Switches bool If
true
, the teaming policy will notify the broadcast network of an uplink failover, triggering cache updates.- Port
Private intSecondary Vlan Id Used to define a secondary VLAN ID when using private VLANs.
- Pvlan
Mappings []DistributedVirtual Switch Pvlan Mapping Args Use the
pvlan_mapping
block to declare a private VLAN mapping. The options are:- Standby
Uplinks []string A list of standby uplinks to be used in failover. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- []string
The IDs of any tags to attach to this resource.
NOTE: Tagging support requires vCenter Server 6.0 or higher.
- Teaming
Policy string The uplink teaming policy. Can be one of
loadbalance_ip
,loadbalance_srcmac
,loadbalance_srcid
,failover_explicit
, orloadbalance_loadbased
.- Tx
Uplink bool Forward all traffic transmitted by ports for which this policy applies to its VDS uplinks.
- Uplinks []string
A list of strings that uniquely identifies the names of the uplinks on the VDS across hosts. The number of items in this list controls the number of uplinks that exist on the VDS, in addition to the names. See here for an example on how to use this option.
- Vdp
Maximum intMbit The maximum allowed usage for the vdp traffic class, in Mbits/sec.
- Vdp
Reservation intMbit The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vdp traffic class for a custom share level.
- string
The allocation level for the vdp traffic class. Can be one of high, low, normal, or custom.
- Version string
The version of the VDS. BY default, a VDS is created at the latest version supported by the vSphere version if not specified. A VDS can be upgraded to a newer version, but can not be downgraded.
- Virtualmachine
Maximum intMbit The maximum allowed usage for the virtualMachine traffic class, in Mbits/sec.
- Virtualmachine
Reservation intMbit The amount of guaranteed bandwidth for the virtualMachine traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
- string
The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
- Vlan
Id int The VLAN ID for single VLAN mode. 0 denotes no VLAN.
- Vlan
Ranges []DistributedVirtual Switch Vlan Range Args Used to denote VLAN trunking. Use the
min_vlan
andmax_vlan
sub-arguments to define the tagged VLAN range. Multiplevlan_range
definitions are allowed, but they must not overlap. Example below:import * as pulumi from "@pulumi/pulumi"; import * as vsphere from "@pulumi/vsphere";
const vds = new vsphere.DistributedVirtualSwitch("vds", {vlanRanges: [ { maxVlan: 199, minVlan: 100, }, { maxVlan: 399, minVlan: 300, }, ]});
import pulumi import pulumi_vsphere as vsphere vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[ vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=199, min_vlan=100, ), vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=399, min_vlan=300, ), ])
using System.Collections.Generic; using System.Linq; using Pulumi; using VSphere = Pulumi.VSphere; return await Deployment.RunAsync(() => { var vds = new VSphere.DistributedVirtualSwitch("vds", new() { VlanRanges = new[] { new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 199, MinVlan = 100, }, new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 399, MinVlan = 300, }, }, }); });
package main import ( "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" "github.com/pulumi/pulumi/sdk/v3/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := vsphere.NewDistributedVirtualSwitch(ctx, "vds", &vsphere.DistributedVirtualSwitchArgs{ VlanRanges: vsphere.DistributedVirtualSwitchVlanRangeArray{ &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(199), MinVlan: pulumi.Int(100), }, &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(399), MinVlan: pulumi.Int(300), }, }, }) if err != nil { return err } return nil }) }
package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.vsphere.DistributedVirtualSwitch; import com.pulumi.vsphere.DistributedVirtualSwitchArgs; import com.pulumi.vsphere.inputs.DistributedVirtualSwitchVlanRangeArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var vds = new DistributedVirtualSwitch("vds", DistributedVirtualSwitchArgs.builder() .vlanRanges( DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(199) .minVlan(100) .build(), DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(399) .minVlan(300) .build()) .build()); } }
resources: vds: type: vsphere:DistributedVirtualSwitch properties: vlanRanges: - maxVlan: 199 minVlan: 100 - maxVlan: 399 minVlan: 300
- Vmotion
Maximum intMbit The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
- Vmotion
Reservation intMbit The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vmotion traffic class for a custom share level.
- string
The allocation level for the vmotion traffic class. Can be one of high, low, normal, or custom.
- Vsan
Maximum intMbit The maximum allowed usage for the vsan traffic class, in Mbits/sec.
- Vsan
Reservation intMbit The amount of guaranteed bandwidth for the vsan traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vsan traffic class for a custom share level.
- string
The allocation level for the vsan traffic class. Can be one of high, low, normal, or custom.
- datacenter
Id String The ID of the datacenter where the VDS will be created. Forces a new resource if changed.
- active
Uplinks List<String> A list of active uplinks to be used in load balancing. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- allow
Forged BooleanTransmits Controls whether or not a virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
- allow
Mac BooleanChanges Controls whether or not the Media Access Control (MAC) address can be changed.
- allow
Promiscuous Boolean Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
- backupnfc
Maximum IntegerMbit The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
- backupnfc
Reservation IntegerMbit The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the backupNfc traffic class for a custom share level.
- String
The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
- block
All BooleanPorts Shuts down all ports in the port groups that this policy applies to, effectively blocking all network access to connected virtual devices.
- check
Beacon Boolean Enables beacon probing as an additional measure to detect NIC failure.
NOTE: VMware recommends using a minimum of 3 NICs when using beacon probing.
- contact
Detail String The detailed contact information for the person who is responsible for the VDS.
- contact
Name String The name of the person who is responsible for the VDS.
- custom
Attributes Map<String,String> Map of custom attribute ids to attribute value strings to set for VDS.
NOTE: Custom attributes are unsupported on direct ESXi host connections and requires vCenter Server.
- description String
A detailed description for the VDS.
- directpath
Gen2Allowed Boolean Allow VMDirectPath Gen2 for the ports for which this policy applies to.
- egress
Shaping IntegerAverage Bandwidth The average bandwidth in bits per second if egress traffic shaping is enabled on the port.
- egress
Shaping IntegerBurst Size The maximum burst size allowed in bytes if egress traffic shaping is enabled on the port.
- egress
Shaping BooleanEnabled true
if the traffic shaper is enabled on the port for egress traffic.- egress
Shaping IntegerPeak Bandwidth The peak bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
- failback Boolean
If
true
, the teaming policy will re-activate failed uplinks higher in precedence when they come back up.- faulttolerance
Maximum IntegerMbit The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
- faulttolerance
Reservation IntegerMbit The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
- String
The allocation level for the faultTolerance traffic class. Can be one of high, low, normal, or custom.
- folder String
The folder in which to create the VDS. Forces a new resource if changed.
- hbr
Maximum IntegerMbit The maximum allowed usage for the hbr traffic class, in Mbits/sec.
- hbr
Reservation IntegerMbit The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the hbr traffic class for a custom share level.
- String
The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
- hosts
List<Distributed
Virtual Switch Host> Use the
host
block to declare a host specification. The options are:- ignore
Other BooleanPvlan Mappings Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
- ingress
Shaping IntegerAverage Bandwidth The average bandwidth in bits per second if ingress traffic shaping is enabled on the port.
- ingress
Shaping IntegerBurst Size The maximum burst size allowed in bytes if ingress traffic shaping is enabled on the port.
- ingress
Shaping BooleanEnabled true
if the traffic shaper is enabled on the port for ingress traffic.- ingress
Shaping IntegerPeak Bandwidth The peak bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
- ipv4Address String
An IPv4 address to identify the switch. This is mostly useful when used with the Netflow arguments.
- iscsi
Maximum IntegerMbit The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
- iscsi
Reservation IntegerMbit The amount of guaranteed bandwidth for the iSCSI traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the iSCSI traffic class for a custom share level.
- String
The allocation level for the iSCSI traffic class. Can be one of high, low, normal, or custom.
- lacp
Api StringVersion The Link Aggregation Control Protocol group version to use with the VDS. Possible values are
singleLag
andmultipleLag
.- lacp
Enabled Boolean Enables LACP for the ports that this policy applies to.
- lacp
Mode String The LACP mode. Can be one of
active
orpassive
.- link
Discovery StringOperation Whether to
advertise
orlisten
for link discovery traffic.- link
Discovery StringProtocol The discovery protocol type. Valid types are
cdp
andlldp
.- management
Maximum IntegerMbit The maximum allowed usage for the management traffic class, in Mbits/sec.
- management
Reservation IntegerMbit The amount of guaranteed bandwidth for the management traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the management traffic class for a custom share level.
- String
The allocation level for the management traffic class. Can be one of high, low, normal, or custom.
- max
Mtu Integer The maximum transmission unit (MTU) for the VDS.
- multicast
Filtering StringMode The multicast filtering mode to use with the VDS. Can be one of
legacyFiltering
orsnooping
.- name String
The name of the VDS.
- netflow
Active IntegerFlow Timeout The number of seconds after which active flows are forced to be exported to the collector. Allowed range is
60
to3600
. Default:60
.- netflow
Collector StringIp Address IP address for the Netflow collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later. Must be set before Netflow can be enabled.
- netflow
Collector IntegerPort Port for the Netflow collector. This must be set before Netflow can be enabled.
- netflow
Enabled Boolean Enables Netflow on all ports that this policy applies to.
- netflow
Idle IntegerFlow Timeout The number of seconds after which idle flows are forced to be exported to the collector. Allowed range is
10
to600
. Default:15
.- netflow
Internal BooleanFlows Only Whether to limit analysis to traffic that has both source and destination served by the same host. Default:
false
.- netflow
Observation IntegerDomain Id The observation domain ID for the Netflow collector.
- netflow
Sampling IntegerRate The ratio of total number of packets to the number of packets analyzed. The default is
0
, which indicates that the VDS should analyze all packets. The maximum value is1000
, which indicates an analysis rate of 0.001%.- network
Resource BooleanControl Enabled Set to
true
to enable network I/O control. Default:false
.- network
Resource StringControl Version The version of network I/O control to use. Can be one of
version2
orversion3
. Default:version2
.- nfs
Maximum IntegerMbit The maximum allowed usage for the nfs traffic class, in Mbits/sec.
- nfs
Reservation IntegerMbit The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the nfs traffic class for a custom share level.
- String
The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
- notify
Switches Boolean If
true
, the teaming policy will notify the broadcast network of an uplink failover, triggering cache updates.- port
Private IntegerSecondary Vlan Id Used to define a secondary VLAN ID when using private VLANs.
- pvlan
Mappings List<DistributedVirtual Switch Pvlan Mapping> Use the
pvlan_mapping
block to declare a private VLAN mapping. The options are:- standby
Uplinks List<String> A list of standby uplinks to be used in failover. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- List<String>
The IDs of any tags to attach to this resource.
NOTE: Tagging support requires vCenter Server 6.0 or higher.
- teaming
Policy String The uplink teaming policy. Can be one of
loadbalance_ip
,loadbalance_srcmac
,loadbalance_srcid
,failover_explicit
, orloadbalance_loadbased
.- tx
Uplink Boolean Forward all traffic transmitted by ports for which this policy applies to its VDS uplinks.
- uplinks List<String>
A list of strings that uniquely identifies the names of the uplinks on the VDS across hosts. The number of items in this list controls the number of uplinks that exist on the VDS, in addition to the names. See here for an example on how to use this option.
- vdp
Maximum IntegerMbit The maximum allowed usage for the vdp traffic class, in Mbits/sec.
- vdp
Reservation IntegerMbit The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the vdp traffic class for a custom share level.
- String
The allocation level for the vdp traffic class. Can be one of high, low, normal, or custom.
- version String
The version of the VDS. BY default, a VDS is created at the latest version supported by the vSphere version if not specified. A VDS can be upgraded to a newer version, but can not be downgraded.
- virtualmachine
Maximum IntegerMbit The maximum allowed usage for the virtualMachine traffic class, in Mbits/sec.
- virtualmachine
Reservation IntegerMbit The amount of guaranteed bandwidth for the virtualMachine traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
- String
The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
- vlan
Id Integer The VLAN ID for single VLAN mode. 0 denotes no VLAN.
- vlan
Ranges List<DistributedVirtual Switch Vlan Range> Used to denote VLAN trunking. Use the
min_vlan
andmax_vlan
sub-arguments to define the tagged VLAN range. Multiplevlan_range
definitions are allowed, but they must not overlap. Example below:import * as pulumi from "@pulumi/pulumi"; import * as vsphere from "@pulumi/vsphere";
const vds = new vsphere.DistributedVirtualSwitch("vds", {vlanRanges: [ { maxVlan: 199, minVlan: 100, }, { maxVlan: 399, minVlan: 300, }, ]});
import pulumi import pulumi_vsphere as vsphere vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[ vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=199, min_vlan=100, ), vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=399, min_vlan=300, ), ])
using System.Collections.Generic; using System.Linq; using Pulumi; using VSphere = Pulumi.VSphere; return await Deployment.RunAsync(() => { var vds = new VSphere.DistributedVirtualSwitch("vds", new() { VlanRanges = new[] { new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 199, MinVlan = 100, }, new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 399, MinVlan = 300, }, }, }); });
package main import ( "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" "github.com/pulumi/pulumi/sdk/v3/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := vsphere.NewDistributedVirtualSwitch(ctx, "vds", &vsphere.DistributedVirtualSwitchArgs{ VlanRanges: vsphere.DistributedVirtualSwitchVlanRangeArray{ &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(199), MinVlan: pulumi.Int(100), }, &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(399), MinVlan: pulumi.Int(300), }, }, }) if err != nil { return err } return nil }) }
package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.vsphere.DistributedVirtualSwitch; import com.pulumi.vsphere.DistributedVirtualSwitchArgs; import com.pulumi.vsphere.inputs.DistributedVirtualSwitchVlanRangeArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var vds = new DistributedVirtualSwitch("vds", DistributedVirtualSwitchArgs.builder() .vlanRanges( DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(199) .minVlan(100) .build(), DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(399) .minVlan(300) .build()) .build()); } }
resources: vds: type: vsphere:DistributedVirtualSwitch properties: vlanRanges: - maxVlan: 199 minVlan: 100 - maxVlan: 399 minVlan: 300
- vmotion
Maximum IntegerMbit The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
- vmotion
Reservation IntegerMbit The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the vmotion traffic class for a custom share level.
- String
The allocation level for the vmotion traffic class. Can be one of high, low, normal, or custom.
- vsan
Maximum IntegerMbit The maximum allowed usage for the vsan traffic class, in Mbits/sec.
- vsan
Reservation IntegerMbit The amount of guaranteed bandwidth for the vsan traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the vsan traffic class for a custom share level.
- String
The allocation level for the vsan traffic class. Can be one of high, low, normal, or custom.
- datacenter
Id string The ID of the datacenter where the VDS will be created. Forces a new resource if changed.
- active
Uplinks string[] A list of active uplinks to be used in load balancing. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- allow
Forged booleanTransmits Controls whether or not a virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
- allow
Mac booleanChanges Controls whether or not the Media Access Control (MAC) address can be changed.
- allow
Promiscuous boolean Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
- backupnfc
Maximum numberMbit The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
- backupnfc
Reservation numberMbit The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the backupNfc traffic class for a custom share level.
- string
The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
- block
All booleanPorts Shuts down all ports in the port groups that this policy applies to, effectively blocking all network access to connected virtual devices.
- check
Beacon boolean Enables beacon probing as an additional measure to detect NIC failure.
NOTE: VMware recommends using a minimum of 3 NICs when using beacon probing.
- contact
Detail string The detailed contact information for the person who is responsible for the VDS.
- contact
Name string The name of the person who is responsible for the VDS.
- custom
Attributes {[key: string]: string} Map of custom attribute ids to attribute value strings to set for VDS.
NOTE: Custom attributes are unsupported on direct ESXi host connections and requires vCenter Server.
- description string
A detailed description for the VDS.
- directpath
Gen2Allowed boolean Allow VMDirectPath Gen2 for the ports for which this policy applies to.
- egress
Shaping numberAverage Bandwidth The average bandwidth in bits per second if egress traffic shaping is enabled on the port.
- egress
Shaping numberBurst Size The maximum burst size allowed in bytes if egress traffic shaping is enabled on the port.
- egress
Shaping booleanEnabled true
if the traffic shaper is enabled on the port for egress traffic.- egress
Shaping numberPeak Bandwidth The peak bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
- failback boolean
If
true
, the teaming policy will re-activate failed uplinks higher in precedence when they come back up.- faulttolerance
Maximum numberMbit The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
- faulttolerance
Reservation numberMbit The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
- string
The allocation level for the faultTolerance traffic class. Can be one of high, low, normal, or custom.
- folder string
The folder in which to create the VDS. Forces a new resource if changed.
- hbr
Maximum numberMbit The maximum allowed usage for the hbr traffic class, in Mbits/sec.
- hbr
Reservation numberMbit The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the hbr traffic class for a custom share level.
- string
The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
- hosts
Distributed
Virtual Switch Host[] Use the
host
block to declare a host specification. The options are:- ignore
Other booleanPvlan Mappings Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
- ingress
Shaping numberAverage Bandwidth The average bandwidth in bits per second if ingress traffic shaping is enabled on the port.
- ingress
Shaping numberBurst Size The maximum burst size allowed in bytes if ingress traffic shaping is enabled on the port.
- ingress
Shaping booleanEnabled true
if the traffic shaper is enabled on the port for ingress traffic.- ingress
Shaping numberPeak Bandwidth The peak bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
- ipv4Address string
An IPv4 address to identify the switch. This is mostly useful when used with the Netflow arguments.
- iscsi
Maximum numberMbit The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
- iscsi
Reservation numberMbit The amount of guaranteed bandwidth for the iSCSI traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the iSCSI traffic class for a custom share level.
- string
The allocation level for the iSCSI traffic class. Can be one of high, low, normal, or custom.
- lacp
Api stringVersion The Link Aggregation Control Protocol group version to use with the VDS. Possible values are
singleLag
andmultipleLag
.- lacp
Enabled boolean Enables LACP for the ports that this policy applies to.
- lacp
Mode string The LACP mode. Can be one of
active
orpassive
.- link
Discovery stringOperation Whether to
advertise
orlisten
for link discovery traffic.- link
Discovery stringProtocol The discovery protocol type. Valid types are
cdp
andlldp
.- management
Maximum numberMbit The maximum allowed usage for the management traffic class, in Mbits/sec.
- management
Reservation numberMbit The amount of guaranteed bandwidth for the management traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the management traffic class for a custom share level.
- string
The allocation level for the management traffic class. Can be one of high, low, normal, or custom.
- max
Mtu number The maximum transmission unit (MTU) for the VDS.
- multicast
Filtering stringMode The multicast filtering mode to use with the VDS. Can be one of
legacyFiltering
orsnooping
.- name string
The name of the VDS.
- netflow
Active numberFlow Timeout The number of seconds after which active flows are forced to be exported to the collector. Allowed range is
60
to3600
. Default:60
.- netflow
Collector stringIp Address IP address for the Netflow collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later. Must be set before Netflow can be enabled.
- netflow
Collector numberPort Port for the Netflow collector. This must be set before Netflow can be enabled.
- netflow
Enabled boolean Enables Netflow on all ports that this policy applies to.
- netflow
Idle numberFlow Timeout The number of seconds after which idle flows are forced to be exported to the collector. Allowed range is
10
to600
. Default:15
.- netflow
Internal booleanFlows Only Whether to limit analysis to traffic that has both source and destination served by the same host. Default:
false
.- netflow
Observation numberDomain Id The observation domain ID for the Netflow collector.
- netflow
Sampling numberRate The ratio of total number of packets to the number of packets analyzed. The default is
0
, which indicates that the VDS should analyze all packets. The maximum value is1000
, which indicates an analysis rate of 0.001%.- network
Resource booleanControl Enabled Set to
true
to enable network I/O control. Default:false
.- network
Resource stringControl Version The version of network I/O control to use. Can be one of
version2
orversion3
. Default:version2
.- nfs
Maximum numberMbit The maximum allowed usage for the nfs traffic class, in Mbits/sec.
- nfs
Reservation numberMbit The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the nfs traffic class for a custom share level.
- string
The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
- notify
Switches boolean If
true
, the teaming policy will notify the broadcast network of an uplink failover, triggering cache updates.- port
Private numberSecondary Vlan Id Used to define a secondary VLAN ID when using private VLANs.
- pvlan
Mappings DistributedVirtual Switch Pvlan Mapping[] Use the
pvlan_mapping
block to declare a private VLAN mapping. The options are:- standby
Uplinks string[] A list of standby uplinks to be used in failover. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- string[]
The IDs of any tags to attach to this resource.
NOTE: Tagging support requires vCenter Server 6.0 or higher.
- teaming
Policy string The uplink teaming policy. Can be one of
loadbalance_ip
,loadbalance_srcmac
,loadbalance_srcid
,failover_explicit
, orloadbalance_loadbased
.- tx
Uplink boolean Forward all traffic transmitted by ports for which this policy applies to its VDS uplinks.
- uplinks string[]
A list of strings that uniquely identifies the names of the uplinks on the VDS across hosts. The number of items in this list controls the number of uplinks that exist on the VDS, in addition to the names. See here for an example on how to use this option.
- vdp
Maximum numberMbit The maximum allowed usage for the vdp traffic class, in Mbits/sec.
- vdp
Reservation numberMbit The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the vdp traffic class for a custom share level.
- string
The allocation level for the vdp traffic class. Can be one of high, low, normal, or custom.
- version string
The version of the VDS. BY default, a VDS is created at the latest version supported by the vSphere version if not specified. A VDS can be upgraded to a newer version, but can not be downgraded.
- virtualmachine
Maximum numberMbit The maximum allowed usage for the virtualMachine traffic class, in Mbits/sec.
- virtualmachine
Reservation numberMbit The amount of guaranteed bandwidth for the virtualMachine traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
- string
The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
- vlan
Id number The VLAN ID for single VLAN mode. 0 denotes no VLAN.
- vlan
Ranges DistributedVirtual Switch Vlan Range[] Used to denote VLAN trunking. Use the
min_vlan
andmax_vlan
sub-arguments to define the tagged VLAN range. Multiplevlan_range
definitions are allowed, but they must not overlap. Example below:import * as pulumi from "@pulumi/pulumi"; import * as vsphere from "@pulumi/vsphere";
const vds = new vsphere.DistributedVirtualSwitch("vds", {vlanRanges: [ { maxVlan: 199, minVlan: 100, }, { maxVlan: 399, minVlan: 300, }, ]});
import pulumi import pulumi_vsphere as vsphere vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[ vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=199, min_vlan=100, ), vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=399, min_vlan=300, ), ])
using System.Collections.Generic; using System.Linq; using Pulumi; using VSphere = Pulumi.VSphere; return await Deployment.RunAsync(() => { var vds = new VSphere.DistributedVirtualSwitch("vds", new() { VlanRanges = new[] { new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 199, MinVlan = 100, }, new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 399, MinVlan = 300, }, }, }); });
package main import ( "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" "github.com/pulumi/pulumi/sdk/v3/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := vsphere.NewDistributedVirtualSwitch(ctx, "vds", &vsphere.DistributedVirtualSwitchArgs{ VlanRanges: vsphere.DistributedVirtualSwitchVlanRangeArray{ &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(199), MinVlan: pulumi.Int(100), }, &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(399), MinVlan: pulumi.Int(300), }, }, }) if err != nil { return err } return nil }) }
package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.vsphere.DistributedVirtualSwitch; import com.pulumi.vsphere.DistributedVirtualSwitchArgs; import com.pulumi.vsphere.inputs.DistributedVirtualSwitchVlanRangeArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var vds = new DistributedVirtualSwitch("vds", DistributedVirtualSwitchArgs.builder() .vlanRanges( DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(199) .minVlan(100) .build(), DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(399) .minVlan(300) .build()) .build()); } }
resources: vds: type: vsphere:DistributedVirtualSwitch properties: vlanRanges: - maxVlan: 199 minVlan: 100 - maxVlan: 399 minVlan: 300
- vmotion
Maximum numberMbit The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
- vmotion
Reservation numberMbit The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the vmotion traffic class for a custom share level.
- string
The allocation level for the vmotion traffic class. Can be one of high, low, normal, or custom.
- vsan
Maximum numberMbit The maximum allowed usage for the vsan traffic class, in Mbits/sec.
- vsan
Reservation numberMbit The amount of guaranteed bandwidth for the vsan traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the vsan traffic class for a custom share level.
- string
The allocation level for the vsan traffic class. Can be one of high, low, normal, or custom.
- datacenter_
id str The ID of the datacenter where the VDS will be created. Forces a new resource if changed.
- active_
uplinks Sequence[str] A list of active uplinks to be used in load balancing. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- allow_
forged_ booltransmits Controls whether or not a virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
- allow_
mac_ boolchanges Controls whether or not the Media Access Control (MAC) address can be changed.
- allow_
promiscuous bool Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
- backupnfc_
maximum_ intmbit The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
- backupnfc_
reservation_ intmbit The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the backupNfc traffic class for a custom share level.
- str
The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
- block_
all_ boolports Shuts down all ports in the port groups that this policy applies to, effectively blocking all network access to connected virtual devices.
- check_
beacon bool Enables beacon probing as an additional measure to detect NIC failure.
NOTE: VMware recommends using a minimum of 3 NICs when using beacon probing.
- contact_
detail str The detailed contact information for the person who is responsible for the VDS.
- contact_
name str The name of the person who is responsible for the VDS.
- custom_
attributes Mapping[str, str] Map of custom attribute ids to attribute value strings to set for VDS.
NOTE: Custom attributes are unsupported on direct ESXi host connections and requires vCenter Server.
- description str
A detailed description for the VDS.
- directpath_
gen2_ boolallowed Allow VMDirectPath Gen2 for the ports for which this policy applies to.
- egress_
shaping_ intaverage_ bandwidth The average bandwidth in bits per second if egress traffic shaping is enabled on the port.
- egress_
shaping_ intburst_ size The maximum burst size allowed in bytes if egress traffic shaping is enabled on the port.
- egress_
shaping_ boolenabled true
if the traffic shaper is enabled on the port for egress traffic.- egress_
shaping_ intpeak_ bandwidth The peak bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
- failback bool
If
true
, the teaming policy will re-activate failed uplinks higher in precedence when they come back up.- faulttolerance_
maximum_ intmbit The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
- faulttolerance_
reservation_ intmbit The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
- str
The allocation level for the faultTolerance traffic class. Can be one of high, low, normal, or custom.
- folder str
The folder in which to create the VDS. Forces a new resource if changed.
- hbr_
maximum_ intmbit The maximum allowed usage for the hbr traffic class, in Mbits/sec.
- hbr_
reservation_ intmbit The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the hbr traffic class for a custom share level.
- str
The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
- hosts
Sequence[Distributed
Virtual Switch Host Args] Use the
host
block to declare a host specification. The options are:- ignore_
other_ boolpvlan_ mappings Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
- ingress_
shaping_ intaverage_ bandwidth The average bandwidth in bits per second if ingress traffic shaping is enabled on the port.
- ingress_
shaping_ intburst_ size The maximum burst size allowed in bytes if ingress traffic shaping is enabled on the port.
- ingress_
shaping_ boolenabled true
if the traffic shaper is enabled on the port for ingress traffic.- ingress_
shaping_ intpeak_ bandwidth The peak bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
- ipv4_
address str An IPv4 address to identify the switch. This is mostly useful when used with the Netflow arguments.
- iscsi_
maximum_ intmbit The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
- iscsi_
reservation_ intmbit The amount of guaranteed bandwidth for the iSCSI traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the iSCSI traffic class for a custom share level.
- str
The allocation level for the iSCSI traffic class. Can be one of high, low, normal, or custom.
- lacp_
api_ strversion The Link Aggregation Control Protocol group version to use with the VDS. Possible values are
singleLag
andmultipleLag
.- lacp_
enabled bool Enables LACP for the ports that this policy applies to.
- lacp_
mode str The LACP mode. Can be one of
active
orpassive
.- link_
discovery_ stroperation Whether to
advertise
orlisten
for link discovery traffic.- link_
discovery_ strprotocol The discovery protocol type. Valid types are
cdp
andlldp
.- management_
maximum_ intmbit The maximum allowed usage for the management traffic class, in Mbits/sec.
- management_
reservation_ intmbit The amount of guaranteed bandwidth for the management traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the management traffic class for a custom share level.
- str
The allocation level for the management traffic class. Can be one of high, low, normal, or custom.
- max_
mtu int The maximum transmission unit (MTU) for the VDS.
- multicast_
filtering_ strmode The multicast filtering mode to use with the VDS. Can be one of
legacyFiltering
orsnooping
.- name str
The name of the VDS.
- netflow_
active_ intflow_ timeout The number of seconds after which active flows are forced to be exported to the collector. Allowed range is
60
to3600
. Default:60
.- netflow_
collector_ strip_ address IP address for the Netflow collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later. Must be set before Netflow can be enabled.
- netflow_
collector_ intport Port for the Netflow collector. This must be set before Netflow can be enabled.
- netflow_
enabled bool Enables Netflow on all ports that this policy applies to.
- netflow_
idle_ intflow_ timeout The number of seconds after which idle flows are forced to be exported to the collector. Allowed range is
10
to600
. Default:15
.- netflow_
internal_ boolflows_ only Whether to limit analysis to traffic that has both source and destination served by the same host. Default:
false
.- netflow_
observation_ intdomain_ id The observation domain ID for the Netflow collector.
- netflow_
sampling_ intrate The ratio of total number of packets to the number of packets analyzed. The default is
0
, which indicates that the VDS should analyze all packets. The maximum value is1000
, which indicates an analysis rate of 0.001%.- network_
resource_ boolcontrol_ enabled Set to
true
to enable network I/O control. Default:false
.- network_
resource_ strcontrol_ version The version of network I/O control to use. Can be one of
version2
orversion3
. Default:version2
.- nfs_
maximum_ intmbit The maximum allowed usage for the nfs traffic class, in Mbits/sec.
- nfs_
reservation_ intmbit The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the nfs traffic class for a custom share level.
- str
The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
- notify_
switches bool If
true
, the teaming policy will notify the broadcast network of an uplink failover, triggering cache updates.- port_
private_ intsecondary_ vlan_ id Used to define a secondary VLAN ID when using private VLANs.
- pvlan_
mappings Sequence[DistributedVirtual Switch Pvlan Mapping Args] Use the
pvlan_mapping
block to declare a private VLAN mapping. The options are:- standby_
uplinks Sequence[str] A list of standby uplinks to be used in failover. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- Sequence[str]
The IDs of any tags to attach to this resource.
NOTE: Tagging support requires vCenter Server 6.0 or higher.
- teaming_
policy str The uplink teaming policy. Can be one of
loadbalance_ip
,loadbalance_srcmac
,loadbalance_srcid
,failover_explicit
, orloadbalance_loadbased
.- tx_
uplink bool Forward all traffic transmitted by ports for which this policy applies to its VDS uplinks.
- uplinks Sequence[str]
A list of strings that uniquely identifies the names of the uplinks on the VDS across hosts. The number of items in this list controls the number of uplinks that exist on the VDS, in addition to the names. See here for an example on how to use this option.
- vdp_
maximum_ intmbit The maximum allowed usage for the vdp traffic class, in Mbits/sec.
- vdp_
reservation_ intmbit The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vdp traffic class for a custom share level.
- str
The allocation level for the vdp traffic class. Can be one of high, low, normal, or custom.
- version str
The version of the VDS. BY default, a VDS is created at the latest version supported by the vSphere version if not specified. A VDS can be upgraded to a newer version, but can not be downgraded.
- virtualmachine_
maximum_ intmbit The maximum allowed usage for the virtualMachine traffic class, in Mbits/sec.
- virtualmachine_
reservation_ intmbit The amount of guaranteed bandwidth for the virtualMachine traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
- str
The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
- vlan_
id int The VLAN ID for single VLAN mode. 0 denotes no VLAN.
- vlan_
ranges Sequence[DistributedVirtual Switch Vlan Range Args] Used to denote VLAN trunking. Use the
min_vlan
andmax_vlan
sub-arguments to define the tagged VLAN range. Multiplevlan_range
definitions are allowed, but they must not overlap. Example below:import * as pulumi from "@pulumi/pulumi"; import * as vsphere from "@pulumi/vsphere";
const vds = new vsphere.DistributedVirtualSwitch("vds", {vlanRanges: [ { maxVlan: 199, minVlan: 100, }, { maxVlan: 399, minVlan: 300, }, ]});
import pulumi import pulumi_vsphere as vsphere vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[ vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=199, min_vlan=100, ), vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=399, min_vlan=300, ), ])
using System.Collections.Generic; using System.Linq; using Pulumi; using VSphere = Pulumi.VSphere; return await Deployment.RunAsync(() => { var vds = new VSphere.DistributedVirtualSwitch("vds", new() { VlanRanges = new[] { new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 199, MinVlan = 100, }, new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 399, MinVlan = 300, }, }, }); });
package main import ( "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" "github.com/pulumi/pulumi/sdk/v3/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := vsphere.NewDistributedVirtualSwitch(ctx, "vds", &vsphere.DistributedVirtualSwitchArgs{ VlanRanges: vsphere.DistributedVirtualSwitchVlanRangeArray{ &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(199), MinVlan: pulumi.Int(100), }, &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(399), MinVlan: pulumi.Int(300), }, }, }) if err != nil { return err } return nil }) }
package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.vsphere.DistributedVirtualSwitch; import com.pulumi.vsphere.DistributedVirtualSwitchArgs; import com.pulumi.vsphere.inputs.DistributedVirtualSwitchVlanRangeArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var vds = new DistributedVirtualSwitch("vds", DistributedVirtualSwitchArgs.builder() .vlanRanges( DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(199) .minVlan(100) .build(), DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(399) .minVlan(300) .build()) .build()); } }
resources: vds: type: vsphere:DistributedVirtualSwitch properties: vlanRanges: - maxVlan: 199 minVlan: 100 - maxVlan: 399 minVlan: 300
- vmotion_
maximum_ intmbit The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
- vmotion_
reservation_ intmbit The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vmotion traffic class for a custom share level.
- str
The allocation level for the vmotion traffic class. Can be one of high, low, normal, or custom.
- vsan_
maximum_ intmbit The maximum allowed usage for the vsan traffic class, in Mbits/sec.
- vsan_
reservation_ intmbit The amount of guaranteed bandwidth for the vsan traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vsan traffic class for a custom share level.
- str
The allocation level for the vsan traffic class. Can be one of high, low, normal, or custom.
- datacenter
Id String The ID of the datacenter where the VDS will be created. Forces a new resource if changed.
- active
Uplinks List<String> A list of active uplinks to be used in load balancing. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- allow
Forged BooleanTransmits Controls whether or not a virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
- allow
Mac BooleanChanges Controls whether or not the Media Access Control (MAC) address can be changed.
- allow
Promiscuous Boolean Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
- backupnfc
Maximum NumberMbit The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
- backupnfc
Reservation NumberMbit The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the backupNfc traffic class for a custom share level.
- String
The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
- block
All BooleanPorts Shuts down all ports in the port groups that this policy applies to, effectively blocking all network access to connected virtual devices.
- check
Beacon Boolean Enables beacon probing as an additional measure to detect NIC failure.
NOTE: VMware recommends using a minimum of 3 NICs when using beacon probing.
- contact
Detail String The detailed contact information for the person who is responsible for the VDS.
- contact
Name String The name of the person who is responsible for the VDS.
- custom
Attributes Map<String> Map of custom attribute ids to attribute value strings to set for VDS.
NOTE: Custom attributes are unsupported on direct ESXi host connections and requires vCenter Server.
- description String
A detailed description for the VDS.
- directpath
Gen2Allowed Boolean Allow VMDirectPath Gen2 for the ports for which this policy applies to.
- egress
Shaping NumberAverage Bandwidth The average bandwidth in bits per second if egress traffic shaping is enabled on the port.
- egress
Shaping NumberBurst Size The maximum burst size allowed in bytes if egress traffic shaping is enabled on the port.
- egress
Shaping BooleanEnabled true
if the traffic shaper is enabled on the port for egress traffic.- egress
Shaping NumberPeak Bandwidth The peak bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
- failback Boolean
If
true
, the teaming policy will re-activate failed uplinks higher in precedence when they come back up.- faulttolerance
Maximum NumberMbit The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
- faulttolerance
Reservation NumberMbit The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
- String
The allocation level for the faultTolerance traffic class. Can be one of high, low, normal, or custom.
- folder String
The folder in which to create the VDS. Forces a new resource if changed.
- hbr
Maximum NumberMbit The maximum allowed usage for the hbr traffic class, in Mbits/sec.
- hbr
Reservation NumberMbit The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the hbr traffic class for a custom share level.
- String
The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
- hosts List<Property Map>
Use the
host
block to declare a host specification. The options are:- ignore
Other BooleanPvlan Mappings Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
- ingress
Shaping NumberAverage Bandwidth The average bandwidth in bits per second if ingress traffic shaping is enabled on the port.
- ingress
Shaping NumberBurst Size The maximum burst size allowed in bytes if ingress traffic shaping is enabled on the port.
- ingress
Shaping BooleanEnabled true
if the traffic shaper is enabled on the port for ingress traffic.- ingress
Shaping NumberPeak Bandwidth The peak bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
- ipv4Address String
An IPv4 address to identify the switch. This is mostly useful when used with the Netflow arguments.
- iscsi
Maximum NumberMbit The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
- iscsi
Reservation NumberMbit The amount of guaranteed bandwidth for the iSCSI traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the iSCSI traffic class for a custom share level.
- String
The allocation level for the iSCSI traffic class. Can be one of high, low, normal, or custom.
- lacp
Api StringVersion The Link Aggregation Control Protocol group version to use with the VDS. Possible values are
singleLag
andmultipleLag
.- lacp
Enabled Boolean Enables LACP for the ports that this policy applies to.
- lacp
Mode String The LACP mode. Can be one of
active
orpassive
.- link
Discovery StringOperation Whether to
advertise
orlisten
for link discovery traffic.- link
Discovery StringProtocol The discovery protocol type. Valid types are
cdp
andlldp
.- management
Maximum NumberMbit The maximum allowed usage for the management traffic class, in Mbits/sec.
- management
Reservation NumberMbit The amount of guaranteed bandwidth for the management traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the management traffic class for a custom share level.
- String
The allocation level for the management traffic class. Can be one of high, low, normal, or custom.
- max
Mtu Number The maximum transmission unit (MTU) for the VDS.
- multicast
Filtering StringMode The multicast filtering mode to use with the VDS. Can be one of
legacyFiltering
orsnooping
.- name String
The name of the VDS.
- netflow
Active NumberFlow Timeout The number of seconds after which active flows are forced to be exported to the collector. Allowed range is
60
to3600
. Default:60
.- netflow
Collector StringIp Address IP address for the Netflow collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later. Must be set before Netflow can be enabled.
- netflow
Collector NumberPort Port for the Netflow collector. This must be set before Netflow can be enabled.
- netflow
Enabled Boolean Enables Netflow on all ports that this policy applies to.
- netflow
Idle NumberFlow Timeout The number of seconds after which idle flows are forced to be exported to the collector. Allowed range is
10
to600
. Default:15
.- netflow
Internal BooleanFlows Only Whether to limit analysis to traffic that has both source and destination served by the same host. Default:
false
.- netflow
Observation NumberDomain Id The observation domain ID for the Netflow collector.
- netflow
Sampling NumberRate The ratio of total number of packets to the number of packets analyzed. The default is
0
, which indicates that the VDS should analyze all packets. The maximum value is1000
, which indicates an analysis rate of 0.001%.- network
Resource BooleanControl Enabled Set to
true
to enable network I/O control. Default:false
.- network
Resource StringControl Version The version of network I/O control to use. Can be one of
version2
orversion3
. Default:version2
.- nfs
Maximum NumberMbit The maximum allowed usage for the nfs traffic class, in Mbits/sec.
- nfs
Reservation NumberMbit The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the nfs traffic class for a custom share level.
- String
The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
- notify
Switches Boolean If
true
, the teaming policy will notify the broadcast network of an uplink failover, triggering cache updates.- port
Private NumberSecondary Vlan Id Used to define a secondary VLAN ID when using private VLANs.
- pvlan
Mappings List<Property Map> Use the
pvlan_mapping
block to declare a private VLAN mapping. The options are:- standby
Uplinks List<String> A list of standby uplinks to be used in failover. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- List<String>
The IDs of any tags to attach to this resource.
NOTE: Tagging support requires vCenter Server 6.0 or higher.
- teaming
Policy String The uplink teaming policy. Can be one of
loadbalance_ip
,loadbalance_srcmac
,loadbalance_srcid
,failover_explicit
, orloadbalance_loadbased
.- tx
Uplink Boolean Forward all traffic transmitted by ports for which this policy applies to its VDS uplinks.
- uplinks List<String>
A list of strings that uniquely identifies the names of the uplinks on the VDS across hosts. The number of items in this list controls the number of uplinks that exist on the VDS, in addition to the names. See here for an example on how to use this option.
- vdp
Maximum NumberMbit The maximum allowed usage for the vdp traffic class, in Mbits/sec.
- vdp
Reservation NumberMbit The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the vdp traffic class for a custom share level.
- String
The allocation level for the vdp traffic class. Can be one of high, low, normal, or custom.
- version String
The version of the VDS. BY default, a VDS is created at the latest version supported by the vSphere version if not specified. A VDS can be upgraded to a newer version, but can not be downgraded.
- virtualmachine
Maximum NumberMbit The maximum allowed usage for the virtualMachine traffic class, in Mbits/sec.
- virtualmachine
Reservation NumberMbit The amount of guaranteed bandwidth for the virtualMachine traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
- String
The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
- vlan
Id Number The VLAN ID for single VLAN mode. 0 denotes no VLAN.
- vlan
Ranges List<Property Map> Used to denote VLAN trunking. Use the
min_vlan
andmax_vlan
sub-arguments to define the tagged VLAN range. Multiplevlan_range
definitions are allowed, but they must not overlap. Example below:import * as pulumi from "@pulumi/pulumi"; import * as vsphere from "@pulumi/vsphere";
const vds = new vsphere.DistributedVirtualSwitch("vds", {vlanRanges: [ { maxVlan: 199, minVlan: 100, }, { maxVlan: 399, minVlan: 300, }, ]});
import pulumi import pulumi_vsphere as vsphere vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[ vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=199, min_vlan=100, ), vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=399, min_vlan=300, ), ])
using System.Collections.Generic; using System.Linq; using Pulumi; using VSphere = Pulumi.VSphere; return await Deployment.RunAsync(() => { var vds = new VSphere.DistributedVirtualSwitch("vds", new() { VlanRanges = new[] { new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 199, MinVlan = 100, }, new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 399, MinVlan = 300, }, }, }); });
package main import ( "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" "github.com/pulumi/pulumi/sdk/v3/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := vsphere.NewDistributedVirtualSwitch(ctx, "vds", &vsphere.DistributedVirtualSwitchArgs{ VlanRanges: vsphere.DistributedVirtualSwitchVlanRangeArray{ &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(199), MinVlan: pulumi.Int(100), }, &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(399), MinVlan: pulumi.Int(300), }, }, }) if err != nil { return err } return nil }) }
package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.vsphere.DistributedVirtualSwitch; import com.pulumi.vsphere.DistributedVirtualSwitchArgs; import com.pulumi.vsphere.inputs.DistributedVirtualSwitchVlanRangeArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var vds = new DistributedVirtualSwitch("vds", DistributedVirtualSwitchArgs.builder() .vlanRanges( DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(199) .minVlan(100) .build(), DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(399) .minVlan(300) .build()) .build()); } }
resources: vds: type: vsphere:DistributedVirtualSwitch properties: vlanRanges: - maxVlan: 199 minVlan: 100 - maxVlan: 399 minVlan: 300
- vmotion
Maximum NumberMbit The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
- vmotion
Reservation NumberMbit The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the vmotion traffic class for a custom share level.
- String
The allocation level for the vmotion traffic class. Can be one of high, low, normal, or custom.
- vsan
Maximum NumberMbit The maximum allowed usage for the vsan traffic class, in Mbits/sec.
- vsan
Reservation NumberMbit The amount of guaranteed bandwidth for the vsan traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the vsan traffic class for a custom share level.
- String
The allocation level for the vsan traffic class. Can be one of high, low, normal, or custom.
Outputs
All input properties are implicitly available as output properties. Additionally, the DistributedVirtualSwitch resource produces the following output properties:
- Config
Version string The current version of the VDS configuration, incremented by subsequent updates to the VDS.
- Id string
The provider-assigned unique ID for this managed resource.
- Config
Version string The current version of the VDS configuration, incremented by subsequent updates to the VDS.
- Id string
The provider-assigned unique ID for this managed resource.
- config
Version String The current version of the VDS configuration, incremented by subsequent updates to the VDS.
- id String
The provider-assigned unique ID for this managed resource.
- config
Version string The current version of the VDS configuration, incremented by subsequent updates to the VDS.
- id string
The provider-assigned unique ID for this managed resource.
- config_
version str The current version of the VDS configuration, incremented by subsequent updates to the VDS.
- id str
The provider-assigned unique ID for this managed resource.
- config
Version String The current version of the VDS configuration, incremented by subsequent updates to the VDS.
- id String
The provider-assigned unique ID for this managed resource.
Look up Existing DistributedVirtualSwitch Resource
Get an existing DistributedVirtualSwitch resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: DistributedVirtualSwitchState, opts?: CustomResourceOptions): DistributedVirtualSwitch
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
active_uplinks: Optional[Sequence[str]] = None,
allow_forged_transmits: Optional[bool] = None,
allow_mac_changes: Optional[bool] = None,
allow_promiscuous: Optional[bool] = None,
backupnfc_maximum_mbit: Optional[int] = None,
backupnfc_reservation_mbit: Optional[int] = None,
backupnfc_share_count: Optional[int] = None,
backupnfc_share_level: Optional[str] = None,
block_all_ports: Optional[bool] = None,
check_beacon: Optional[bool] = None,
config_version: Optional[str] = None,
contact_detail: Optional[str] = None,
contact_name: Optional[str] = None,
custom_attributes: Optional[Mapping[str, str]] = None,
datacenter_id: Optional[str] = None,
description: Optional[str] = None,
directpath_gen2_allowed: Optional[bool] = None,
egress_shaping_average_bandwidth: Optional[int] = None,
egress_shaping_burst_size: Optional[int] = None,
egress_shaping_enabled: Optional[bool] = None,
egress_shaping_peak_bandwidth: Optional[int] = None,
failback: Optional[bool] = None,
faulttolerance_maximum_mbit: Optional[int] = None,
faulttolerance_reservation_mbit: Optional[int] = None,
faulttolerance_share_count: Optional[int] = None,
faulttolerance_share_level: Optional[str] = None,
folder: Optional[str] = None,
hbr_maximum_mbit: Optional[int] = None,
hbr_reservation_mbit: Optional[int] = None,
hbr_share_count: Optional[int] = None,
hbr_share_level: Optional[str] = None,
hosts: Optional[Sequence[DistributedVirtualSwitchHostArgs]] = None,
ignore_other_pvlan_mappings: Optional[bool] = None,
ingress_shaping_average_bandwidth: Optional[int] = None,
ingress_shaping_burst_size: Optional[int] = None,
ingress_shaping_enabled: Optional[bool] = None,
ingress_shaping_peak_bandwidth: Optional[int] = None,
ipv4_address: Optional[str] = None,
iscsi_maximum_mbit: Optional[int] = None,
iscsi_reservation_mbit: Optional[int] = None,
iscsi_share_count: Optional[int] = None,
iscsi_share_level: Optional[str] = None,
lacp_api_version: Optional[str] = None,
lacp_enabled: Optional[bool] = None,
lacp_mode: Optional[str] = None,
link_discovery_operation: Optional[str] = None,
link_discovery_protocol: Optional[str] = None,
management_maximum_mbit: Optional[int] = None,
management_reservation_mbit: Optional[int] = None,
management_share_count: Optional[int] = None,
management_share_level: Optional[str] = None,
max_mtu: Optional[int] = None,
multicast_filtering_mode: Optional[str] = None,
name: Optional[str] = None,
netflow_active_flow_timeout: Optional[int] = None,
netflow_collector_ip_address: Optional[str] = None,
netflow_collector_port: Optional[int] = None,
netflow_enabled: Optional[bool] = None,
netflow_idle_flow_timeout: Optional[int] = None,
netflow_internal_flows_only: Optional[bool] = None,
netflow_observation_domain_id: Optional[int] = None,
netflow_sampling_rate: Optional[int] = None,
network_resource_control_enabled: Optional[bool] = None,
network_resource_control_version: Optional[str] = None,
nfs_maximum_mbit: Optional[int] = None,
nfs_reservation_mbit: Optional[int] = None,
nfs_share_count: Optional[int] = None,
nfs_share_level: Optional[str] = None,
notify_switches: Optional[bool] = None,
port_private_secondary_vlan_id: Optional[int] = None,
pvlan_mappings: Optional[Sequence[DistributedVirtualSwitchPvlanMappingArgs]] = None,
standby_uplinks: Optional[Sequence[str]] = None,
tags: Optional[Sequence[str]] = None,
teaming_policy: Optional[str] = None,
tx_uplink: Optional[bool] = None,
uplinks: Optional[Sequence[str]] = None,
vdp_maximum_mbit: Optional[int] = None,
vdp_reservation_mbit: Optional[int] = None,
vdp_share_count: Optional[int] = None,
vdp_share_level: Optional[str] = None,
version: Optional[str] = None,
virtualmachine_maximum_mbit: Optional[int] = None,
virtualmachine_reservation_mbit: Optional[int] = None,
virtualmachine_share_count: Optional[int] = None,
virtualmachine_share_level: Optional[str] = None,
vlan_id: Optional[int] = None,
vlan_ranges: Optional[Sequence[DistributedVirtualSwitchVlanRangeArgs]] = None,
vmotion_maximum_mbit: Optional[int] = None,
vmotion_reservation_mbit: Optional[int] = None,
vmotion_share_count: Optional[int] = None,
vmotion_share_level: Optional[str] = None,
vsan_maximum_mbit: Optional[int] = None,
vsan_reservation_mbit: Optional[int] = None,
vsan_share_count: Optional[int] = None,
vsan_share_level: Optional[str] = None) -> DistributedVirtualSwitch
func GetDistributedVirtualSwitch(ctx *Context, name string, id IDInput, state *DistributedVirtualSwitchState, opts ...ResourceOption) (*DistributedVirtualSwitch, error)
public static DistributedVirtualSwitch Get(string name, Input<string> id, DistributedVirtualSwitchState? state, CustomResourceOptions? opts = null)
public static DistributedVirtualSwitch get(String name, Output<String> id, DistributedVirtualSwitchState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Active
Uplinks List<string> A list of active uplinks to be used in load balancing. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- Allow
Forged boolTransmits Controls whether or not a virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
- Allow
Mac boolChanges Controls whether or not the Media Access Control (MAC) address can be changed.
- Allow
Promiscuous bool Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
- Backupnfc
Maximum intMbit The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
- Backupnfc
Reservation intMbit The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the backupNfc traffic class for a custom share level.
- string
The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
- Block
All boolPorts Shuts down all ports in the port groups that this policy applies to, effectively blocking all network access to connected virtual devices.
- Check
Beacon bool Enables beacon probing as an additional measure to detect NIC failure.
NOTE: VMware recommends using a minimum of 3 NICs when using beacon probing.
- Config
Version string The current version of the VDS configuration, incremented by subsequent updates to the VDS.
- Contact
Detail string The detailed contact information for the person who is responsible for the VDS.
- Contact
Name string The name of the person who is responsible for the VDS.
- Custom
Attributes Dictionary<string, string> Map of custom attribute ids to attribute value strings to set for VDS.
NOTE: Custom attributes are unsupported on direct ESXi host connections and requires vCenter Server.
- Datacenter
Id string The ID of the datacenter where the VDS will be created. Forces a new resource if changed.
- Description string
A detailed description for the VDS.
- Directpath
Gen2Allowed bool Allow VMDirectPath Gen2 for the ports for which this policy applies to.
- Egress
Shaping intAverage Bandwidth The average bandwidth in bits per second if egress traffic shaping is enabled on the port.
- Egress
Shaping intBurst Size The maximum burst size allowed in bytes if egress traffic shaping is enabled on the port.
- Egress
Shaping boolEnabled true
if the traffic shaper is enabled on the port for egress traffic.- Egress
Shaping intPeak Bandwidth The peak bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
- Failback bool
If
true
, the teaming policy will re-activate failed uplinks higher in precedence when they come back up.- Faulttolerance
Maximum intMbit The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
- Faulttolerance
Reservation intMbit The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
- string
The allocation level for the faultTolerance traffic class. Can be one of high, low, normal, or custom.
- Folder string
The folder in which to create the VDS. Forces a new resource if changed.
- Hbr
Maximum intMbit The maximum allowed usage for the hbr traffic class, in Mbits/sec.
- Hbr
Reservation intMbit The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the hbr traffic class for a custom share level.
- string
The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
- Hosts
List<Pulumi.
VSphere. Inputs. Distributed Virtual Switch Host> Use the
host
block to declare a host specification. The options are:- Ignore
Other boolPvlan Mappings Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
- Ingress
Shaping intAverage Bandwidth The average bandwidth in bits per second if ingress traffic shaping is enabled on the port.
- Ingress
Shaping intBurst Size The maximum burst size allowed in bytes if ingress traffic shaping is enabled on the port.
- Ingress
Shaping boolEnabled true
if the traffic shaper is enabled on the port for ingress traffic.- Ingress
Shaping intPeak Bandwidth The peak bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
- Ipv4Address string
An IPv4 address to identify the switch. This is mostly useful when used with the Netflow arguments.
- Iscsi
Maximum intMbit The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
- Iscsi
Reservation intMbit The amount of guaranteed bandwidth for the iSCSI traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the iSCSI traffic class for a custom share level.
- string
The allocation level for the iSCSI traffic class. Can be one of high, low, normal, or custom.
- Lacp
Api stringVersion The Link Aggregation Control Protocol group version to use with the VDS. Possible values are
singleLag
andmultipleLag
.- Lacp
Enabled bool Enables LACP for the ports that this policy applies to.
- Lacp
Mode string The LACP mode. Can be one of
active
orpassive
.- Link
Discovery stringOperation Whether to
advertise
orlisten
for link discovery traffic.- Link
Discovery stringProtocol The discovery protocol type. Valid types are
cdp
andlldp
.- Management
Maximum intMbit The maximum allowed usage for the management traffic class, in Mbits/sec.
- Management
Reservation intMbit The amount of guaranteed bandwidth for the management traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the management traffic class for a custom share level.
- string
The allocation level for the management traffic class. Can be one of high, low, normal, or custom.
- Max
Mtu int The maximum transmission unit (MTU) for the VDS.
- Multicast
Filtering stringMode The multicast filtering mode to use with the VDS. Can be one of
legacyFiltering
orsnooping
.- Name string
The name of the VDS.
- Netflow
Active intFlow Timeout The number of seconds after which active flows are forced to be exported to the collector. Allowed range is
60
to3600
. Default:60
.- Netflow
Collector stringIp Address IP address for the Netflow collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later. Must be set before Netflow can be enabled.
- Netflow
Collector intPort Port for the Netflow collector. This must be set before Netflow can be enabled.
- Netflow
Enabled bool Enables Netflow on all ports that this policy applies to.
- Netflow
Idle intFlow Timeout The number of seconds after which idle flows are forced to be exported to the collector. Allowed range is
10
to600
. Default:15
.- Netflow
Internal boolFlows Only Whether to limit analysis to traffic that has both source and destination served by the same host. Default:
false
.- Netflow
Observation intDomain Id The observation domain ID for the Netflow collector.
- Netflow
Sampling intRate The ratio of total number of packets to the number of packets analyzed. The default is
0
, which indicates that the VDS should analyze all packets. The maximum value is1000
, which indicates an analysis rate of 0.001%.- Network
Resource boolControl Enabled Set to
true
to enable network I/O control. Default:false
.- Network
Resource stringControl Version The version of network I/O control to use. Can be one of
version2
orversion3
. Default:version2
.- Nfs
Maximum intMbit The maximum allowed usage for the nfs traffic class, in Mbits/sec.
- Nfs
Reservation intMbit The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the nfs traffic class for a custom share level.
- string
The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
- Notify
Switches bool If
true
, the teaming policy will notify the broadcast network of an uplink failover, triggering cache updates.- Port
Private intSecondary Vlan Id Used to define a secondary VLAN ID when using private VLANs.
- Pvlan
Mappings List<Pulumi.VSphere. Inputs. Distributed Virtual Switch Pvlan Mapping> Use the
pvlan_mapping
block to declare a private VLAN mapping. The options are:- Standby
Uplinks List<string> A list of standby uplinks to be used in failover. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- List<string>
The IDs of any tags to attach to this resource.
NOTE: Tagging support requires vCenter Server 6.0 or higher.
- Teaming
Policy string The uplink teaming policy. Can be one of
loadbalance_ip
,loadbalance_srcmac
,loadbalance_srcid
,failover_explicit
, orloadbalance_loadbased
.- Tx
Uplink bool Forward all traffic transmitted by ports for which this policy applies to its VDS uplinks.
- Uplinks List<string>
A list of strings that uniquely identifies the names of the uplinks on the VDS across hosts. The number of items in this list controls the number of uplinks that exist on the VDS, in addition to the names. See here for an example on how to use this option.
- Vdp
Maximum intMbit The maximum allowed usage for the vdp traffic class, in Mbits/sec.
- Vdp
Reservation intMbit The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vdp traffic class for a custom share level.
- string
The allocation level for the vdp traffic class. Can be one of high, low, normal, or custom.
- Version string
The version of the VDS. BY default, a VDS is created at the latest version supported by the vSphere version if not specified. A VDS can be upgraded to a newer version, but can not be downgraded.
- Virtualmachine
Maximum intMbit The maximum allowed usage for the virtualMachine traffic class, in Mbits/sec.
- Virtualmachine
Reservation intMbit The amount of guaranteed bandwidth for the virtualMachine traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
- string
The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
- Vlan
Id int The VLAN ID for single VLAN mode. 0 denotes no VLAN.
- Vlan
Ranges List<Pulumi.VSphere. Inputs. Distributed Virtual Switch Vlan Range> Used to denote VLAN trunking. Use the
min_vlan
andmax_vlan
sub-arguments to define the tagged VLAN range. Multiplevlan_range
definitions are allowed, but they must not overlap. Example below:import * as pulumi from "@pulumi/pulumi"; import * as vsphere from "@pulumi/vsphere";
const vds = new vsphere.DistributedVirtualSwitch("vds", {vlanRanges: [ { maxVlan: 199, minVlan: 100, }, { maxVlan: 399, minVlan: 300, }, ]});
import pulumi import pulumi_vsphere as vsphere vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[ vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=199, min_vlan=100, ), vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=399, min_vlan=300, ), ])
using System.Collections.Generic; using System.Linq; using Pulumi; using VSphere = Pulumi.VSphere; return await Deployment.RunAsync(() => { var vds = new VSphere.DistributedVirtualSwitch("vds", new() { VlanRanges = new[] { new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 199, MinVlan = 100, }, new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 399, MinVlan = 300, }, }, }); });
package main import ( "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" "github.com/pulumi/pulumi/sdk/v3/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := vsphere.NewDistributedVirtualSwitch(ctx, "vds", &vsphere.DistributedVirtualSwitchArgs{ VlanRanges: vsphere.DistributedVirtualSwitchVlanRangeArray{ &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(199), MinVlan: pulumi.Int(100), }, &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(399), MinVlan: pulumi.Int(300), }, }, }) if err != nil { return err } return nil }) }
package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.vsphere.DistributedVirtualSwitch; import com.pulumi.vsphere.DistributedVirtualSwitchArgs; import com.pulumi.vsphere.inputs.DistributedVirtualSwitchVlanRangeArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var vds = new DistributedVirtualSwitch("vds", DistributedVirtualSwitchArgs.builder() .vlanRanges( DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(199) .minVlan(100) .build(), DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(399) .minVlan(300) .build()) .build()); } }
resources: vds: type: vsphere:DistributedVirtualSwitch properties: vlanRanges: - maxVlan: 199 minVlan: 100 - maxVlan: 399 minVlan: 300
- Vmotion
Maximum intMbit The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
- Vmotion
Reservation intMbit The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vmotion traffic class for a custom share level.
- string
The allocation level for the vmotion traffic class. Can be one of high, low, normal, or custom.
- Vsan
Maximum intMbit The maximum allowed usage for the vsan traffic class, in Mbits/sec.
- Vsan
Reservation intMbit The amount of guaranteed bandwidth for the vsan traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vsan traffic class for a custom share level.
- string
The allocation level for the vsan traffic class. Can be one of high, low, normal, or custom.
- Active
Uplinks []string A list of active uplinks to be used in load balancing. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- Allow
Forged boolTransmits Controls whether or not a virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
- Allow
Mac boolChanges Controls whether or not the Media Access Control (MAC) address can be changed.
- Allow
Promiscuous bool Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
- Backupnfc
Maximum intMbit The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
- Backupnfc
Reservation intMbit The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the backupNfc traffic class for a custom share level.
- string
The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
- Block
All boolPorts Shuts down all ports in the port groups that this policy applies to, effectively blocking all network access to connected virtual devices.
- Check
Beacon bool Enables beacon probing as an additional measure to detect NIC failure.
NOTE: VMware recommends using a minimum of 3 NICs when using beacon probing.
- Config
Version string The current version of the VDS configuration, incremented by subsequent updates to the VDS.
- Contact
Detail string The detailed contact information for the person who is responsible for the VDS.
- Contact
Name string The name of the person who is responsible for the VDS.
- Custom
Attributes map[string]string Map of custom attribute ids to attribute value strings to set for VDS.
NOTE: Custom attributes are unsupported on direct ESXi host connections and requires vCenter Server.
- Datacenter
Id string The ID of the datacenter where the VDS will be created. Forces a new resource if changed.
- Description string
A detailed description for the VDS.
- Directpath
Gen2Allowed bool Allow VMDirectPath Gen2 for the ports for which this policy applies to.
- Egress
Shaping intAverage Bandwidth The average bandwidth in bits per second if egress traffic shaping is enabled on the port.
- Egress
Shaping intBurst Size The maximum burst size allowed in bytes if egress traffic shaping is enabled on the port.
- Egress
Shaping boolEnabled true
if the traffic shaper is enabled on the port for egress traffic.- Egress
Shaping intPeak Bandwidth The peak bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
- Failback bool
If
true
, the teaming policy will re-activate failed uplinks higher in precedence when they come back up.- Faulttolerance
Maximum intMbit The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
- Faulttolerance
Reservation intMbit The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
- string
The allocation level for the faultTolerance traffic class. Can be one of high, low, normal, or custom.
- Folder string
The folder in which to create the VDS. Forces a new resource if changed.
- Hbr
Maximum intMbit The maximum allowed usage for the hbr traffic class, in Mbits/sec.
- Hbr
Reservation intMbit The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the hbr traffic class for a custom share level.
- string
The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
- Hosts
[]Distributed
Virtual Switch Host Args Use the
host
block to declare a host specification. The options are:- Ignore
Other boolPvlan Mappings Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
- Ingress
Shaping intAverage Bandwidth The average bandwidth in bits per second if ingress traffic shaping is enabled on the port.
- Ingress
Shaping intBurst Size The maximum burst size allowed in bytes if ingress traffic shaping is enabled on the port.
- Ingress
Shaping boolEnabled true
if the traffic shaper is enabled on the port for ingress traffic.- Ingress
Shaping intPeak Bandwidth The peak bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
- Ipv4Address string
An IPv4 address to identify the switch. This is mostly useful when used with the Netflow arguments.
- Iscsi
Maximum intMbit The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
- Iscsi
Reservation intMbit The amount of guaranteed bandwidth for the iSCSI traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the iSCSI traffic class for a custom share level.
- string
The allocation level for the iSCSI traffic class. Can be one of high, low, normal, or custom.
- Lacp
Api stringVersion The Link Aggregation Control Protocol group version to use with the VDS. Possible values are
singleLag
andmultipleLag
.- Lacp
Enabled bool Enables LACP for the ports that this policy applies to.
- Lacp
Mode string The LACP mode. Can be one of
active
orpassive
.- Link
Discovery stringOperation Whether to
advertise
orlisten
for link discovery traffic.- Link
Discovery stringProtocol The discovery protocol type. Valid types are
cdp
andlldp
.- Management
Maximum intMbit The maximum allowed usage for the management traffic class, in Mbits/sec.
- Management
Reservation intMbit The amount of guaranteed bandwidth for the management traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the management traffic class for a custom share level.
- string
The allocation level for the management traffic class. Can be one of high, low, normal, or custom.
- Max
Mtu int The maximum transmission unit (MTU) for the VDS.
- Multicast
Filtering stringMode The multicast filtering mode to use with the VDS. Can be one of
legacyFiltering
orsnooping
.- Name string
The name of the VDS.
- Netflow
Active intFlow Timeout The number of seconds after which active flows are forced to be exported to the collector. Allowed range is
60
to3600
. Default:60
.- Netflow
Collector stringIp Address IP address for the Netflow collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later. Must be set before Netflow can be enabled.
- Netflow
Collector intPort Port for the Netflow collector. This must be set before Netflow can be enabled.
- Netflow
Enabled bool Enables Netflow on all ports that this policy applies to.
- Netflow
Idle intFlow Timeout The number of seconds after which idle flows are forced to be exported to the collector. Allowed range is
10
to600
. Default:15
.- Netflow
Internal boolFlows Only Whether to limit analysis to traffic that has both source and destination served by the same host. Default:
false
.- Netflow
Observation intDomain Id The observation domain ID for the Netflow collector.
- Netflow
Sampling intRate The ratio of total number of packets to the number of packets analyzed. The default is
0
, which indicates that the VDS should analyze all packets. The maximum value is1000
, which indicates an analysis rate of 0.001%.- Network
Resource boolControl Enabled Set to
true
to enable network I/O control. Default:false
.- Network
Resource stringControl Version The version of network I/O control to use. Can be one of
version2
orversion3
. Default:version2
.- Nfs
Maximum intMbit The maximum allowed usage for the nfs traffic class, in Mbits/sec.
- Nfs
Reservation intMbit The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the nfs traffic class for a custom share level.
- string
The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
- Notify
Switches bool If
true
, the teaming policy will notify the broadcast network of an uplink failover, triggering cache updates.- Port
Private intSecondary Vlan Id Used to define a secondary VLAN ID when using private VLANs.
- Pvlan
Mappings []DistributedVirtual Switch Pvlan Mapping Args Use the
pvlan_mapping
block to declare a private VLAN mapping. The options are:- Standby
Uplinks []string A list of standby uplinks to be used in failover. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- []string
The IDs of any tags to attach to this resource.
NOTE: Tagging support requires vCenter Server 6.0 or higher.
- Teaming
Policy string The uplink teaming policy. Can be one of
loadbalance_ip
,loadbalance_srcmac
,loadbalance_srcid
,failover_explicit
, orloadbalance_loadbased
.- Tx
Uplink bool Forward all traffic transmitted by ports for which this policy applies to its VDS uplinks.
- Uplinks []string
A list of strings that uniquely identifies the names of the uplinks on the VDS across hosts. The number of items in this list controls the number of uplinks that exist on the VDS, in addition to the names. See here for an example on how to use this option.
- Vdp
Maximum intMbit The maximum allowed usage for the vdp traffic class, in Mbits/sec.
- Vdp
Reservation intMbit The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vdp traffic class for a custom share level.
- string
The allocation level for the vdp traffic class. Can be one of high, low, normal, or custom.
- Version string
The version of the VDS. BY default, a VDS is created at the latest version supported by the vSphere version if not specified. A VDS can be upgraded to a newer version, but can not be downgraded.
- Virtualmachine
Maximum intMbit The maximum allowed usage for the virtualMachine traffic class, in Mbits/sec.
- Virtualmachine
Reservation intMbit The amount of guaranteed bandwidth for the virtualMachine traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
- string
The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
- Vlan
Id int The VLAN ID for single VLAN mode. 0 denotes no VLAN.
- Vlan
Ranges []DistributedVirtual Switch Vlan Range Args Used to denote VLAN trunking. Use the
min_vlan
andmax_vlan
sub-arguments to define the tagged VLAN range. Multiplevlan_range
definitions are allowed, but they must not overlap. Example below:import * as pulumi from "@pulumi/pulumi"; import * as vsphere from "@pulumi/vsphere";
const vds = new vsphere.DistributedVirtualSwitch("vds", {vlanRanges: [ { maxVlan: 199, minVlan: 100, }, { maxVlan: 399, minVlan: 300, }, ]});
import pulumi import pulumi_vsphere as vsphere vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[ vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=199, min_vlan=100, ), vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=399, min_vlan=300, ), ])
using System.Collections.Generic; using System.Linq; using Pulumi; using VSphere = Pulumi.VSphere; return await Deployment.RunAsync(() => { var vds = new VSphere.DistributedVirtualSwitch("vds", new() { VlanRanges = new[] { new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 199, MinVlan = 100, }, new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 399, MinVlan = 300, }, }, }); });
package main import ( "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" "github.com/pulumi/pulumi/sdk/v3/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := vsphere.NewDistributedVirtualSwitch(ctx, "vds", &vsphere.DistributedVirtualSwitchArgs{ VlanRanges: vsphere.DistributedVirtualSwitchVlanRangeArray{ &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(199), MinVlan: pulumi.Int(100), }, &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(399), MinVlan: pulumi.Int(300), }, }, }) if err != nil { return err } return nil }) }
package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.vsphere.DistributedVirtualSwitch; import com.pulumi.vsphere.DistributedVirtualSwitchArgs; import com.pulumi.vsphere.inputs.DistributedVirtualSwitchVlanRangeArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var vds = new DistributedVirtualSwitch("vds", DistributedVirtualSwitchArgs.builder() .vlanRanges( DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(199) .minVlan(100) .build(), DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(399) .minVlan(300) .build()) .build()); } }
resources: vds: type: vsphere:DistributedVirtualSwitch properties: vlanRanges: - maxVlan: 199 minVlan: 100 - maxVlan: 399 minVlan: 300
- Vmotion
Maximum intMbit The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
- Vmotion
Reservation intMbit The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vmotion traffic class for a custom share level.
- string
The allocation level for the vmotion traffic class. Can be one of high, low, normal, or custom.
- Vsan
Maximum intMbit The maximum allowed usage for the vsan traffic class, in Mbits/sec.
- Vsan
Reservation intMbit The amount of guaranteed bandwidth for the vsan traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vsan traffic class for a custom share level.
- string
The allocation level for the vsan traffic class. Can be one of high, low, normal, or custom.
- active
Uplinks List<String> A list of active uplinks to be used in load balancing. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- allow
Forged BooleanTransmits Controls whether or not a virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
- allow
Mac BooleanChanges Controls whether or not the Media Access Control (MAC) address can be changed.
- allow
Promiscuous Boolean Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
- backupnfc
Maximum IntegerMbit The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
- backupnfc
Reservation IntegerMbit The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the backupNfc traffic class for a custom share level.
- String
The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
- block
All BooleanPorts Shuts down all ports in the port groups that this policy applies to, effectively blocking all network access to connected virtual devices.
- check
Beacon Boolean Enables beacon probing as an additional measure to detect NIC failure.
NOTE: VMware recommends using a minimum of 3 NICs when using beacon probing.
- config
Version String The current version of the VDS configuration, incremented by subsequent updates to the VDS.
- contact
Detail String The detailed contact information for the person who is responsible for the VDS.
- contact
Name String The name of the person who is responsible for the VDS.
- custom
Attributes Map<String,String> Map of custom attribute ids to attribute value strings to set for VDS.
NOTE: Custom attributes are unsupported on direct ESXi host connections and requires vCenter Server.
- datacenter
Id String The ID of the datacenter where the VDS will be created. Forces a new resource if changed.
- description String
A detailed description for the VDS.
- directpath
Gen2Allowed Boolean Allow VMDirectPath Gen2 for the ports for which this policy applies to.
- egress
Shaping IntegerAverage Bandwidth The average bandwidth in bits per second if egress traffic shaping is enabled on the port.
- egress
Shaping IntegerBurst Size The maximum burst size allowed in bytes if egress traffic shaping is enabled on the port.
- egress
Shaping BooleanEnabled true
if the traffic shaper is enabled on the port for egress traffic.- egress
Shaping IntegerPeak Bandwidth The peak bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
- failback Boolean
If
true
, the teaming policy will re-activate failed uplinks higher in precedence when they come back up.- faulttolerance
Maximum IntegerMbit The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
- faulttolerance
Reservation IntegerMbit The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
- String
The allocation level for the faultTolerance traffic class. Can be one of high, low, normal, or custom.
- folder String
The folder in which to create the VDS. Forces a new resource if changed.
- hbr
Maximum IntegerMbit The maximum allowed usage for the hbr traffic class, in Mbits/sec.
- hbr
Reservation IntegerMbit The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the hbr traffic class for a custom share level.
- String
The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
- hosts
List<Distributed
Virtual Switch Host> Use the
host
block to declare a host specification. The options are:- ignore
Other BooleanPvlan Mappings Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
- ingress
Shaping IntegerAverage Bandwidth The average bandwidth in bits per second if ingress traffic shaping is enabled on the port.
- ingress
Shaping IntegerBurst Size The maximum burst size allowed in bytes if ingress traffic shaping is enabled on the port.
- ingress
Shaping BooleanEnabled true
if the traffic shaper is enabled on the port for ingress traffic.- ingress
Shaping IntegerPeak Bandwidth The peak bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
- ipv4Address String
An IPv4 address to identify the switch. This is mostly useful when used with the Netflow arguments.
- iscsi
Maximum IntegerMbit The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
- iscsi
Reservation IntegerMbit The amount of guaranteed bandwidth for the iSCSI traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the iSCSI traffic class for a custom share level.
- String
The allocation level for the iSCSI traffic class. Can be one of high, low, normal, or custom.
- lacp
Api StringVersion The Link Aggregation Control Protocol group version to use with the VDS. Possible values are
singleLag
andmultipleLag
.- lacp
Enabled Boolean Enables LACP for the ports that this policy applies to.
- lacp
Mode String The LACP mode. Can be one of
active
orpassive
.- link
Discovery StringOperation Whether to
advertise
orlisten
for link discovery traffic.- link
Discovery StringProtocol The discovery protocol type. Valid types are
cdp
andlldp
.- management
Maximum IntegerMbit The maximum allowed usage for the management traffic class, in Mbits/sec.
- management
Reservation IntegerMbit The amount of guaranteed bandwidth for the management traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the management traffic class for a custom share level.
- String
The allocation level for the management traffic class. Can be one of high, low, normal, or custom.
- max
Mtu Integer The maximum transmission unit (MTU) for the VDS.
- multicast
Filtering StringMode The multicast filtering mode to use with the VDS. Can be one of
legacyFiltering
orsnooping
.- name String
The name of the VDS.
- netflow
Active IntegerFlow Timeout The number of seconds after which active flows are forced to be exported to the collector. Allowed range is
60
to3600
. Default:60
.- netflow
Collector StringIp Address IP address for the Netflow collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later. Must be set before Netflow can be enabled.
- netflow
Collector IntegerPort Port for the Netflow collector. This must be set before Netflow can be enabled.
- netflow
Enabled Boolean Enables Netflow on all ports that this policy applies to.
- netflow
Idle IntegerFlow Timeout The number of seconds after which idle flows are forced to be exported to the collector. Allowed range is
10
to600
. Default:15
.- netflow
Internal BooleanFlows Only Whether to limit analysis to traffic that has both source and destination served by the same host. Default:
false
.- netflow
Observation IntegerDomain Id The observation domain ID for the Netflow collector.
- netflow
Sampling IntegerRate The ratio of total number of packets to the number of packets analyzed. The default is
0
, which indicates that the VDS should analyze all packets. The maximum value is1000
, which indicates an analysis rate of 0.001%.- network
Resource BooleanControl Enabled Set to
true
to enable network I/O control. Default:false
.- network
Resource StringControl Version The version of network I/O control to use. Can be one of
version2
orversion3
. Default:version2
.- nfs
Maximum IntegerMbit The maximum allowed usage for the nfs traffic class, in Mbits/sec.
- nfs
Reservation IntegerMbit The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the nfs traffic class for a custom share level.
- String
The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
- notify
Switches Boolean If
true
, the teaming policy will notify the broadcast network of an uplink failover, triggering cache updates.- port
Private IntegerSecondary Vlan Id Used to define a secondary VLAN ID when using private VLANs.
- pvlan
Mappings List<DistributedVirtual Switch Pvlan Mapping> Use the
pvlan_mapping
block to declare a private VLAN mapping. The options are:- standby
Uplinks List<String> A list of standby uplinks to be used in failover. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- List<String>
The IDs of any tags to attach to this resource.
NOTE: Tagging support requires vCenter Server 6.0 or higher.
- teaming
Policy String The uplink teaming policy. Can be one of
loadbalance_ip
,loadbalance_srcmac
,loadbalance_srcid
,failover_explicit
, orloadbalance_loadbased
.- tx
Uplink Boolean Forward all traffic transmitted by ports for which this policy applies to its VDS uplinks.
- uplinks List<String>
A list of strings that uniquely identifies the names of the uplinks on the VDS across hosts. The number of items in this list controls the number of uplinks that exist on the VDS, in addition to the names. See here for an example on how to use this option.
- vdp
Maximum IntegerMbit The maximum allowed usage for the vdp traffic class, in Mbits/sec.
- vdp
Reservation IntegerMbit The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the vdp traffic class for a custom share level.
- String
The allocation level for the vdp traffic class. Can be one of high, low, normal, or custom.
- version String
The version of the VDS. BY default, a VDS is created at the latest version supported by the vSphere version if not specified. A VDS can be upgraded to a newer version, but can not be downgraded.
- virtualmachine
Maximum IntegerMbit The maximum allowed usage for the virtualMachine traffic class, in Mbits/sec.
- virtualmachine
Reservation IntegerMbit The amount of guaranteed bandwidth for the virtualMachine traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
- String
The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
- vlan
Id Integer The VLAN ID for single VLAN mode. 0 denotes no VLAN.
- vlan
Ranges List<DistributedVirtual Switch Vlan Range> Used to denote VLAN trunking. Use the
min_vlan
andmax_vlan
sub-arguments to define the tagged VLAN range. Multiplevlan_range
definitions are allowed, but they must not overlap. Example below:import * as pulumi from "@pulumi/pulumi"; import * as vsphere from "@pulumi/vsphere";
const vds = new vsphere.DistributedVirtualSwitch("vds", {vlanRanges: [ { maxVlan: 199, minVlan: 100, }, { maxVlan: 399, minVlan: 300, }, ]});
import pulumi import pulumi_vsphere as vsphere vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[ vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=199, min_vlan=100, ), vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=399, min_vlan=300, ), ])
using System.Collections.Generic; using System.Linq; using Pulumi; using VSphere = Pulumi.VSphere; return await Deployment.RunAsync(() => { var vds = new VSphere.DistributedVirtualSwitch("vds", new() { VlanRanges = new[] { new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 199, MinVlan = 100, }, new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 399, MinVlan = 300, }, }, }); });
package main import ( "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" "github.com/pulumi/pulumi/sdk/v3/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := vsphere.NewDistributedVirtualSwitch(ctx, "vds", &vsphere.DistributedVirtualSwitchArgs{ VlanRanges: vsphere.DistributedVirtualSwitchVlanRangeArray{ &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(199), MinVlan: pulumi.Int(100), }, &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(399), MinVlan: pulumi.Int(300), }, }, }) if err != nil { return err } return nil }) }
package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.vsphere.DistributedVirtualSwitch; import com.pulumi.vsphere.DistributedVirtualSwitchArgs; import com.pulumi.vsphere.inputs.DistributedVirtualSwitchVlanRangeArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var vds = new DistributedVirtualSwitch("vds", DistributedVirtualSwitchArgs.builder() .vlanRanges( DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(199) .minVlan(100) .build(), DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(399) .minVlan(300) .build()) .build()); } }
resources: vds: type: vsphere:DistributedVirtualSwitch properties: vlanRanges: - maxVlan: 199 minVlan: 100 - maxVlan: 399 minVlan: 300
- vmotion
Maximum IntegerMbit The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
- vmotion
Reservation IntegerMbit The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the vmotion traffic class for a custom share level.
- String
The allocation level for the vmotion traffic class. Can be one of high, low, normal, or custom.
- vsan
Maximum IntegerMbit The maximum allowed usage for the vsan traffic class, in Mbits/sec.
- vsan
Reservation IntegerMbit The amount of guaranteed bandwidth for the vsan traffic class, in Mbits/sec.
- Integer
The amount of shares to allocate to the vsan traffic class for a custom share level.
- String
The allocation level for the vsan traffic class. Can be one of high, low, normal, or custom.
- active
Uplinks string[] A list of active uplinks to be used in load balancing. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- allow
Forged booleanTransmits Controls whether or not a virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
- allow
Mac booleanChanges Controls whether or not the Media Access Control (MAC) address can be changed.
- allow
Promiscuous boolean Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
- backupnfc
Maximum numberMbit The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
- backupnfc
Reservation numberMbit The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the backupNfc traffic class for a custom share level.
- string
The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
- block
All booleanPorts Shuts down all ports in the port groups that this policy applies to, effectively blocking all network access to connected virtual devices.
- check
Beacon boolean Enables beacon probing as an additional measure to detect NIC failure.
NOTE: VMware recommends using a minimum of 3 NICs when using beacon probing.
- config
Version string The current version of the VDS configuration, incremented by subsequent updates to the VDS.
- contact
Detail string The detailed contact information for the person who is responsible for the VDS.
- contact
Name string The name of the person who is responsible for the VDS.
- custom
Attributes {[key: string]: string} Map of custom attribute ids to attribute value strings to set for VDS.
NOTE: Custom attributes are unsupported on direct ESXi host connections and requires vCenter Server.
- datacenter
Id string The ID of the datacenter where the VDS will be created. Forces a new resource if changed.
- description string
A detailed description for the VDS.
- directpath
Gen2Allowed boolean Allow VMDirectPath Gen2 for the ports for which this policy applies to.
- egress
Shaping numberAverage Bandwidth The average bandwidth in bits per second if egress traffic shaping is enabled on the port.
- egress
Shaping numberBurst Size The maximum burst size allowed in bytes if egress traffic shaping is enabled on the port.
- egress
Shaping booleanEnabled true
if the traffic shaper is enabled on the port for egress traffic.- egress
Shaping numberPeak Bandwidth The peak bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
- failback boolean
If
true
, the teaming policy will re-activate failed uplinks higher in precedence when they come back up.- faulttolerance
Maximum numberMbit The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
- faulttolerance
Reservation numberMbit The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
- string
The allocation level for the faultTolerance traffic class. Can be one of high, low, normal, or custom.
- folder string
The folder in which to create the VDS. Forces a new resource if changed.
- hbr
Maximum numberMbit The maximum allowed usage for the hbr traffic class, in Mbits/sec.
- hbr
Reservation numberMbit The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the hbr traffic class for a custom share level.
- string
The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
- hosts
Distributed
Virtual Switch Host[] Use the
host
block to declare a host specification. The options are:- ignore
Other booleanPvlan Mappings Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
- ingress
Shaping numberAverage Bandwidth The average bandwidth in bits per second if ingress traffic shaping is enabled on the port.
- ingress
Shaping numberBurst Size The maximum burst size allowed in bytes if ingress traffic shaping is enabled on the port.
- ingress
Shaping booleanEnabled true
if the traffic shaper is enabled on the port for ingress traffic.- ingress
Shaping numberPeak Bandwidth The peak bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
- ipv4Address string
An IPv4 address to identify the switch. This is mostly useful when used with the Netflow arguments.
- iscsi
Maximum numberMbit The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
- iscsi
Reservation numberMbit The amount of guaranteed bandwidth for the iSCSI traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the iSCSI traffic class for a custom share level.
- string
The allocation level for the iSCSI traffic class. Can be one of high, low, normal, or custom.
- lacp
Api stringVersion The Link Aggregation Control Protocol group version to use with the VDS. Possible values are
singleLag
andmultipleLag
.- lacp
Enabled boolean Enables LACP for the ports that this policy applies to.
- lacp
Mode string The LACP mode. Can be one of
active
orpassive
.- link
Discovery stringOperation Whether to
advertise
orlisten
for link discovery traffic.- link
Discovery stringProtocol The discovery protocol type. Valid types are
cdp
andlldp
.- management
Maximum numberMbit The maximum allowed usage for the management traffic class, in Mbits/sec.
- management
Reservation numberMbit The amount of guaranteed bandwidth for the management traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the management traffic class for a custom share level.
- string
The allocation level for the management traffic class. Can be one of high, low, normal, or custom.
- max
Mtu number The maximum transmission unit (MTU) for the VDS.
- multicast
Filtering stringMode The multicast filtering mode to use with the VDS. Can be one of
legacyFiltering
orsnooping
.- name string
The name of the VDS.
- netflow
Active numberFlow Timeout The number of seconds after which active flows are forced to be exported to the collector. Allowed range is
60
to3600
. Default:60
.- netflow
Collector stringIp Address IP address for the Netflow collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later. Must be set before Netflow can be enabled.
- netflow
Collector numberPort Port for the Netflow collector. This must be set before Netflow can be enabled.
- netflow
Enabled boolean Enables Netflow on all ports that this policy applies to.
- netflow
Idle numberFlow Timeout The number of seconds after which idle flows are forced to be exported to the collector. Allowed range is
10
to600
. Default:15
.- netflow
Internal booleanFlows Only Whether to limit analysis to traffic that has both source and destination served by the same host. Default:
false
.- netflow
Observation numberDomain Id The observation domain ID for the Netflow collector.
- netflow
Sampling numberRate The ratio of total number of packets to the number of packets analyzed. The default is
0
, which indicates that the VDS should analyze all packets. The maximum value is1000
, which indicates an analysis rate of 0.001%.- network
Resource booleanControl Enabled Set to
true
to enable network I/O control. Default:false
.- network
Resource stringControl Version The version of network I/O control to use. Can be one of
version2
orversion3
. Default:version2
.- nfs
Maximum numberMbit The maximum allowed usage for the nfs traffic class, in Mbits/sec.
- nfs
Reservation numberMbit The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the nfs traffic class for a custom share level.
- string
The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
- notify
Switches boolean If
true
, the teaming policy will notify the broadcast network of an uplink failover, triggering cache updates.- port
Private numberSecondary Vlan Id Used to define a secondary VLAN ID when using private VLANs.
- pvlan
Mappings DistributedVirtual Switch Pvlan Mapping[] Use the
pvlan_mapping
block to declare a private VLAN mapping. The options are:- standby
Uplinks string[] A list of standby uplinks to be used in failover. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- string[]
The IDs of any tags to attach to this resource.
NOTE: Tagging support requires vCenter Server 6.0 or higher.
- teaming
Policy string The uplink teaming policy. Can be one of
loadbalance_ip
,loadbalance_srcmac
,loadbalance_srcid
,failover_explicit
, orloadbalance_loadbased
.- tx
Uplink boolean Forward all traffic transmitted by ports for which this policy applies to its VDS uplinks.
- uplinks string[]
A list of strings that uniquely identifies the names of the uplinks on the VDS across hosts. The number of items in this list controls the number of uplinks that exist on the VDS, in addition to the names. See here for an example on how to use this option.
- vdp
Maximum numberMbit The maximum allowed usage for the vdp traffic class, in Mbits/sec.
- vdp
Reservation numberMbit The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the vdp traffic class for a custom share level.
- string
The allocation level for the vdp traffic class. Can be one of high, low, normal, or custom.
- version string
The version of the VDS. BY default, a VDS is created at the latest version supported by the vSphere version if not specified. A VDS can be upgraded to a newer version, but can not be downgraded.
- virtualmachine
Maximum numberMbit The maximum allowed usage for the virtualMachine traffic class, in Mbits/sec.
- virtualmachine
Reservation numberMbit The amount of guaranteed bandwidth for the virtualMachine traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
- string
The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
- vlan
Id number The VLAN ID for single VLAN mode. 0 denotes no VLAN.
- vlan
Ranges DistributedVirtual Switch Vlan Range[] Used to denote VLAN trunking. Use the
min_vlan
andmax_vlan
sub-arguments to define the tagged VLAN range. Multiplevlan_range
definitions are allowed, but they must not overlap. Example below:import * as pulumi from "@pulumi/pulumi"; import * as vsphere from "@pulumi/vsphere";
const vds = new vsphere.DistributedVirtualSwitch("vds", {vlanRanges: [ { maxVlan: 199, minVlan: 100, }, { maxVlan: 399, minVlan: 300, }, ]});
import pulumi import pulumi_vsphere as vsphere vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[ vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=199, min_vlan=100, ), vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=399, min_vlan=300, ), ])
using System.Collections.Generic; using System.Linq; using Pulumi; using VSphere = Pulumi.VSphere; return await Deployment.RunAsync(() => { var vds = new VSphere.DistributedVirtualSwitch("vds", new() { VlanRanges = new[] { new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 199, MinVlan = 100, }, new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 399, MinVlan = 300, }, }, }); });
package main import ( "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" "github.com/pulumi/pulumi/sdk/v3/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := vsphere.NewDistributedVirtualSwitch(ctx, "vds", &vsphere.DistributedVirtualSwitchArgs{ VlanRanges: vsphere.DistributedVirtualSwitchVlanRangeArray{ &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(199), MinVlan: pulumi.Int(100), }, &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(399), MinVlan: pulumi.Int(300), }, }, }) if err != nil { return err } return nil }) }
package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.vsphere.DistributedVirtualSwitch; import com.pulumi.vsphere.DistributedVirtualSwitchArgs; import com.pulumi.vsphere.inputs.DistributedVirtualSwitchVlanRangeArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var vds = new DistributedVirtualSwitch("vds", DistributedVirtualSwitchArgs.builder() .vlanRanges( DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(199) .minVlan(100) .build(), DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(399) .minVlan(300) .build()) .build()); } }
resources: vds: type: vsphere:DistributedVirtualSwitch properties: vlanRanges: - maxVlan: 199 minVlan: 100 - maxVlan: 399 minVlan: 300
- vmotion
Maximum numberMbit The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
- vmotion
Reservation numberMbit The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the vmotion traffic class for a custom share level.
- string
The allocation level for the vmotion traffic class. Can be one of high, low, normal, or custom.
- vsan
Maximum numberMbit The maximum allowed usage for the vsan traffic class, in Mbits/sec.
- vsan
Reservation numberMbit The amount of guaranteed bandwidth for the vsan traffic class, in Mbits/sec.
- number
The amount of shares to allocate to the vsan traffic class for a custom share level.
- string
The allocation level for the vsan traffic class. Can be one of high, low, normal, or custom.
- active_
uplinks Sequence[str] A list of active uplinks to be used in load balancing. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- allow_
forged_ booltransmits Controls whether or not a virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
- allow_
mac_ boolchanges Controls whether or not the Media Access Control (MAC) address can be changed.
- allow_
promiscuous bool Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
- backupnfc_
maximum_ intmbit The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
- backupnfc_
reservation_ intmbit The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the backupNfc traffic class for a custom share level.
- str
The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
- block_
all_ boolports Shuts down all ports in the port groups that this policy applies to, effectively blocking all network access to connected virtual devices.
- check_
beacon bool Enables beacon probing as an additional measure to detect NIC failure.
NOTE: VMware recommends using a minimum of 3 NICs when using beacon probing.
- config_
version str The current version of the VDS configuration, incremented by subsequent updates to the VDS.
- contact_
detail str The detailed contact information for the person who is responsible for the VDS.
- contact_
name str The name of the person who is responsible for the VDS.
- custom_
attributes Mapping[str, str] Map of custom attribute ids to attribute value strings to set for VDS.
NOTE: Custom attributes are unsupported on direct ESXi host connections and requires vCenter Server.
- datacenter_
id str The ID of the datacenter where the VDS will be created. Forces a new resource if changed.
- description str
A detailed description for the VDS.
- directpath_
gen2_ boolallowed Allow VMDirectPath Gen2 for the ports for which this policy applies to.
- egress_
shaping_ intaverage_ bandwidth The average bandwidth in bits per second if egress traffic shaping is enabled on the port.
- egress_
shaping_ intburst_ size The maximum burst size allowed in bytes if egress traffic shaping is enabled on the port.
- egress_
shaping_ boolenabled true
if the traffic shaper is enabled on the port for egress traffic.- egress_
shaping_ intpeak_ bandwidth The peak bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
- failback bool
If
true
, the teaming policy will re-activate failed uplinks higher in precedence when they come back up.- faulttolerance_
maximum_ intmbit The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
- faulttolerance_
reservation_ intmbit The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
- str
The allocation level for the faultTolerance traffic class. Can be one of high, low, normal, or custom.
- folder str
The folder in which to create the VDS. Forces a new resource if changed.
- hbr_
maximum_ intmbit The maximum allowed usage for the hbr traffic class, in Mbits/sec.
- hbr_
reservation_ intmbit The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the hbr traffic class for a custom share level.
- str
The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
- hosts
Sequence[Distributed
Virtual Switch Host Args] Use the
host
block to declare a host specification. The options are:- ignore_
other_ boolpvlan_ mappings Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
- ingress_
shaping_ intaverage_ bandwidth The average bandwidth in bits per second if ingress traffic shaping is enabled on the port.
- ingress_
shaping_ intburst_ size The maximum burst size allowed in bytes if ingress traffic shaping is enabled on the port.
- ingress_
shaping_ boolenabled true
if the traffic shaper is enabled on the port for ingress traffic.- ingress_
shaping_ intpeak_ bandwidth The peak bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
- ipv4_
address str An IPv4 address to identify the switch. This is mostly useful when used with the Netflow arguments.
- iscsi_
maximum_ intmbit The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
- iscsi_
reservation_ intmbit The amount of guaranteed bandwidth for the iSCSI traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the iSCSI traffic class for a custom share level.
- str
The allocation level for the iSCSI traffic class. Can be one of high, low, normal, or custom.
- lacp_
api_ strversion The Link Aggregation Control Protocol group version to use with the VDS. Possible values are
singleLag
andmultipleLag
.- lacp_
enabled bool Enables LACP for the ports that this policy applies to.
- lacp_
mode str The LACP mode. Can be one of
active
orpassive
.- link_
discovery_ stroperation Whether to
advertise
orlisten
for link discovery traffic.- link_
discovery_ strprotocol The discovery protocol type. Valid types are
cdp
andlldp
.- management_
maximum_ intmbit The maximum allowed usage for the management traffic class, in Mbits/sec.
- management_
reservation_ intmbit The amount of guaranteed bandwidth for the management traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the management traffic class for a custom share level.
- str
The allocation level for the management traffic class. Can be one of high, low, normal, or custom.
- max_
mtu int The maximum transmission unit (MTU) for the VDS.
- multicast_
filtering_ strmode The multicast filtering mode to use with the VDS. Can be one of
legacyFiltering
orsnooping
.- name str
The name of the VDS.
- netflow_
active_ intflow_ timeout The number of seconds after which active flows are forced to be exported to the collector. Allowed range is
60
to3600
. Default:60
.- netflow_
collector_ strip_ address IP address for the Netflow collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later. Must be set before Netflow can be enabled.
- netflow_
collector_ intport Port for the Netflow collector. This must be set before Netflow can be enabled.
- netflow_
enabled bool Enables Netflow on all ports that this policy applies to.
- netflow_
idle_ intflow_ timeout The number of seconds after which idle flows are forced to be exported to the collector. Allowed range is
10
to600
. Default:15
.- netflow_
internal_ boolflows_ only Whether to limit analysis to traffic that has both source and destination served by the same host. Default:
false
.- netflow_
observation_ intdomain_ id The observation domain ID for the Netflow collector.
- netflow_
sampling_ intrate The ratio of total number of packets to the number of packets analyzed. The default is
0
, which indicates that the VDS should analyze all packets. The maximum value is1000
, which indicates an analysis rate of 0.001%.- network_
resource_ boolcontrol_ enabled Set to
true
to enable network I/O control. Default:false
.- network_
resource_ strcontrol_ version The version of network I/O control to use. Can be one of
version2
orversion3
. Default:version2
.- nfs_
maximum_ intmbit The maximum allowed usage for the nfs traffic class, in Mbits/sec.
- nfs_
reservation_ intmbit The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the nfs traffic class for a custom share level.
- str
The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
- notify_
switches bool If
true
, the teaming policy will notify the broadcast network of an uplink failover, triggering cache updates.- port_
private_ intsecondary_ vlan_ id Used to define a secondary VLAN ID when using private VLANs.
- pvlan_
mappings Sequence[DistributedVirtual Switch Pvlan Mapping Args] Use the
pvlan_mapping
block to declare a private VLAN mapping. The options are:- standby_
uplinks Sequence[str] A list of standby uplinks to be used in failover. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- Sequence[str]
The IDs of any tags to attach to this resource.
NOTE: Tagging support requires vCenter Server 6.0 or higher.
- teaming_
policy str The uplink teaming policy. Can be one of
loadbalance_ip
,loadbalance_srcmac
,loadbalance_srcid
,failover_explicit
, orloadbalance_loadbased
.- tx_
uplink bool Forward all traffic transmitted by ports for which this policy applies to its VDS uplinks.
- uplinks Sequence[str]
A list of strings that uniquely identifies the names of the uplinks on the VDS across hosts. The number of items in this list controls the number of uplinks that exist on the VDS, in addition to the names. See here for an example on how to use this option.
- vdp_
maximum_ intmbit The maximum allowed usage for the vdp traffic class, in Mbits/sec.
- vdp_
reservation_ intmbit The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vdp traffic class for a custom share level.
- str
The allocation level for the vdp traffic class. Can be one of high, low, normal, or custom.
- version str
The version of the VDS. BY default, a VDS is created at the latest version supported by the vSphere version if not specified. A VDS can be upgraded to a newer version, but can not be downgraded.
- virtualmachine_
maximum_ intmbit The maximum allowed usage for the virtualMachine traffic class, in Mbits/sec.
- virtualmachine_
reservation_ intmbit The amount of guaranteed bandwidth for the virtualMachine traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
- str
The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
- vlan_
id int The VLAN ID for single VLAN mode. 0 denotes no VLAN.
- vlan_
ranges Sequence[DistributedVirtual Switch Vlan Range Args] Used to denote VLAN trunking. Use the
min_vlan
andmax_vlan
sub-arguments to define the tagged VLAN range. Multiplevlan_range
definitions are allowed, but they must not overlap. Example below:import * as pulumi from "@pulumi/pulumi"; import * as vsphere from "@pulumi/vsphere";
const vds = new vsphere.DistributedVirtualSwitch("vds", {vlanRanges: [ { maxVlan: 199, minVlan: 100, }, { maxVlan: 399, minVlan: 300, }, ]});
import pulumi import pulumi_vsphere as vsphere vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[ vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=199, min_vlan=100, ), vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=399, min_vlan=300, ), ])
using System.Collections.Generic; using System.Linq; using Pulumi; using VSphere = Pulumi.VSphere; return await Deployment.RunAsync(() => { var vds = new VSphere.DistributedVirtualSwitch("vds", new() { VlanRanges = new[] { new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 199, MinVlan = 100, }, new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 399, MinVlan = 300, }, }, }); });
package main import ( "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" "github.com/pulumi/pulumi/sdk/v3/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := vsphere.NewDistributedVirtualSwitch(ctx, "vds", &vsphere.DistributedVirtualSwitchArgs{ VlanRanges: vsphere.DistributedVirtualSwitchVlanRangeArray{ &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(199), MinVlan: pulumi.Int(100), }, &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(399), MinVlan: pulumi.Int(300), }, }, }) if err != nil { return err } return nil }) }
package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.vsphere.DistributedVirtualSwitch; import com.pulumi.vsphere.DistributedVirtualSwitchArgs; import com.pulumi.vsphere.inputs.DistributedVirtualSwitchVlanRangeArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var vds = new DistributedVirtualSwitch("vds", DistributedVirtualSwitchArgs.builder() .vlanRanges( DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(199) .minVlan(100) .build(), DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(399) .minVlan(300) .build()) .build()); } }
resources: vds: type: vsphere:DistributedVirtualSwitch properties: vlanRanges: - maxVlan: 199 minVlan: 100 - maxVlan: 399 minVlan: 300
- vmotion_
maximum_ intmbit The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
- vmotion_
reservation_ intmbit The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vmotion traffic class for a custom share level.
- str
The allocation level for the vmotion traffic class. Can be one of high, low, normal, or custom.
- vsan_
maximum_ intmbit The maximum allowed usage for the vsan traffic class, in Mbits/sec.
- vsan_
reservation_ intmbit The amount of guaranteed bandwidth for the vsan traffic class, in Mbits/sec.
- int
The amount of shares to allocate to the vsan traffic class for a custom share level.
- str
The allocation level for the vsan traffic class. Can be one of high, low, normal, or custom.
- active
Uplinks List<String> A list of active uplinks to be used in load balancing. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- allow
Forged BooleanTransmits Controls whether or not a virtual network adapter is allowed to send network traffic with a different MAC address than that of its own.
- allow
Mac BooleanChanges Controls whether or not the Media Access Control (MAC) address can be changed.
- allow
Promiscuous Boolean Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
- backupnfc
Maximum NumberMbit The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
- backupnfc
Reservation NumberMbit The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the backupNfc traffic class for a custom share level.
- String
The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
- block
All BooleanPorts Shuts down all ports in the port groups that this policy applies to, effectively blocking all network access to connected virtual devices.
- check
Beacon Boolean Enables beacon probing as an additional measure to detect NIC failure.
NOTE: VMware recommends using a minimum of 3 NICs when using beacon probing.
- config
Version String The current version of the VDS configuration, incremented by subsequent updates to the VDS.
- contact
Detail String The detailed contact information for the person who is responsible for the VDS.
- contact
Name String The name of the person who is responsible for the VDS.
- custom
Attributes Map<String> Map of custom attribute ids to attribute value strings to set for VDS.
NOTE: Custom attributes are unsupported on direct ESXi host connections and requires vCenter Server.
- datacenter
Id String The ID of the datacenter where the VDS will be created. Forces a new resource if changed.
- description String
A detailed description for the VDS.
- directpath
Gen2Allowed Boolean Allow VMDirectPath Gen2 for the ports for which this policy applies to.
- egress
Shaping NumberAverage Bandwidth The average bandwidth in bits per second if egress traffic shaping is enabled on the port.
- egress
Shaping NumberBurst Size The maximum burst size allowed in bytes if egress traffic shaping is enabled on the port.
- egress
Shaping BooleanEnabled true
if the traffic shaper is enabled on the port for egress traffic.- egress
Shaping NumberPeak Bandwidth The peak bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
- failback Boolean
If
true
, the teaming policy will re-activate failed uplinks higher in precedence when they come back up.- faulttolerance
Maximum NumberMbit The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
- faulttolerance
Reservation NumberMbit The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
- String
The allocation level for the faultTolerance traffic class. Can be one of high, low, normal, or custom.
- folder String
The folder in which to create the VDS. Forces a new resource if changed.
- hbr
Maximum NumberMbit The maximum allowed usage for the hbr traffic class, in Mbits/sec.
- hbr
Reservation NumberMbit The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the hbr traffic class for a custom share level.
- String
The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
- hosts List<Property Map>
Use the
host
block to declare a host specification. The options are:- ignore
Other BooleanPvlan Mappings Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
- ingress
Shaping NumberAverage Bandwidth The average bandwidth in bits per second if ingress traffic shaping is enabled on the port.
- ingress
Shaping NumberBurst Size The maximum burst size allowed in bytes if ingress traffic shaping is enabled on the port.
- ingress
Shaping BooleanEnabled true
if the traffic shaper is enabled on the port for ingress traffic.- ingress
Shaping NumberPeak Bandwidth The peak bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
- ipv4Address String
An IPv4 address to identify the switch. This is mostly useful when used with the Netflow arguments.
- iscsi
Maximum NumberMbit The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
- iscsi
Reservation NumberMbit The amount of guaranteed bandwidth for the iSCSI traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the iSCSI traffic class for a custom share level.
- String
The allocation level for the iSCSI traffic class. Can be one of high, low, normal, or custom.
- lacp
Api StringVersion The Link Aggregation Control Protocol group version to use with the VDS. Possible values are
singleLag
andmultipleLag
.- lacp
Enabled Boolean Enables LACP for the ports that this policy applies to.
- lacp
Mode String The LACP mode. Can be one of
active
orpassive
.- link
Discovery StringOperation Whether to
advertise
orlisten
for link discovery traffic.- link
Discovery StringProtocol The discovery protocol type. Valid types are
cdp
andlldp
.- management
Maximum NumberMbit The maximum allowed usage for the management traffic class, in Mbits/sec.
- management
Reservation NumberMbit The amount of guaranteed bandwidth for the management traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the management traffic class for a custom share level.
- String
The allocation level for the management traffic class. Can be one of high, low, normal, or custom.
- max
Mtu Number The maximum transmission unit (MTU) for the VDS.
- multicast
Filtering StringMode The multicast filtering mode to use with the VDS. Can be one of
legacyFiltering
orsnooping
.- name String
The name of the VDS.
- netflow
Active NumberFlow Timeout The number of seconds after which active flows are forced to be exported to the collector. Allowed range is
60
to3600
. Default:60
.- netflow
Collector StringIp Address IP address for the Netflow collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later. Must be set before Netflow can be enabled.
- netflow
Collector NumberPort Port for the Netflow collector. This must be set before Netflow can be enabled.
- netflow
Enabled Boolean Enables Netflow on all ports that this policy applies to.
- netflow
Idle NumberFlow Timeout The number of seconds after which idle flows are forced to be exported to the collector. Allowed range is
10
to600
. Default:15
.- netflow
Internal BooleanFlows Only Whether to limit analysis to traffic that has both source and destination served by the same host. Default:
false
.- netflow
Observation NumberDomain Id The observation domain ID for the Netflow collector.
- netflow
Sampling NumberRate The ratio of total number of packets to the number of packets analyzed. The default is
0
, which indicates that the VDS should analyze all packets. The maximum value is1000
, which indicates an analysis rate of 0.001%.- network
Resource BooleanControl Enabled Set to
true
to enable network I/O control. Default:false
.- network
Resource StringControl Version The version of network I/O control to use. Can be one of
version2
orversion3
. Default:version2
.- nfs
Maximum NumberMbit The maximum allowed usage for the nfs traffic class, in Mbits/sec.
- nfs
Reservation NumberMbit The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the nfs traffic class for a custom share level.
- String
The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
- notify
Switches Boolean If
true
, the teaming policy will notify the broadcast network of an uplink failover, triggering cache updates.- port
Private NumberSecondary Vlan Id Used to define a secondary VLAN ID when using private VLANs.
- pvlan
Mappings List<Property Map> Use the
pvlan_mapping
block to declare a private VLAN mapping. The options are:- standby
Uplinks List<String> A list of standby uplinks to be used in failover. These uplinks need to match the definitions in the
uplinks
VDS argument. See here for more details.- List<String>
The IDs of any tags to attach to this resource.
NOTE: Tagging support requires vCenter Server 6.0 or higher.
- teaming
Policy String The uplink teaming policy. Can be one of
loadbalance_ip
,loadbalance_srcmac
,loadbalance_srcid
,failover_explicit
, orloadbalance_loadbased
.- tx
Uplink Boolean Forward all traffic transmitted by ports for which this policy applies to its VDS uplinks.
- uplinks List<String>
A list of strings that uniquely identifies the names of the uplinks on the VDS across hosts. The number of items in this list controls the number of uplinks that exist on the VDS, in addition to the names. See here for an example on how to use this option.
- vdp
Maximum NumberMbit The maximum allowed usage for the vdp traffic class, in Mbits/sec.
- vdp
Reservation NumberMbit The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the vdp traffic class for a custom share level.
- String
The allocation level for the vdp traffic class. Can be one of high, low, normal, or custom.
- version String
The version of the VDS. BY default, a VDS is created at the latest version supported by the vSphere version if not specified. A VDS can be upgraded to a newer version, but can not be downgraded.
- virtualmachine
Maximum NumberMbit The maximum allowed usage for the virtualMachine traffic class, in Mbits/sec.
- virtualmachine
Reservation NumberMbit The amount of guaranteed bandwidth for the virtualMachine traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
- String
The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
- vlan
Id Number The VLAN ID for single VLAN mode. 0 denotes no VLAN.
- vlan
Ranges List<Property Map> Used to denote VLAN trunking. Use the
min_vlan
andmax_vlan
sub-arguments to define the tagged VLAN range. Multiplevlan_range
definitions are allowed, but they must not overlap. Example below:import * as pulumi from "@pulumi/pulumi"; import * as vsphere from "@pulumi/vsphere";
const vds = new vsphere.DistributedVirtualSwitch("vds", {vlanRanges: [ { maxVlan: 199, minVlan: 100, }, { maxVlan: 399, minVlan: 300, }, ]});
import pulumi import pulumi_vsphere as vsphere vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[ vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=199, min_vlan=100, ), vsphere.DistributedVirtualSwitchVlanRangeArgs( max_vlan=399, min_vlan=300, ), ])
using System.Collections.Generic; using System.Linq; using Pulumi; using VSphere = Pulumi.VSphere; return await Deployment.RunAsync(() => { var vds = new VSphere.DistributedVirtualSwitch("vds", new() { VlanRanges = new[] { new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 199, MinVlan = 100, }, new VSphere.Inputs.DistributedVirtualSwitchVlanRangeArgs { MaxVlan = 399, MinVlan = 300, }, }, }); });
package main import ( "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" "github.com/pulumi/pulumi/sdk/v3/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := vsphere.NewDistributedVirtualSwitch(ctx, "vds", &vsphere.DistributedVirtualSwitchArgs{ VlanRanges: vsphere.DistributedVirtualSwitchVlanRangeArray{ &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(199), MinVlan: pulumi.Int(100), }, &vsphere.DistributedVirtualSwitchVlanRangeArgs{ MaxVlan: pulumi.Int(399), MinVlan: pulumi.Int(300), }, }, }) if err != nil { return err } return nil }) }
package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.vsphere.DistributedVirtualSwitch; import com.pulumi.vsphere.DistributedVirtualSwitchArgs; import com.pulumi.vsphere.inputs.DistributedVirtualSwitchVlanRangeArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var vds = new DistributedVirtualSwitch("vds", DistributedVirtualSwitchArgs.builder() .vlanRanges( DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(199) .minVlan(100) .build(), DistributedVirtualSwitchVlanRangeArgs.builder() .maxVlan(399) .minVlan(300) .build()) .build()); } }
resources: vds: type: vsphere:DistributedVirtualSwitch properties: vlanRanges: - maxVlan: 199 minVlan: 100 - maxVlan: 399 minVlan: 300
- vmotion
Maximum NumberMbit The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
- vmotion
Reservation NumberMbit The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the vmotion traffic class for a custom share level.
- String
The allocation level for the vmotion traffic class. Can be one of high, low, normal, or custom.
- vsan
Maximum NumberMbit The maximum allowed usage for the vsan traffic class, in Mbits/sec.
- vsan
Reservation NumberMbit The amount of guaranteed bandwidth for the vsan traffic class, in Mbits/sec.
- Number
The amount of shares to allocate to the vsan traffic class for a custom share level.
- String
The allocation level for the vsan traffic class. Can be one of high, low, normal, or custom.
Supporting Types
DistributedVirtualSwitchHost, DistributedVirtualSwitchHostArgs
- Host
System stringId The host system ID of the host to add to the VDS.
- Devices List<string>
The list of NIC devices to map to uplinks on the VDS, added in order they are specified.
- Host
System stringId The host system ID of the host to add to the VDS.
- Devices []string
The list of NIC devices to map to uplinks on the VDS, added in order they are specified.
- host
System StringId The host system ID of the host to add to the VDS.
- devices List<String>
The list of NIC devices to map to uplinks on the VDS, added in order they are specified.
- host
System stringId The host system ID of the host to add to the VDS.
- devices string[]
The list of NIC devices to map to uplinks on the VDS, added in order they are specified.
- host_
system_ strid The host system ID of the host to add to the VDS.
- devices Sequence[str]
The list of NIC devices to map to uplinks on the VDS, added in order they are specified.
- host
System StringId The host system ID of the host to add to the VDS.
- devices List<String>
The list of NIC devices to map to uplinks on the VDS, added in order they are specified.
DistributedVirtualSwitchPvlanMapping, DistributedVirtualSwitchPvlanMappingArgs
- Primary
Vlan intId The primary VLAN ID. The VLAN IDs of 0 and 4095 are reserved and cannot be used in this property.
- Pvlan
Type string The private VLAN type. Valid values are promiscuous, community and isolated.
- Secondary
Vlan intId The secondary VLAN ID. The VLAN IDs of 0 and 4095 are reserved and cannot be used in this property.
- Primary
Vlan intId The primary VLAN ID. The VLAN IDs of 0 and 4095 are reserved and cannot be used in this property.
- Pvlan
Type string The private VLAN type. Valid values are promiscuous, community and isolated.
- Secondary
Vlan intId The secondary VLAN ID. The VLAN IDs of 0 and 4095 are reserved and cannot be used in this property.
- primary
Vlan IntegerId The primary VLAN ID. The VLAN IDs of 0 and 4095 are reserved and cannot be used in this property.
- pvlan
Type String The private VLAN type. Valid values are promiscuous, community and isolated.
- secondary
Vlan IntegerId The secondary VLAN ID. The VLAN IDs of 0 and 4095 are reserved and cannot be used in this property.
- primary
Vlan numberId The primary VLAN ID. The VLAN IDs of 0 and 4095 are reserved and cannot be used in this property.
- pvlan
Type string The private VLAN type. Valid values are promiscuous, community and isolated.
- secondary
Vlan numberId The secondary VLAN ID. The VLAN IDs of 0 and 4095 are reserved and cannot be used in this property.
- primary_
vlan_ intid The primary VLAN ID. The VLAN IDs of 0 and 4095 are reserved and cannot be used in this property.
- pvlan_
type str The private VLAN type. Valid values are promiscuous, community and isolated.
- secondary_
vlan_ intid The secondary VLAN ID. The VLAN IDs of 0 and 4095 are reserved and cannot be used in this property.
- primary
Vlan NumberId The primary VLAN ID. The VLAN IDs of 0 and 4095 are reserved and cannot be used in this property.
- pvlan
Type String The private VLAN type. Valid values are promiscuous, community and isolated.
- secondary
Vlan NumberId The secondary VLAN ID. The VLAN IDs of 0 and 4095 are reserved and cannot be used in this property.
DistributedVirtualSwitchVlanRange, DistributedVirtualSwitchVlanRangeArgs
Package Details
- Repository
- vSphere pulumi/pulumi-vsphere
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
vsphere
Terraform Provider.