VMware Cloud Director API - NetworkConnection

NetworkConnectionType

Element:

NetworkConnection

Type:

NetworkConnectionType

Namespace:

http://www.vmware.com/vcloud/v1.5

Description:

Represents a network connection in the virtual machine.

Since:

0.9

Schema:

vApp.xsd

Media type(s):

None

Extends:

VCloudExtensibleType

XML Representation:

<NetworkConnection xmlns="http://www.vmware.com/vcloud/v1.5" network="xs:string" needsCustomization="xs:boolean">
    <NetworkConnectionIndex> xs:int </NetworkConnectionIndex>
    <IpAddress> IpAddressType </IpAddress>
    <IpType> IpTypeType </IpType>
    <SecondaryIpAddress> xs:string </SecondaryIpAddress>
    <SecondaryIpType> IpTypeType </SecondaryIpType>
    <ExternalIpAddress> IpAddressType </ExternalIpAddress>
    <IsConnected> xs:boolean </IsConnected>
    <MACAddress> xs:string </MACAddress>
    <IpAddressAllocationMode> xs:string </IpAddressAllocationMode>
    <SecondaryIpAddressAllocationMode> xs:string </SecondaryIpAddressAllocationMode>
    <NetworkAdapterType> xs:string </NetworkAdapterType>
</NetworkConnection>

Attributes

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.

Elements

Element	Type	Required	Modifiable	Since	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.)
IpType	IpTypeType	No		34.0	Type of the IP address assigned to this NIC.
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) SRIOVETHERNETCARD (Single Root I/O Virtualization virtual NIC, see https://kb.vmware.com/s/article/2038739)
NetworkConnectionIndex	int	Yes	always	0.9	Virtual slot number associated with this NIC. First slot number is 0.
SecondaryIpAddress	string	No	always	34.0	Secondary IP address associated with this NIC.
SecondaryIpAddressAllocationMode	string	No	always	34.0	Secondary IP address allocation mode for the secondary IP address associated with 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.)
SecondaryIpType	IpTypeType	No		34.0	Type of the secondary IP address assigned to this NIC. This will be populated with 'IPv6' for dual stack networks, even if there is no secondary IP.
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.