Skip to main content

GET – Server Ethernet interface properties

Use the GET method to retrieve properties in Ethernet interface resource for a server.

Request URL​

GET https://<BMC_IPADDR>/redfish/v1/Systems/1/EthernetInterfaces/NIC{N}

Request body​

None

Response body​

FieldTypeDescription

Description

String

External Network Interface

Id

String

NIC{N}

LinkStatus

String

The link status of this interface (port).

LinkUp: The link is available for communication on this interface.

NoLink: There is no link or connection detected on this interface.

LinkDown: There is no link on this interface, but the interface is connected.

Links

Object

Expanded.

 

Chassis

Link

The value is a reference to the resource “Chassis” that represent the physical container.

PermanentMACAddress

String

The permanent MAC address assigned to this interface (port).

SpeedMbps

String

The current speed in Mbps of this XCC3 interface (units: Mbit/s)

Status

Object

Expanded.

 

State

String

The state of this ethernet interface.

 

Health

String

The health of this ethernet interface.

Name

String

External Ethernet Interface

FQDN

String

“” (empty string)

HostName

String

“” (empty string)

NameServers

String

Array

Empty array

IPv4Addresses

Array

Empty array

Status code​

HTTP Status CodeError Message ID
500InternalError

Example​

The following example JSON response is returned:

{
    "@odata.context": "/redfish/v1/$metadata#EthernetInterface.EthernetInterface",
    "@odata.etag": "\"62C4509A\"",
    "@odata.id": "/redfish/v1/Systems/1/EthernetInterfaces/NIC1",
    "@odata.type": "#EthernetInterface.v1_9_0.EthernetInterface",
    "Description": "External Ethernet Interface",
    "FQDN": "",
    "FibreChannel": {
        "AssociatedWorldWideNames": [
            "210034800D725642"
        ]
    },
    "HostName": "",
    "IPv4Addresses": [],
    "Id": "NIC1",
    "LinkStatus": "LinkDown",
    "Links": {
        "Chassis": {
            "@odata.id": "/redfish/v1/Chassis/1"
        }
    },
    "MACAddress": "210034800D725642",
    "Name": "External Ethernet Interface",
    "NameServers": [],
    "PermanentMACAddress": "210034800D725642",
    "SpeedMbps": 0,
    "Status": {
        "Health": "OK",
        "State": "Enabled"
    }
}