Data Object - DistributedVirtualPort(vim.dvs.DistributedVirtualPort)

Returned by
FetchDVPorts
Extends
DynamicData
See also
DistributedVirtualSwitchPortConnectee, DVPortConfigInfo, DVPortState, HostSystem
Since
vSphere API 4.0

Data Object Description

The DistributedVirtualPort data object represents a port in a DistributedVirtualSwitch. Virtual ports are part of a distributed virtual portgroup. Servers create virtual ports according to the portgroup type (DistributedVirtualPortgroup.Config.type). See DistributedVirtualPortgroupPortgroupType.

Properties

Name Type Description
configDVPortConfigInfo

Port configuration, including identifying information, network settings, and the set of entities that can connect to the port.
conflictxsd:boolean

Specifies whether the port is a conflict port. A port could be marked as conflict if an entity is discovered connecting to a port that is already occupied, or if the host creates a port without conferring with vCenter Server.

The distributed virtual switch does not persist the runtime state of a conflict port. Also, the port cannot move away from the host. vCenter Server will not move a virtual machine (VMotion) that is using a conflict port.

conflictPortKey*xsd:string

If the port is marked conflict in the case of two entities connecting to the same port (see conflict), this is the key of the port which the connected entity is contending for.
connectee*DistributedVirtualSwitchPortConnectee

Entity that connects to the port.
connectionCookie*xsd:int

Cookie representing the current instance of association between a port and a virtual or physical NIC. See DistributedVirtualSwitchPortConnection. The same cookie is present in the physical or virtual NIC configuration (DistributedVirtualSwitchPortConnection.connectionCookie) so that the Server can verify that the entity is the rightful connectee of the port.
dvsUuidxsd:string

UUID of the DistributedVirtualSwitch to which the port belongs.
externalId*xsd:string

Populate the Id assigned to vmknic or vnic by external management plane to port, if the port is connected to the nics.

Since vSphere API 7.0
hostLocalPort*xsd:boolean

Specifies whether the port is a host local port. A host local port is created to resurrect the management network connection on a VMkernel virtual NIC. You cannot use vCenter Server to reconfigure this port and you cannot reassign the port.

Since vSphere API 5.1
keyxsd:string

Port key.
lastStatusChangexsd:dateTime

The last time the state.runtimeInfo value was changed.
portgroupKey*xsd:string

Key of the portgroup DistributedVirtualPortgroup to which the port belongs, if any.
proxyHost*ManagedObjectReference
to a HostSystem

HostSystem that services this port.
segmentPortId*xsd:string

Populate the segmentPortId assigned to LSP.

Since vSphere API 7.0
state*DVPortState

Runtime state of the port.
Properties inherited from DynamicData
None
*Need not be set
Show WSDL type definition