VirtualMachineDeviceRuntimeInfoVirtualEthernetCardRuntimeState

VirtualMachineDeviceRuntimeInfoVirtualEthernetCardRuntimeState
VirtualMachineDeviceRuntimeInfoVirtualEthernetCardRuntimeState

Runtime state of a virtual ethernet card device.

AllOf
This class requires all of the following:
JSON Example
{
    "_typeName": "string",
    "vmDirectPathGen2Active": false,
    "vmDirectPathGen2InactiveReasonVm": [
        "string"
    ],
    "vmDirectPathGen2InactiveReasonOther": [
        "string"
    ],
    "vmDirectPathGen2InactiveReasonExtended": "string",
    "uptv2Active": false,
    "uptv2InactiveReasonVm": [
        "string"
    ],
    "uptv2InactiveReasonOther": [
        "string"
    ],
    "reservationStatus": "string",
    "attachmentStatus": "string",
    "featureRequirement": [
        {
            "_typeName": "string",
            "key": "string",
            "featureName": "string",
            "value": "string"
        }
    ]
}
boolean
vmDirectPathGen2Active
Optional

Deprecated as of vSphere API 8.0. VMDirectPath Gen 2 is no longer supported and there is no replacement.

Flag to indicate whether VMDirectPath Gen 2 is active on this device.

If false, the reason(s) for inactivity will be provided in one or more of vmDirectPathGen2InactiveReasonVm, vmDirectPathGen2InactiveReasonOther, and vmDirectPathGen2InactiveReasonExtended.

array of string
vmDirectPathGen2InactiveReasonVm
Optional

Deprecated as of vSphere API 8.0. VMDirectPath Gen 2 is no longer supported and there is no replacement.

If vmDirectPathGen2Active is false, this array will be populated with reasons for the inactivity that are related to virtual machine state or configuration (chosen from VirtualMachineDeviceRuntimeInfoVirtualEthernetCardRuntimeStateVmDirectPathGen2InactiveReasonVmEnum).

Other reasons for inactivity will be provided in vmDirectPathGen2InactiveReasonOther. If there is a reason for inactivity that cannot be described by the available constants, vmDirectPathGen2InactiveReasonExtended will be populated with an additional explanation provided by the platform.

Note that this list of reasons is not guaranteed to be exhaustive.

array of string
vmDirectPathGen2InactiveReasonOther
Optional

Deprecated as of vSphere API 8.0. VMDirectPath Gen 2 is no longer supported and there is no replacement.

If vmDirectPathGen2Active is false, this array will be populated with reasons for the inactivity that are not related to virtual machine state or configuration (chosen from VirtualMachineDeviceRuntimeInfoVirtualEthernetCardRuntimeStateVmDirectPathGen2InactiveReasonOtherEnum).

Virtual machine related reasons for inactivity will be provided in vmDirectPathGen2InactiveReasonVm. If there is a reason for inactivity that cannot be described by the available constants, vmDirectPathGen2InactiveReasonExtended will be populated with an additional explanation provided by the platform.

Note that this list of reasons is not guaranteed to be exhaustive.

See also vmDirectPathGen2Supported.

string
vmDirectPathGen2InactiveReasonExtended
Optional

Deprecated as of vSphere API 8.0. VMDirectPath Gen 2 is no longer supported and there is no replacement.

If vmDirectPathGen2Active is false, this property may contain an explanation provided by the platform, beyond the reasons (if any) enumerated in vmDirectPathGen2InactiveReasonVm and/or vmDirectPathGen2InactiveReasonOther.

boolean
uptv2Active
Optional

Flag to indicate whether UPTv2(Uniform Pass-through version 2) is active on this device.

If true, the network adapter works in the pass-through mode. If false, the network adapter still has the network connectivity but works in emulated mode and pass-through is not enabled. The reason for inactivity is provided in uptv2InactiveReasonVm and/or uptv2InactiveReasonOther. This flag is unset if not applicable. It indicates network adapter is not a vmxnet3 adapter or uptv2Enabled of it is not set to true.

Since: vSphere API Release 8.0.0.1

array of string
uptv2InactiveReasonVm
Optional

When uptv2Active is false, this field will be populated with reasons for the inactivity that are related to virtual machine state or configuration (chosen from VirtualMachineDeviceRuntimeInfoVirtualEthernetCardRuntimeStateVmDirectPathGen2InactiveReasonVmEnum).

Other reasons for inactivity will be provided in uptv2InactiveReasonOther. This field will be unset if uptv2Active is true or unset.

Note that this field of reasons is not guaranteed to be exhaustive.

Since: vSphere API Release 8.0.0.1

array of string
uptv2InactiveReasonOther
Optional

When uptv2Active is false, this field will be populated with reasons for the inactivity that are not related to virtual machine state or configuration (chosen from VirtualMachineDeviceRuntimeInfoVirtualEthernetCardRuntimeStateVmDirectPathGen2InactiveReasonOtherEnum).

Virtual machine related reasons for inactivity will be provided in uptv2InactiveReasonVm. This field will be unset if uptv2Active is true or unset.

Note that this field of reasons is not guaranteed to be exhaustive.

Since: vSphere API Release 8.0.0.1

string
reservationStatus
Optional

The status indicating whether network reservation requirement is violated or not on the virtual network adapter.

See ManagedEntityStatusEnum for possible values.

red indicates that reservation specified on the virtual network adapter is not being fulfilled. This can happen if the reservation requested is greater than the available capacity reserved for virtual machine traffic on the host.

green indicates that the reservation specified on the virtual network adapter is being fulfilled.

string
attachmentStatus
Optional

The status indicating the state of virtual network adapter's attachment to an opaque network.

See ManagedEntityStatusEnum for possible values.

red indicates that the network adapter is not yet successfully attached to opaque network. This can happen if corresponding attachment port is missing in the kernel.

green indicates that the network adapater is successfully attached to opaque network.

featureRequirement
Optional

These network adapter requirements must have equivalent capabilities on the virtual switch in order to power on or migrate to the host.