LAG

12 min

link aggregations(lag or portchannel) \urls summary\ url get post patch put delete /rest/v1/running/link aggregations/{name} y y y n y /rest/v1/running/link aggregations/{name}/members/{port} y y n n y /rest/v1/rpc/show link aggregation summary n y n n n \examples\ \show link aggregation summary\ post https //{switch ip}/rest/v1/rpc/show link aggregation summary response { "link aggregation" \[ { "index" 200, "name" "lag200", "protocol" "lacp", "runner active" "active", "state" "down", "description" "n/a", "member" \[ { "name" "ethernet53 2", "status" "deselected", "synced" "synced" } ] } ] } \get all portchannels\ get https //{switch ip}/rest/v1/running/link aggregations response { "result" \[ { "name" "lag200", "mode" "lacp", "lacp" { "lacp key" "auto" }, "members" \[ { "port" "ethernet53 2" } ] } ] } \create a portchannel with members\ post https //{switch ip}/rest/v1/running/link aggregations/ { "name" "lag4", "mode" "lacp", "lacp" { "lacp key" "auto", "min links" 1, "system priority" 10000, "fallback" "true", "fast rate" "true", "system id" "12 34 56\ ab\ cd\ ef" }, "members" \[ { "port" "ethernet1", }, { "port" "ethernet2", "lacp port priority" 65535 } ] } \create a member for portchannel\ post https //{switch ip}/rest/v1/running/link aggregations/lag8888/members { "port" "ethernet3", "lacp port priority" 65535 } \properties descriptions\ \lags\ tree diagrams + rw portchannels + rw portchannel \[name] + rw name + rw mode? + rw commit? + rw lacp \| + rw lacp key? \| + rw min links? \| + rw system priority? \| + rw fallback? \| + rw fast rate? \| + rw graceful down? \| + rw system id? table of properties name required type/range description link aggregations m path only node, has no configurable value name m lag1 9999 (sub property of portchannels) the name of the portchannel and portchannel sub interface mode o "lacp" "static" (sub property of portchannels) choose port channel mode lacp for running lacp protocol, static for static load banlancing among members default value "lacp" lacp cm (sub property of portchannels) path only node, has no configurable value only applicable when mode = "lacp" lacp protocol configuration of portchannels lacp key o "auto" 0 65535 (sub property of lacp) lacp key should be either auto or a integer in the range of 0 to 65535 when lacp key is set to "auto" it would be set to be the number on the end of the portchannel name with a prefix of 1 default value "auto" min links o 1 1024 (sub property of lacp) minimum count of up ports for the lag to enter up state system priority o 0 65535 (sub property of lacp) the lacp system priority identifies the master switch ot the lag the system with the lower system priority is preferred default value 65535 fallback o "true" "false" (sub property of lacp) the fallback mode brings up one of the lacp member ports to "up" state before an lacp pdu is received by the lag default value "false" fast rate o "true" "false" (sub property of lacp) fast rate allows the lacp peer to send lacp pdus at a rate of one per second after synchronization the default rate is one per 30 seconds default value "false" graceful down o "true" "false" (sub property of lacp) graceful shutdown lacp system id o a\ b c\ d e\ f (sub property of lacp) change lacp system id default to the system mac \\ tree diagrams + rw link aggregations + rw link aggregation \[name] + rw name + rw members + rw member \[port] + rw port + rw lacp port priority? + rw lacp key? + rw lacp port id? table of properties name required type/range description link aggregations m path only node, has no configurable value name m lag1 9999 (sub property of portchannels) the name of the portchannel and portchannel sub interface members m (sub property of portchannels) path only node, has no configurable value port m ethernet name (sub property of members) lacp port priority o 1 65535 (sub property of members) the port priority determines which ports should be put in standby mode when there is a hardware limitation that prevents all compatible ports from aggregating ports with lower port priority are preferred lacp key o 0 65535 (sub property of members) the administrative key defines the ability of a port to aggregate with other ports a port's ability to aggregate with other ports is determined by these factors port physical characteristics, such as the data rate and the duplex capability configuration restrictions that you establish lacp port id o 1 65535 (sub property of members) lacp port identifier default lacp uses the port priority with the port number to form the port identifier \show link aggregation summary\ tree diagrams + x show link aggregation summary + ro output + ro link aggregation \[name] + ro index? + ro name + ro protocol? + ro runner active? + ro state? + ro member \[name] \| + ro name \| + ro status? \| + ro synced? + ro description? table of properties name required type/range description show link aggregation summary m path only node, has no configurable value link aggregation ro (sub property of output) path only node, has no configurable value index ro 0 65535 (sub property of link aggregation) name ro string (sub property of link aggregation) protocol ro "lacp" "static" "not available" (sub property of link aggregation) runner active ro "active" "inactive" "not available" (sub property of link aggregation) state ro "up" "down" "not available" (sub property of link aggregation) member ro (sub property of link aggregation) path only node, has no configurable value name ro string (sub property of member) status ro "selected" "deselected" "up" "down" (sub property of member) synced ro "synced" "not synced" "not available" (sub property of member) description ro string (sub property of link aggregation)