GET – BMC Ethernet properties

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

Request URL

GET https://<BMC_IPADDR>/redfish/v1/Managers/1/EthernetInterfaces/{NIC,ToHost,NIC2}

Request body

None

Response body

Field			Type	Description
FQDN			String	The complete, fully qualified domain name for this XCC2 interface. It is an empty string in ToHost.
EthernetInterfaceType			String	“Physical”.
IPv6DefaultGateway			String	The current IPv6 default gateway address that is in use on this XCC2 interface. This property is not available in ToHost.
Id			String	The value is “NIC” or “NIC2” in resource for BMC Ethernet interface. The value is “ToHost" in BMC Ethernet over USB interface.
IPv6StaticAddresses			Array	An array of objects used to represent the IPv6 static connection characteristics for this XCC2 interface. This property is not available in ToHost.
	IPv6StaticAddresses[N]		Object	Array element
		PrefixLength	Number	The Prefix Length of this IPv6 address
		Address	String	A valid IPv6 address
AutoNeg			Boolean	Indicates if the speed and duplex are automatically negotiated and configured on this XCC2 interface: True. Auto negotiation of speed and duplex is enabled. False. Auto negotiation of speed and duplex is disabled.
IPv6AddressPolicyTable			Array	An array of objects used to represent the Address Selection Policy Table as defined in RFC 6724
	IPv6AddressPolicyTable[N]		Object	Array element
		Prefix	String	The prefix of IPv6 address.
		Precedence	Number	The IPv6 precedence, as defined in RFC6724, section 2.1.
		Label	Number	The label of IPv6 address.
SpeedMbps			String	The current speed in Mbps of this XCC2 interface (units: Mbit/s). This value is null when “AutoNeg” is true.
Status			Object	Expanded.
	State		String	“Enabled” if this Ethernet interface is enabled.
	Health		String	null
HostName			String	The host name for this XCC2 interface, without any domain information. It is an empty string in ToHost.
IPv6Addresses			Array	An array of objects used to represent the IPv6 connection characteristics for this XCC2 interface
	IPv6Address		Object	Array element
		Address	String	The IPv6 Address
		PrefixLength	Number	The IPv6 Address Prefix Length
		AddressOrigin	String	The type of the IPv6 address origin for this XCC2 interface: Static. A static address as configured by the user. DHCPv6. Address is provided by a DHCPv6 service. LinkLocal. Address is valid only for this network segment (link). SLAAC. Address is provided by a Stateless Address AutoConfiguration (SLAAC) service.
		AddressState	String	The current state of this address as defined in RFC 4862: Preferred. This address is currently within both it's valid and preferred lifetimes as defined in RFC 4862. Deprecated. This address is currently within it's valid lifetime, but is now outside of it's preferred lifetime as defined in RFC 4862. Tentative. This address is currently undergoing Duplicate Address Detection testing as defined in RFC 4862 section 5.4. Failed. This address has failed Duplicate Address Detection testing as defined in RFC 4862 section 5.4 and is not currently in use."
FullDuplex			Boolean	The duplex status of the Ethernet connection on this XCC2 interface. This value is null when “AutoNeg” is true.
IPv4StaticAddresses			Array	An array of objects used to represent the IPv4 connection characteristics for this XCC2 interface.
	IPv4StaticAddress		Object	Array element
		Address	String	The IPv4 Address
		SubnetMask	String	The IPv4 Subnet mask.
		AddressOrigin	String	Static.
		Gateway	String	The IPv4 gateway for this address
IPv4Address			Array	An array of objects used to represent the IPv4 connection characteristics for this XCC2 interface.
	IPv4Address		Object	Array element
		Address	String	the IPv4 Address
		SubnetMask	String	the IPv4 Subnet mask.
		AddressOrigin	String	This indicates how the address was determined: Static. A static address as configured by the user. DHCP. Address is provided by a DHCPv4 service. BOOTP. Address is provided by a BOOTP service. IPv4LinkLocal . Address is valid only for this network segment (link).
		Gateway	String	the IPv4 gateway for this address
NameServers			Array	DNS name servers that are currently in use on this XCC2 interface (IPv4 1st,2nd, 3rd ip address, IPv6 1st,2nd, 3rd ip address). It is an empty array in ToHost.
InterfaceEnabled			Boolean	A boolean indicating whether this interface is enabled
LinkStatus			String	The value of this property represents the current status of link. 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 of this property shall be a reference to a resource of type Chassis that represent the physical container associated with this Ethernet Interface.
	HostInterface		Link	The value of this property shall be a reference to a resource of type HostInterface which represents the interface used by a host to communicate with a Manager. Only in ToHost has this property.
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	The name of the resource
MTUSize			Number	The currently configured Maximum Transmission Unit (MTU) in bytes on this XCC2 interface
VLAN			Link	The value of this property shall be the VLAN for this interface. If this interface supports more than one VLAN, the VLAN property shall not be present and the VLANS collection link shall be present instead. This property is not available in ToHost.
	VLANEnable		Boolean	The property of VLAN is Enable or not.
	VLANId		Number	The Id of VLAN.
MaxIPv6StaticAddresses			Number	The maximum number of IPv6 static address. Fixed value “0” in ToHost.
DHCPv4			Object	Expanded.
	UseDNSServers		Boolean	Use DNS servers or not.
	UseDomainName		Boolean	Use Domain Name or not.
	DHCPEnabled		Boolean	The DHCP is Enabled or not.
	UseNTPServers		Boolean	Not used, always null.
	UseGateway		Boolean	Not used, always null.
	UseStaticRoutes		Boolean	Not used, always null.
	FallbackAddress		String	DHCPv4 fallback address method for this interface. Valid values: None, Static
DHCPv6			Object	Expanded
	UseDNSServers		Boolean	Use DNS servers or not.
	UseDomainName		Boolean	Use Domain Name or not.
	OperatingMode		String	The operating mode is “Enabled” or “Disabled”.
	UseNTPServers		Boolean	Not used, always null.
	UseRapidCommit		Boolean	Not used, always null.
IPv6StaticDefaultGateways			Array	An array of objects used to represent the IPv6 static default gateway for this XCC2 interface.
	Address		String	Static IPv6 default gateway address
	PrefixLength		Integer	Fixed value “0”
StaticNameServers			Array	The statically-defined set of DNS server IPv4 and IPv6 addresses. Items: string Items count: 6
StatelessAddressAutoConfig			Object	Expanded
	IPv4AutoConfigEnabled		Boolean	Not used, always null.
	IPv6AutoConfigEnabled		Boolean	Enable IPv6 Auto Config or not.
Description			String	Manager Ethernet Interface

Status code

HTTP Status Code	Error Message ID
500	InternalError

Example

The following example JSON response is returned:

{
    "IPv4StaticAddresses": [
        {
            "SubnetMask": "255.255.255.0",
            "AddressOrigin": "Static",
            "Gateway": "0.0.0.0",
            "Address": "192.168.70.125"
        }
    ],
    "StaticNameServers": [
        "0.0.0.0",
        "0.0.0.0",
        "0.0.0.0",
        "::",
        "::",
        "::"
    ],
    "IPv6StaticDefaultGateways": [
        {
            "PrefixLength": 0,
            "Address": "::"
        }
    ],
    "SpeedMbps": null,
    "IPv4Addresses": [
        {
            "SubnetMask": "255.255.254.0",
            "AddressOrigin": "DHCP",
            "Gateway": "10.240.218.1",
            "Address": "10.240.218.133"
        }
    ],
    "IPv6Addresses": [
        {
            "PrefixLength": 64,
            "AddressOrigin": "LinkLocal",
            "AddressState": "Preferred",
            "Address": "fe80::922e:16ff:fe06:e44e"
        }
    ],
    "InterfaceEnabled": true,
    "AutoNeg": true,
    "NameServers": [
        "10.240.0.10",
        "0.0.0.0",
        "0.0.0.0",
        "::",
        "::",
        "::"
    ],
    "@odata.etag": "\"11618d5429c7230e8ce358\"",
    "HostName": "XCC-7D75-1234567890",
    "MTUSize": 1500,
    "FullDuplex": null,
    "@odata.type": "#EthernetInterface.v1_8_0.EthernetInterface",
    "@odata.id": "/redfish/v1/Managers/1/EthernetInterfaces/NIC",
    "Status": {
        "Health": "OK",
        "State": "Enabled"
    },
    "DHCPv4": {
        "UseNTPServers": null,
        "UseStaticRoutes": null,
        "DHCPEnabled": true,
        "UseDNSServers": true,
        "UseDomainName": true,
        "FallbackAddress": "Static",
        "UseGateway": null
    },
    "MaxIPv6StaticAddresses": 1,
    "MACAddress": "90:2e:16:06:e4:4e",
    "Links": {
        "Chassis": {
            "@odata.id": "/redfish/v1/Chassis/1"
        }
    },
    "VLAN": {
        "VLANId": 1,
        "VLANEnable": false
    },
    "LinkStatus": "LinkUp",
    "PermanentMACAddress": "90:2e:16:06:e4:4e",
    "FQDN": "XCC-7D75-1234567890.lenovo.com",
    "IPv6DefaultGateway": "::",
    "StatelessAddressAutoConfig": {
        "IPv6AutoConfigEnabled": true,
        "IPv4AutoConfigEnabled": null
    },
    "DHCPv6": {
        "UseNTPServers": null,
        "OperatingMode": "Enabled",
        "UseDomainName": true,
        "UseRapidCommit": null,
        "UseDNSServers": true
    },
    "Id": "NIC",
    "IPv6AddressPolicyTable": [
        {
            "Precedence": 50,
            "Prefix": "::1/128",
            "Label": 0
        },
        {
            "Precedence": 11,
            "Prefix": "::/96",
            "Label": 3
        },
        {
            "Precedence": 35,
            "Prefix": "::ffff:0.0.0.0/96",
            "Label": 4
        },
        {
            "Precedence": 10,
            "Prefix": "2001::/32",
            "Label": 6
        },
        {
            "Precedence": 10,
            "Prefix": "2001:10::/28",
            "Label": 7
        },
        {
            "Precedence": 1,
            "Prefix": "3ffe::/16",
            "Label": 12
        },
        {
            "Precedence": 30,
            "Prefix": "2002::/16",
            "Label": 2
        },
        {
            "Precedence": 1,
            "Prefix": "fec0::/10",
            "Label": 11
        },
        {
            "Precedence": 5,
            "Prefix": "fc00::/7",
            "Label": 5
        },
        {
            "Precedence": 40,
            "Prefix": "::/0",
            "Label": 1
        }
    ],
    "@odata.context": "/redfish/v1/$metadata#EthernetInterface.EthernetInterface",
    "IPv6StaticAddresses": [
        {
            "PrefixLength": 64,
            "Address": "::"
        }
    ],
    "Name": "Manager Ethernet Interface",
    "EthernetInterfaceType": "Physical",
    "Description": "Manager Ethernet Interface",
    "Oem": {
        …
    }
}

Give documentation feedback

GET – BMC Ethernet properties

Request URL​

Request body​

Response body​

Status code​

Example​

Request URL

Request body

Response body

Status code

Example