Skip to main content

GET – Host interface properties

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

Request URL​

GET https://<BMC_IPADDR>/redfish/v1/Managers/1/HostInterfaces/1

Request body​

None

Response body​

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

FieldTypeDescription

Id

String

Uniquely identifies the resource within the collection of Chassis. Always set to “1”.

Description

String

Provides a description of Host Interface resources.

ExternallyAccessible

Boolean

Always set to false

HostEthernetInterfaces

Link

A reference link to the collection of ethernet interfaces that the system uses for network communication with the host interface.

HostInterfaceType

String

“NetworkHostInterface”

InterfaceEnabled

Boolean

Indicates whether this interface is enabled.

Links

Object

Expanded

 

ComputerSystems

Array

An array of references to the computer systems connected to this host interface.

  

ComputerSystems[0]

Link

A reference link to a resource of computer system

ManagerEthernetInterface

Link

A reference link to a single ethernet interface that the manager uses for network communication with the host interface.

Name

String

The name of the host interface resource. Always set to “Host Interface”.

NetworkProtocol

Link

A reference link to the network services and their settings that the manager controls.

Status code​

HTTP Status CodeError Message ID
500InternalError

Response example​

When the request is successful, a message body similar to the following is returned:

{
    "HostInterfaceType": "NetworkHostInterface",
    "NetworkProtocol": {
        "@odata.id": "/redfish/v1/Managers/1/NetworkProtocol"
    },
    "Id": "1",
    "InterfaceEnabled": true,
    "Links": {
        "ComputerSystems": [
            {
                "@odata.id": "/redfish/v1/Systems/1"
            }
        ]
    },
    "Name": "Host Interface",
    "@odata.context": "/redfish/v1/$metadata#HostInterface.HostInterface",
    "@odata.etag": "\"173c848afdf17b76c0b2defce1f48be7\"",
    "@odata.type": "#HostInterface.v1_2_0.HostInterface",
    "ManagerEthernetInterface": {
        "@odata.id": "/redfish/v1/Managers/1/EthernetInterfaces/ToHost"
    },
    "@odata.id": "/redfish/v1/Managers/1/HostInterfaces/1",
    "ExternallyAccessible": false,
    "HostEthernetInterfaces": {
        "@odata.id": "/redfish/v1/Managers/1/HostInterfaces/1/HostEthernetInterfaces"
    },
    "Description": "This resource shall be used to represent Host Interface resources as part of the Redfish specification."
}