EthernetInterface

Schema Definition

The EthernetInterface schema represents a single, logical ethernet interface or network interface controller (NIC).

Properties

PropertyTypeNullableRequiredPermissionDescription
@odata.contextStringread-onlyThe OData description of a payload.
Format: uri
@odata.idStringread-onlyThe unique identifier for a resource.
Format: uri
@odata.typeStringread-onlyThe type of a resource.
Actions {Objectread-writeThe available actions for this resource.
    Oem { }Objectread-writeThe available OEM specific actions for this resource.
}
DescriptionStringYesread-onlyProvides a description of this resource and is used for commonality in the schema definitions.
IdStringGETread-onlyUniquely identifies the resource within the collection of like resources.
Links {Objectread-writeContains references to other resources that are related to this resource.
    Oem { }Objectread-writeOem extension object.
}
NameStringGETread-onlyThe name of the resource or array element.
Oem {Objectread-writeThis is the manufacturer/provider specific extension moniker used to divide the Oem object into sections.
    EID_47597 {Objectread-writeRECS|Box EthernetInterface extension
        ConnectedPort {Reference(Port)read-onlyThe Port of the EthernetSwitch this interface is connected to.
            @odata.idStringread-onlyThe unique identifier for a resource.
Format: uri
        }
        MaxSpeedMbpsInt64Yesread-onlyThis is the maximum speed in Mbps of this interface.
Unit: Mbit/s
        Provider {Reference(ComputerSystem)read-onlyThe ComputerSystem providing this EthernetInterface.
            @odata.idStringread-onlyThe unique identifier for a resource.
Format: uri
        }
    }
}
PermanentMACAddressStringYesread-onlyThis is the permanent MAC address assigned to this interface (port).
Pattern: ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$
UefiDevicePathStringYesread-onlyThe UEFI device path for this interface.

Operations

GET

Request

GET /redfish/v1/Chassis/Chassis1/Baseboards/Baseboard1/ComputerSystems/ComputerSystem1/EthernetInterfaces/EthernetInterface1
Content-Type: application/json

Response

{
    "@odata.context": "uri",
    "@odata.id": "/redfish/v1/Chassis/Chassis1/Baseboards/Baseboard1/ComputerSystems/ComputerSystem1/EthernetInterfaces/EthernetInterface1",
    "@odata.type": "String",
    "Actions": {
        "Oem": { }
    }
    "Description": "String",
    "Id": "String",
    "Links": {
        "Oem": { }
    }
    "Name": "String",
    "Oem": {
        "EID_47597": {
            "ConnectedPort": {
                "@odata.id": "/redfish/v1/Chassis/Chassis1/Switch1/Ports/Port1"
            },
            "MaxSpeedMbps": 0,
            "Provider": {
                "@odata.id": "/redfish/v1/Chassis/Chassis1/Baseboards/Baseboard1/ComputerSystems/ComputerSystem1"
            }
        }
    }
    "PermanentMACAddress": "String",
    "UefiDevicePath": "String"
}

POST

This operation is not supported on this resource and will result in the following response:

HTTP/1.1 405 Method Not Allowed

PATCH

This operation is not supported on this resource and will result in the following response:

HTTP/1.1 405 Method Not Allowed

DELETE

This operation is not supported on this resource and will result in the following response:

HTTP/1.1 405 Method Not Allowed