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


distributed_port Optional

Key of the distributed virtual port that backs the virtual Ethernet adapter. Depending on the type of the Portgroup, the port may be specified using this field. If the portgroup type is early-binding (also known as static), a port is assigned when the Ethernet adapter is configured to use the port. The port may be either automatically or specifically assigned based on the value of this field. If the portgroup type is ephemeral, the port is created and assigned to a virtual machine when it is powered on and the Ethernet adapter is connected. This field cannot be specified as no free ports exist before use. May be used to specify a port when the network specified on the Ethernet.BackingSpec.network field is a static or early binding distributed portgroup. If unset, the port will be automatically assigned to the Ethernet adapter based on the policy embodied by the portgroup type.

network Optional

Identifier of the network that backs the virtual Ethernet adapter. This field is optional and it is only relevant when the value of Ethernet.BackingSpec.type is one of STANDARD_PORTGROUP, DISTRIBUTED_PORTGROUP, or OPAQUE_NETWORK. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: Network. When operations return a value of this structure as a result, the field will be an identifier for the resource type: Network.

type Required

The Ethernet.BackingType enumerated type defines the valid backing types for a virtual Ethernet adapter.
STANDARD_PORTGROUP : vSphere standard portgroup network backing.
HOST_DEVICE : Legacy host device network backing. Imported VMs may have virtual Ethernet adapters with this type of backing, but this type of backing cannot be used to create or to update a virtual Ethernet adapter.
DISTRIBUTED_PORTGROUP : Distributed virtual switch backing.
OPAQUE_NETWORK : Opaque network backing.


JSON Example



Was this page helpful?