EthernetInterface instance

GET

/redfish/v1/Managers/{ManagerId}/EthernetInterfaces/{EthernetInterfaceId}

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

Privilege: Login

NOTE: LinkDown status is reported for a network failure or even when the network cable is unplugged.

Request

Authorization

API Key

Add parameter in header

X-Auth-Token

Example:

X-Auth-Token: ********************

Basic Auth

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Path Params

Responses

🟢200成功

application/json

The response contains a representation of the EthernetInterface resource

Bodyapplication/json

🔴500服务器错误

Request Example

Shell

JavaScript

Java

Swift

curl --location '/redfish/v1/Managers//EthernetInterfaces/' \
--header 'X-Auth-Token: <api-key>' \
--header 'Authorization: Basic <encoded-value>'

Response Example

200 - 成功示例

{
    "@odata.context": "/redfish/v1/$metadata#EthernetInterface.EthernetInterface",
    "@odata.etag": "W/\"gen-3\"",
    "@odata.id": "/redfish/v1/Managers/iDRAC.Embedded.1/EthernetInterfaces/NIC.1",
    "@odata.type": "#EthernetInterface.v1_12_4.EthernetInterface",
    "AutoNeg": true,
    "Description": "Management Network Interface",
    "EthernetInterfaceType": "Physical",
    "FQDN": "",
    "FullDuplex": true,
    "HostName": "CKNTC2J",
    "IPv4Addresses": [
        {
            "Address": "100.98.88.24",
            "AddressOrigin": "DHCP",
            "Gateway": "100.98.88.1",
            "SubnetMask": "255.255.255.0"
        }
    ],
    "IPv4Addresses@odata.count": 1,
    "IPv4StaticAddresses": [
        {
            "Address": "192.168.0.120",
            "AddressOrigin": "DHCP",
            "Gateway": "192.168.0.1",
            "SubnetMask": "255.255.255.0"
        }
    ],
    "IPv4StaticAddresses@odata.count": 1,
    "IPv6AddressPolicyTable": [],
    "IPv6AddressPolicyTable@odata.count": 0,
    "IPv6Addresses": [
        {
            "Address": "::",
            "AddressOrigin": "DHCPv6",
            "AddressState": "Preferred",
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": "DHCPv6",
            "AddressState": "Preferred",
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": null,
            "AddressState": null,
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": null,
            "AddressState": null,
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": null,
            "AddressState": null,
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": null,
            "AddressState": null,
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": null,
            "AddressState": null,
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": null,
            "AddressState": null,
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": null,
            "AddressState": null,
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": null,
            "AddressState": null,
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": null,
            "AddressState": null,
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": null,
            "AddressState": null,
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": null,
            "AddressState": null,
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": null,
            "AddressState": null,
            "PrefixLength": 64
        },
        {
            "Address": "::",
            "AddressOrigin": null,
            "AddressState": null,
            "PrefixLength": 64
        },
        {
            "Address": "fe80::6054:9cea:3fdd:84cd",
            "AddressOrigin": "LinkLocal",
            "AddressState": "Preferred",
            "PrefixLength": 64
        }
    ],
    "IPv6Addresses@odata.count": 16,
    "IPv6DefaultGateway": "::",
    "IPv6StaticAddresses": [
        {
            "Address": "::",
            "PrefixLength": 64
        }
    ],
    "IPv6StaticAddresses@odata.count": 1,
    "Id": "NIC.1",
    "InterfaceEnabled": true,
    "LinkStatus": "LinkUp",
    "Links": {
        "Chassis": {
            "@odata.id": "/redfish/v1/Chassis/System.Embedded.1"
        }
    },
    "MACAddress": "6c:3c:8c:94:34:ec",
    "MTUSize": 1500,
    "MaxIPv6StaticAddresses": 1,
    "Name": "Manager Ethernet Interface",
    "NameServers": [
        "10.8.8.8",
        "10.7.7.7",
        "0.0.0.0",
        "::",
        "::",
        "::"
    ],
    "NameServers@odata.count": 6,
    "PermanentMACAddress": "6c:3c:8c:94:34:ec",
    "SpeedMbps": 1000,
    "StaticNameServers": [
        "0.0.0.0",
        "0.0.0.0",
        "0.0.0.0",
        "::",
        "::",
        "::"
    ],
    "Status": {
        "Health": "OK",
        "State": "Enabled"
    },
    "VLAN": {
        "VLANEnable": false,
        "VLANId": 1
    }
}

Modified at 2026-03-04 06:02:26

EthernetInterfaceCollection instance

EthernetInterface instance