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": "string",
"owner": "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.
Configurable properties for the virtual network adapter object.
Port(port) on the port group that the virtual NIC is using when it is enabled.
If the Virtual NIC is connected to DistributedVirtualSwitch or opaque network, this property is unset.
Owner of vmknic.
It is only valid for system vmknic. The unset means not owned by the system. See HostConfigChangeOwnerEnum for supported values.
Since: vSphere API Release 9.0.0.0