Ethernet Port

URLs Summary

URL	GET	POST	PATCH	PUT	DELETE
/rest/v1/running/interfaces/{name}/ethernet-config	Y	N	Y	N	N

Examples

Modify the configuration of Ethernet1.

PATCH HTTPS://{switch IP}/rest/v1/running/interfaces/Ethernet1/ethernet-config
{
    "port-speed": "SPEED_25G",
    "auto-negotiate": "false"
}

Properties Descriptions

Ethernet configuration

Tree Diagrams

    +--rw interfaces
        +--rw interface* [name]
            +--rw name
            +--rw ethernet-config
            +--rw auto-negotiate?
            +--rw port-speed?
            +--rw fec?
            +--rw startup-delay?
            +--rw advertised-speeds*
            +--ro lanes*
            +--ro index?
            +--ro alias?
            +--rw mac-limit?

Table of Properties

Name	Required	Type/Range	Description
interfaces	M		Path-only node, has no configurable value.Interface parameters.
name	M	Ethernet name	(sub-property of interfaces) The name of the interface.
ethernet-config	M		(sub-property of interfaces) Path-only node, has no configurable value.
auto-negotiate	O	”true" "false”	(sub-property of ethernet-config) Set interface speed auto negotiation. Default value: “false”
port-speed	O	”SPEED_1G" "SPEED_10G" "SPEED_25G" "SPEED_40G" "SPEED_50G" "SPEED_100G" "SPEED_200G" "SPEED_400G" "SPEED_800G”	(sub-property of ethernet-config) When auto-negotiate is TRUE, this optionally sets the port-speed mode that will be advertised to the peer for negotiation. If unspecified, it is expected that the interface will select the highest speed available based on negotiation. When auto-negotiate is set to FALSE, sets the link speed to a fixed value.
fec	O	”rs" "fc" "none”	(sub-property of ethernet-config) Set interface fec. Default value:“rs”
startup-delay	O	1..65535	(sub-property of ethernet-config) Set interface startup delay in seconds. Default value: 150
advertised-speeds	O	”all" "SPEED_1G" "SPEED_10G" "SPEED_25G" "SPEED_40G" "SPEED_50G" "SPEED_100G" "SPEED_200G" "SPEED_400G" "SPEED_800G”	(sub-property of ethernet-config) Set interface advertised speed list, value can be choosed from “all” or advertised-speed list{10000,25000,40000,100000}
lanes	RO	0..65535	(sub-property of ethernet-config) lanes of Ethernet.eg: lanes of Ethernet1 is 1
index	RO	0..65535	(sub-property of ethernet-config) index of Ethernet, eg: index of Ethernet1 is 1
alias	RO	string	(sub-property of ethernet-config) alias of Ethernet.eg: alias of Ethernet1 is Y2
mac-limit	O	1..131072	(sub-property of ethernet-config) Set interface dynamic MAC quantity limit.