VmHardwareEthernetCreateSpec

The Ethernet.CreateSpec structure provides a specification for the configuration of a newly-created virtual Ethernet adapter.


Properties

boolean
allow_guest_control Optional

Flag indicating whether the guest can connect and disconnect the device. Defaults to false if unset.


backing Optional

Physical resource backing for the virtual Ethernet adapter. If unset, the system may try to find an appropriate backing. If one is not found, the request will fail.


string
mac_address Optional

MAC address. Workaround for PR1459647


mac_type Optional

The Ethernet.MacAddressType enumerated type defines the valid MAC address origins for a virtual Ethernet adapter.
MANUAL : MAC address is assigned statically.
GENERATED : MAC address is generated automatically.
ASSIGNED : MAC address is assigned by vCenter Server.

Possible values are: MANUALGENERATEDASSIGNED


integer as int64
pci_slot_number Optional

Address of the virtual Ethernet adapter on the PCI bus. If the PCI address is invalid, the server will change when it the VM is started or as the device is hot added. If unset, the server will choose an available address when the virtual machine is powered on.


boolean
start_connected Optional

Flag indicating whether the virtual device should be connected whenever the virtual machine is powered on. Defaults to false if unset.


type Optional

The Ethernet.EmulationType enumerated type defines the valid emulation types for a virtual Ethernet adapter.
E1000 : E1000 ethernet adapter.
E1000E : E1000e ethernet adapter.
PCNET32 : AMD Lance PCNet32 Ethernet adapter.
VMXNET : VMware Vmxnet virtual Ethernet adapter.
VMXNET2 : VMware Vmxnet2 virtual Ethernet adapter.
VMXNET3 : VMware Vmxnet3 virtual Ethernet adapter.

Possible values are: E1000E1000EPCNET32VMXNETVMXNET2VMXNET3


boolean
upt_compatibility_enabled Optional

Flag indicating whether Universal Pass-Through (UPT) compatibility is enabled on this virtual Ethernet adapter. If unset, UPT will not be enabled on the newly-created virtual Ethernet adapter.


boolean
wake_on_lan_enabled Optional

Flag indicating whether wake-on-LAN is enabled on this virtual Ethernet adapter. Defaults to false if unset.

JSON Example

{
	"allow_guest_control": false,
	"backing": {
		"distributed_port": "string",
		"network": "string",
		"type": "STANDARD_PORTGROUP"
	},
	"mac_address": "string",
	"mac_type": "MANUAL",
	"pci_slot_number": 0,
	"start_connected": false,
	"type": "E1000",
	"upt_compatibility_enabled": false,
	"wake_on_lan_enabled": false
}

Feedback

Was this page helpful?