Skip to main content

GET – Server Ethernet over USB properties

Use the GET method to retrieve properties in Ethernet interface resource between the server and manager.

Request URL

GET https://<BMC_IPADDR>/redfish/v1/Systems/1/EthernetInterfaces/ToManager

Request body

None

Response body

The response is a JSON object that contains the following parameters:

FieldTypeDescription

Id

String

ToManager

SpeedMbps

String

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

InterfaceEnabled

Boolean

A boolean indicating whether this interface is enabled.

MACAddress

String

The currently configured MAC address of the (logical port) interface.

PermanentMACAddress

String

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

Name

String

"Host Ethernet Interface"

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.

Status

Object

Expand

 

State

String

“Enabled”

 

Health

String

Null

Links

Object

Expand

 

Chassis

Link

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

 

HostInterface

Link

A reference to the resource “HostInterface” which represents the interface used by the host to communicate with the manager.

Description

String

Host Network 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:

{
"FQDN": "",
"Id": "ToManager",
"NameServers": [],
"SpeedMbps": 100,
"HostName": "",
"IPv4Addresses": [],
"Description": "Host Network Interface",
"Status": {
"State": "Enabled",
"Health": null
},
"MACAddress": "7e:d3:0a:ed:bb:1b",
"Name": "Host Ethernet Interface",
"InterfaceEnabled": true,
"@odata.type": "#EthernetInterface.v1_5_1.EthernetInterface",
"Links": {
"Chassis": {
"@odata.id": "/redfish/v1/Chassis/1"
},
"HostInterface": {
"@odata.id": "/redfish/v1/Managers/1/HostInterfaces/1"
}
},
"LinkStatus": "LinkUp",
"@odata.etag": "\"4524b3cedd2525a9e6c\"",
"PermanentMACAddress": "7e:d3:0a:ed:bb:1b",
"@odata.id": "/redfish/v1/Systems/1/EthernetInterfaces/ToManager"
}