searchSiteJunosPorts

GET https://{{host}}/api/v1/sites/:site_id/stats/ports/search

Filter Options

NameTypeDescription
full_duplexbooleanindicates full or half duplex
macstringdevice identifier
neighbor_macstringChassis identifier of the chassis type listed
neighbor_port_descstringDescription supplied by the system on the interface E.g. “GigabitEthernet2/0/39”
neighbor_system_namestringName supplied by the system on the interface E.g. neighbor system name E.g. “Kumar-Acc-SW.mist.local”
poe_disabledbooleanwhether PoE capabilities are disabled for a port, default is false
poe_modestringPoE mode depending on class. 802.3af / 802.3at / 802.3bt
poe_onbooleanis the device attached to POE
port_idstringinterface name
port_macstringinterface mac address
power_drawfloatAmount of power being used by the interface at the time the command is executed. Unit in watts.
tx_pktsintOutput packets
rx_pktsintInput packets
tx_bytesintOutput bytes
rx_bytesintInput bytes
tx_bpsintOutput rate
rx_bpsintInput rate
tx_errorsintOutput errors
rx_errorsintInput errors
tx_mcast_pktsintMulticast output packets
tx_bcast_pktsintBroadcast output packets
rx_mcast_pktsintMulticast input packets
rx_bcast_pktsintBroadcast input packets
speedintport speed
mac_limitintLimit on number of dynamically learned macs
mac_countintNumber of mac addresses in the forwarding table
upbooleanindicates if interface is up
stp_statestringif up == true, forwarding / blocking / learning / listening / disabled
stp_rolestringif up == true, designated / backup / alternate / root / root-prevented
xcvr_part_numberstringOptic Slot Partnumber, Check for null/empty
auth_statestringif up == true && has Authenticator role, init / authenticated / authenticating / held

Request Params

KeyDatatypeRequiredDescription
full_duplexnullboolean:indicates full or half duplex
macnullstring:device identifier
neighbor_macnullstring:Chassis identifier of the chassis type listed
neighbor_port_descnullstring:Description supplied by the system on the interface E.g. “GigabitEthernet2/0/39”
neighbor_system_namenullstring:Name supplied by the system on the interface E.g. neighbor system name E.g. “Kumar-Acc-SW.mist.local”
poe_disablednullboolean:is the POE configured not be disabled.
poe_modenullstring:poe mode depending on class E.g. “802.3at”
poe_onnullboolean:is the device attached to POE
port_idnullstring:interface name
port_macnullstring:interface mac address
power_drawnullfloat:Amount of power being used by the interface at the time the command is executed. Unit in watts.
tx_pktsnullint:Output packets
rx_pktsnullint:Input packets
tx_bytesnullint:Output bytes
rx_bytesnullint:Input bytes
tx_bpsnullint:Output rate
rx_bpsnullint:Input rate
tx_errorsnullint:Output errors
rx_errorsnullint:Input errors
tx_mcast_pktsnullint:Multicast output packets
tx_bcast_pktsnullint:Broadcast output packets
rx_mcast_pktsnullint:Multicast input packets
rx_bcast_pktsnullint:Broadcast input packets
speednullint:port speed
upnullboolean:indicates if interface is up
stp_statenullstring:if up == true, forwarding / blocking / learning / listening / disabled
stp_rolenullstring:if up == true, designated / backup / alternate / root / root-prevented
xcvr_part_numbernullstring, Optic Slot Partnumber, Check for null/empty
auth_statenullstring:if up == true && has Authenticator role, init / authenticated / authenticating / held