.. _int: https://docs.python.org/2/library/stdtypes.html

.. _str: https://docs.python.org/2/library/stdtypes.html

.. _uuid: ../../vim/DistributedVirtualSwitch.rst#uuid

.. _pnic: ../../vim/host/NetworkInfo.rst#pnic

.. _portKey: ../../vim/dvs/PortConnection.rst#portKey

.. _portgroupKey: ../../vim/dvs/PortConnection.rst#portgroupKey

.. _HostVirtualNic: ../../vim/host/VirtualNic.rst

.. _HostNetworkInfo: ../../vim/host/NetworkInfo.rst

.. _vSphere API 4.0: ../../vim/version.rst#vimversionversion5

.. _connectionCookie: ../../vim/dvs/DistributedVirtualPort.rst#connectionCookie

.. _vmodl.DynamicData: ../../vmodl/DynamicData.rst

.. _DistributedVirtualPort: ../../vim/dvs/DistributedVirtualPort.rst

.. _DistributedVirtualSwitch: ../../vim/DistributedVirtualSwitch.rst

.. _DistributedVirtualPortgroup: ../../vim/dvs/DistributedVirtualPortgroup.rst

.. _DistributedVirtualSwitchPortConnection: ../../vim/dvs/PortConnection.rst

.. _VirtualEthernetCardDistributedVirtualPortBackingInfo: ../../vim/vm/device/VirtualEthernetCard/DistributedVirtualPortBackingInfo.rst


vim.dvs.PortConnection
======================
  The `DistributedVirtualSwitchPortConnection`_ data object represents a connection or association between a `DistributedVirtualPortgroup`_ or a `DistributedVirtualPort`_ and one of the following entities:
   * Virtual machine virtual NIC (
   * `VirtualEthernetCardDistributedVirtualPortBackingInfo`_
   * )
   * Host virtual NIC (
   * `HostVirtualNic`_
   * )
   * Physical NIC (
   * `HostNetworkInfo`_
   * .
   * `pnic`_
   * )
:extends: vmodl.DynamicData_
:since: `vSphere API 4.0`_

Attributes:
    switchUuid (`str`_):

       UUID of the switch ( `DistributedVirtualSwitch`_ . `uuid`_ ).
    portgroupKey (`str`_, optional):

       Key of the portgroup. If specified, the connection object represents a connection or an association between a `DistributedVirtualPortgroup`_ and a Virtual NIC or physical NIC. In this case, setting the `portKey`_ is not necessary for a early-binding portgroup and is not allowed for a late-binding portgroup. The `portKey`_ property will be populated by the implementation at the time of port binding.
    portKey (`str`_, optional):

       Key of the port. If specified, this object represents a connection or an association between an individual `DistributedVirtualPort`_ and a Virtual NIC or physical NIC. See `portgroupKey`_ for more information on populating this property.
    connectionCookie (`int`_, optional):

       Cookie that represents this `DistributedVirtualSwitchPortConnection`_ instance for the port. The cookie value is generated by the Server. The Server ignores any value set by an SDK client.The same cookie is present in the distributed virtual port configuration ( `DistributedVirtualPort`_ . `connectionCookie`_ ) so that the Server can verify that the entity is the rightful connectee of the port.