GET – Network device functions

Use the GET method to retrieve properties in NetworkDeviceFunction resource for Redfish service.

Request URL

GET https://<BMC_IPADDR>/redfish/v1/Chassis/1/NetworkAdapters/Id/NetworkDeviceFunctions/{1-X}.{1-Y}

Request body

None

Response body

Field					Type	Description
Id					String	Physical port index +"." + the logical port index, for the associated NetworkPort resource.
AssignablePhysicalPorts					Array	Items: link
	AssignablePhysicalPorts[N]				Link	Link to possible Ports
BootMode					String	The boot mode configured for this network device function.
Description					String	A Network Device Function represents a logical interface exposed by the network adapter.
DeviceEnabled					Boolean	True
Ethernet					Object	Expanded. (If this is Ethernet, the below items will be displayed)
	MACAddress				String	This is the currently configured MAC address of the (logical port) network device function.
	MTUSize				Number	The Maximum Transmission Unit (MTU) configured for this network device function.
	MTUSizeMaximum				Number	The largest maximum transmission unit (MTU) size supported for this network device function.
	PermanentMACAddress				String	This is the permanent MAC address assigned to this network device function (physical function)
InfiniBand					Object	Expanded. (If this is InfiniBand, the below items will be displayed)
	NodeGUID				String	The node GUID assigned to this network device function.
	MTUSize				Number	The maximum transmission unit (MTU) configured for this network device function.
	PermanentNodeGUID				String	The permanent node GUID assigned to this network device function.
	PermanentPortGUID				String	The permanent port GUID assigned to this network device function.
	PermanentSystemGUID				String	The permanent system GUID assigned to this network device function.
	PortGUID				String	The port GUID assigned to this network device function.
	SystemGUID				String	The system GUID assigned to this network device function.
	PermanentMACAddress				String	This is the permanent MAC address assigned to this network device function (physical function)
	MACAddress				String	This is the currently configured MAC address of the (logical port) network device function.
	MTUSize				Integer	The Maximum Transmission Unit (MTU) configured for this network device function.
Links					Object	Expanded.
	PhysicalNetworkPortAssignment				Link	Link to a related NetworkPort
MaxVirtualFunctions					Number	The number of virtual functions that are available for this network device function.
Name					String	"Logical Port"+" "+logical port index
NetDevFuncType					String	The configured capability of this network device function.
NetDevFuncCapabilities					Array	An array of capabilities for this network device function.
SAVIEnabled					Boolean	Indicates if Source Address Validation Improvement (SAVI) is enabled for this network device function.
Status					Object	Expanded.
	State				String	Enabled
	Health				String	OK
	HealthRollup				String	This represents the health state of this resource and its dependent resources.
VirtualFunctionsEnabled					Boolean	An indication of whether single root input/output virtualization (SR-IOV) virtual functions are enabled for this network device function.
@Redfish.Settings					Object	Expanded. This object is supported only when NetDevFuncType is iSCSI.
	Messages				Array	Items: object
		Messages[N]			Object	Expanded.
			MessageId		String	“RebootRequired”
			RelatedProperties		Array	Items: string
				RelatedProperties[N]	String	The setting name of network device function. The format will be “#/iSCSIBoot/…”.
			Severity		String	“Warning”
			Message		String	“Changes completed successfully, but these changes will not take effect until next reboot.”
			Resolution		String	“Reboot the computer system for the changes to take effect.”
	SettingsObject				Link	Link to the network device function settings pending resource.
	Time				String	Indicate the time when the setting resource was last applied.
	SupportedApplyTimes				Array	Items: string Item count: 1
		SupportedApplyTimes[0]			String	“OnReset”
iSCSIBoot					Object	Expanded. This property is only supported when NetDevFuncType is “iSCSI”.
	AuthenticationMethod				String	The iSCSI boot authentication method for this network device function.
	CHAPSecret				String	The shared secret for CHAP authentication. Only be present if AuthenticationMethod is CHAP.
	CHAPUsername				String	The user name for CHAP authentication. Only be present if AuthenticationMethod is CHAP.
	IPAddressType				String	The type of IP address being populated in the iSCSIBoot IP address fields. Valid values: “IPv4”, “IPV6”
	InitiatorDefaultGateway				String	The IPv6 or IPv4 iSCSI boot default gateway.
	InitiatorIPAddress				String	The IPv6 or IPv4 iSCSI boot default gateway.
	InitiatorName				String	The iSCSI initiator name.
	InitiatorNetmask				String	The IPv6 or IPv4 netmask of the iSCSI boot initiator.
	MutualCHAPSecret				String	The CHAP secret for two-way CHAP authentication. Only be present if AuthenticationMethod is MutualCHAP.
	MutualCHAPUsername				String	The CHAP user name for two-way CHAP authentication. Only be present if AuthenticationMethod is MutualCHAP.
	PrimaryLUN				Number	The logical unit number (LUN) for the primary iSCSI boot target.
	PrimaryTargetIPAddress				String	The IPv4 or IPv6 address for the primary iSCSI boot target.
	PrimaryTargetName				String	The name of the iSCSI primary boot target.
	PrimaryTargetTCPPort				Number	The TCP port for the primary iSCSI boot target.
	TargetInfoViaDHCP				Boolean	An indication of whether the iSCSI boot target name, LUN, IP address, and netmask should be obtained from DHCP.

Status code

HTTP Status Code	Error Message ID
500	InternalError

Example

The following example JSON response is returned:

{
    "@Redfish.Settings": null,
    "@odata.context": "/redfish/v1/$metadata#NetworkDeviceFunction.NetworkDeviceFunction",
    "@odata.etag": "\"BF57601A\"",
    "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot4_0x330000/NetworkDeviceFunctions/0",
    "@odata.type": "#NetworkDeviceFunction.v1_8_0.NetworkDeviceFunction",
    "AssignablePhysicalNetworkPorts": [
        {
            "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot4_0x330000/Ports/1"
        }
    ],
    "BootMode": "PXE",
    "Description": "A Network Device Function represents a logical                     interface exposed by the network adapter.",
    "DeviceEnabled": true,
    "Ethernet": {
        "MACAddress": "c4:70:bd:62:32:58",
        "MTUSize": 1522,
        "MTUSizeMaximum": 10000,
        "PermanentMACAddress": "c4:70:bd:62:32:58"
    },
    "Id": "0",
    "Links": {
        "PhysicalNetworkPortAssignment": {
            "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot4_0x330000/Ports/1"
        }
    },
    "MaxVirtualFunctions": 127,
    "Name": "NetworkDeviceFunction",
    "NetDevFuncCapabilities": [
        "Ethernet"
    ],
    "NetDevFuncType": "Ethernet",
    "SAVIEnabled": false,
    "Status": {
        "Health": "OK",
        "HealthRollup": "OK",
        "State": "Enabled"
    },
    "VirtualFunctionsEnabled": true,
    "iSCSIBoot": {}
}

Give documentation feedback

GET – Network device functions

Request URL​

Request body​

Response body​

Status code​

Example​

Request URL

Request body

Response body

Status code

Example