REFERENCE

v6.11.0

PoE

Power-over-Ethernet status and configuration (`/interface ethernet poe`).

Tools

get_poe_monitor

Read PoE Interface Live Metrics · Risk: read

Read live Power-over-Ethernet monitor data (/interface ethernet poe monitor <interfaces> once) — returns a real-time snapshot of PoE-out status, voltage (V), current (mA), and power (W) for one or more interfaces. Use this to diagnose active power delivery on PoE ports or confirm a powered device is drawing current. For static PoE-out configuration (mode, priority, thresholds) use get_poe_settings; for a summary list of all PoE-capable interfaces use list_poe. The interfaces argument takes a comma-separated list of ethernet interface names, e.g. 'ether1' or 'ether9,ether10'.

ParameterRequiredDefinition
interfacesYesComma-separated ethernet interface name(s), e.g. 'ether1' or 'ether9,ether10' {"type":"string"}

list_poe

List PoE Interface Configuration · Risk: read

List the Power-over-Ethernet configuration of all PoE-capable ethernet interfaces (/interface ethernet poe print) — returns PoE-out mode and priority for each port. Use this to see at a glance which ports have PoE-out enabled across the whole device. For detailed settings of one specific interface (voltage thresholds, etc.) use get_poe_settings; for real-time voltage/current/power readings use get_poe_monitor. Optionally narrow results by partial interface name via interface_filter, e.g. 'ether'.

ParameterRequiredDefinition
interface_filterNoPartial name match, e.g. 'ether' {"type":"string"}

get_poe_settings

Get PoE Interface Settings · Risk: read

Get detailed Power-over-Ethernet settings for a single ethernet interface (/interface ethernet poe print detail where name=<name>) — returns PoE-out mode, priority, voltage, and power thresholds for that port. Use this to inspect the full PoE-out configuration of one specific port. For a summary list across all PoE-capable interfaces use list_poe; for real-time voltage/current/power measurements use get_poe_monitor. The name argument takes the exact interface name, e.g. 'ether1'.

ParameterRequiredDefinition
nameYesExact ethernet interface name, e.g. 'ether1' {"type":"string"}

On this page