Represents a network connection in the virtual machine.
Media type(s):
XML Representation:
<NetworkConnection xmlns="" network="xs:string" needsCustomization="xs:boolean">
    <VCloudExtension required="xs:boolean"/>
    <NetworkConnectionIndex> xs:int </NetworkConnectionIndex>
    <IpAddress> IpAddressType </IpAddress>
    <ExternalIpAddress> IpAddressType </ExternalIpAddress>
    <IsConnected> xs:boolean </IsConnected>
    <MACAddress> xs:string </MACAddress>
    <IpAddressAllocationMode> xs:string </IpAddressAllocationMode>
    <NetworkAdapterType> xs:string </NetworkAdapterType>


Attribute Type Required Modifiable Since Deprecated Description
network string Yes always 0.9 Name of the network to which this NIC is connected.
needsCustomization boolean No none 0.9 True if this NIC needs customization.


Element Type Required Modifiable Since Deprecated Description
ExternalIpAddress IpAddressType No none 0.9 If the network to which this NIC connects provides NAT services, the external address assigned to this NIC appears here.
IpAddress IpAddressType No always 0.9 IP address assigned to this NIC.
IpAddressAllocationMode string Yes always 0.9 IP address allocation mode for this connection. One of:
POOL (A static IP address is allocated automatically from a pool of addresses.)
DHCP (The IP address is obtained from a DHCP service.)
MANUAL (The IP address is assigned manually in the IpAddress element.)
NONE (No IP addressing mode specified.)
IsConnected boolean Yes always 0.9 If the virtual machine is undeployed, this value specifies whether the NIC should be connected upon deployment. If the virtual machine is deployed, this value reports the current status of this NIC's connection, and can be updated to change that connection status.
MACAddress string No always 0.9 MAC address associated with the NIC.
NetworkAdapterType string No always 5.11 Type of network adapter to be used for this connection. One of:
VLANCE (emulated version of the AMD 79C970 PCnet32-LANCE NIC)
E1000 (emulated version of the Intel 82545EM Gigabit Ethernet NIC)
E1000E (emulates a newer model of Intel Gigabit NIC (number 82574))
VMXNET (has no physical counterpart; optimized for performance in a virtual machine)
VMXNET2 (based on the VMXNET adapter but provides some high-performance features)
VMXNET3 (next generation of a paravirtualized NIC designed for performance; not related to VMXNET or VMXNET2)
FLEXIBLE (identifies itself as a Vlance adapter when a virtual machine boots, but initializes itself and functions as either a Vlance or a VMXNET adapter, depending on which driver initializes it)
NetworkConnectionIndex int Yes always 0.9 Virtual slot number associated with this NIC. First slot number is 0.
VCloudExtension VCloudExtensionType No always 0.9 An optional extension element that can contain an arbitrary number of elements and attributes. Not related to extension services.