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.
{
"_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"
}
}
Device name.
Linkable identifier.
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.
The HostVirtualNicSpec data object describes the HostVirtualNic configuration containing both the configured properties on a virtual NIC and identification information.
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.