Vm_Hardware_Ethernet_UpdateSpec

The Ethernet.UpdateSpec structure describes the updates to be made to the configuration of a virtual Ethernet adapter.

JSON Example

{
    "upt_compatibility_enabled": false,
    "upt_v2_compatibility_enabled": false,
    "mac_type": "string",
    "mac_address": "string",
    "wake_on_lan_enabled": false,
    "backing": {
        "type": "string",
        "network": "string",
        "distributed_port": "string"
    },
    "start_connected": false,
    "allow_guest_control": false
}

boolean

upt_compatibility_enabled

Optional

Flag indicating whether Universal Pass-Through (UPT) compatibility should be enabled on this virtual Ethernet adapter. This field may be modified at any time, and changes will be applied the next time the virtual machine is powered on.

If unset, the value is unchanged. Must be unset if the emulation type of the virtual Ethernet adapter is not VMXNET3.

boolean

upt_v2_compatibility_enabled

Optional

Flag indicates whether Uniform Pass-through version 2(UPTv2) compatibility is enabled on this network adapter. To enable this feature, the network adapter must connect to a network backed by DPU (Data Processing Unit) and network offloading must be enabled on the network. This field can be only modified when virtual machine is powered off. If unset, the value is unchanged. Must be unset if the emulation type of the virtual Ethernet adapter is not VMXNET3.

Vm_Hardware_Ethernet_MacAddressType

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.

string

mac_address

Optional

MAC address. This field may be modified at any time, and changes will be applied the next time the virtual machine is powered on.

If unset, the value is unchanged. Must be specified if Ethernet.UpdateSpec.mac-type is MANUAL. Must be unset if the MAC address type is not MANUAL.

boolean

wake_on_lan_enabled

Optional

Flag indicating whether wake-on-LAN shoud be enabled on this virtual Ethernet adapter. This field may be modified at any time, and changes will be applied the next time the virtual machine is powered on.

If unset, the value is unchanged.

Vm_Hardware_Ethernet_BackingSpec

backing

Optional

The Ethernet.BackingSpec structure provides a specification of the physical resource that backs a virtual Ethernet adapter.

boolean

start_connected

Optional

Flag indicating whether the virtual device should be connected whenever the virtual machine is powered on. If unset, the value is unchanged.

boolean

allow_guest_control

Optional

Flag indicating whether the guest can connect and disconnect the device. If unset, the value is unchanged.