HostVirtualNic

HostVirtualNic
HostVirtualNic

The HostVirtualNic data object describes a virtual network adapter that connects to a virtual switch.

A host virtual NIC differs from a physical NIC:

  • A host virtual NIC is a virtual device that is connected to a virtual switch.
  • A physical NIC (pnic) corresponds to a physical device that is connected to the physical network.

A host virtual NIC provides access to the external network through a virtual switch that is bridged through a Physical NIC to a physical network.

AllOf
This class requires all of the following:
JSON Example
{
    "_typeName": "string",
    "device": "string",
    "key": "string",
    "portgroup": "string",
    "spec": {
        "_typeName": "string",
        "dynamicProperty": [
            {
                "_typeName": "string",
                "name": "string",
                "val": {
                    "_typeName": "string"
                }
            }
        ],
        "ip": {
            "_typeName": "string",
            "dhcp": false,
            "ipAddress": "string",
            "subnetMask": "string",
            "ipV6Config": {
                "_typeName": "string",
                "ipV6Address": [
                    {
                        "_typeName": "string",
                        "ipAddress": "string",
                        "prefixLength": 0,
                        "origin": "string",
                        "dadState": "string",
                        "lifetime": "string",
                        "operation": "string"
                    }
                ],
                "autoConfigurationEnabled": false,
                "dhcpV6Enabled": false
            }
        },
        "mac": "string",
        "distributedVirtualPort": {
            "_typeName": "string",
            "switchUuid": "string",
            "portgroupKey": "string",
            "portKey": "string",
            "connectionCookie": 0
        },
        "portgroup": "string",
        "mtu": 0,
        "tsoEnabled": false,
        "netStackInstanceKey": "string",
        "opaqueNetwork": {
            "_typeName": "string",
            "opaqueNetworkId": "string",
            "opaqueNetworkType": "string"
        },
        "externalId": "string",
        "pinnedPnic": "string",
        "ipRouteSpec": {
            "_typeName": "string",
            "ipRouteConfig": {
                "_typeName": "string",
                "defaultGateway": "string",
                "gatewayDevice": "string",
                "ipV6DefaultGateway": "string",
                "ipV6GatewayDevice": "string"
            }
        },
        "systemOwned": false,
        "dpuId": "string"
    },
    "port": {
        "_typeName": "string",
        "key": "string",
        "mac": [
            "string"
        ],
        "type": "string"
    }
}
string
device
Required

Device name.

string
key
Required

Linkable identifier.

string
portgroup
Required

If the Virtual NIC is connecting to a vSwitch, this property is the name of portgroup connected.

If the Virtual NIC is connecting to a DistributedVirtualSwitch or opaque network, this property is an empty string.

spec
Required

The HostVirtualNicSpec data object describes the HostVirtualNic configuration containing both the configured properties on a virtual NIC and identification information.

port
Optional

A Port data object type is a runtime representation of network connectivity between a network service or virtual machine and a virtual switch.

This is different from a port group in that the port group represents the configuration aspects of the network connection. The Port object provides runtime statistics.