getOrgMxEdges

GET https://{{host}}/api/v1/orgs/:org_id/mxedges

Query Parameters

NameTypeDescription
for_sitebooleantrue / false/ any (default false). Filter for site level mist edges

Response Parameters

NameTypeDescription
mxcluster_idstringMxCluster this MxEdge belongs to
oob_ip_configobjectip configuration of the Mist Edge out-of-band management interface
proxyobjectProxy Configuration to talk to Mist
tunterm_ip_configobjectip configuration of the Mist Tunnel interface
tunterm_other_ip_configsobjectip configuration of the Mist Tunneled VLANs
tunterm_extra_routesobjectextra routes for Mist Tunneled VLANs
tunterm_dhcpd_configobjectDHCP server/relay configuration of Mist Tunneled VLANs
serviceslistlist of services to run, tunterm only for now
tunterm_port_configobjectethernet port configurations
separate_upstream_downstreambooleanweather to separate upstream / downstream ports. default is false where all ports will be used.
downstream_portslistlist of ports to be used for downstream (to AP) purpose
upstream_portslistlist of ports to be used for upstrea purpose (to LAN)
upstream_port_vlan_idintnative VLAN id for upstream ports, default is 1
tunterm_igmp_snooping_configobjecttunterm igmp snooping config
MxEdge OOB IP Config
NameTypeDescription
oob_ip_configobjectip config
typestringstatic. default: not managed from cloud.
ipstringrequired if type==static
netmaskstringrequired if type==static
gatewaystringrequired if type==static
dnslistif type==static. default is 8.8.8.8, 8.8.4.4
MxEdge Mist Tunnel IP Config
NameTypeDescription
tunterm_ip_configobjectip config
ipstringrequired
netmaskstringrequired
gatewaystringrequired
MxEdge Mist Tunnel VLAN IP Config
ParameterTypeDescription
tuntermotherip_configsobjectip configs by VLAN ID
ipstringrequired
netmaskstringrequired
Extra Routes for Mist Tunneled VLANs
ParameterTypeDescription
tuntermextraroutesobjectkey is the dest
viastringnext-hop
DHCP server/relay for Mist Tunneled VLANs
ParameterTypeDescription
tuntermdhcpdconfigobjectglobal and per-VLAN
typestringrelay (default)
enabledbooleanenabled or not, default is false
serverslistDHCP servers; required if type==relay
Tunterm IGMP Snooping Config
ParameterTypeDescription
tuntermigmpsnooping_configobjecttunterm igmp snooping config
vlan_idsarray of intsthe list of vlans on which tunterm performs IGMP snooping
querier.query_intervalintquerier’s query interval, in seconds
querier.maxresponsetimeintquerier’s query response interval, in tenths-of-seconds
querier.robustnessintquerier’s robustness (1 to 7)
querier.versionintquerier’s maximum protocol version
querier.mtuintthe MTU we use (needed when forming large IGMPv3 Reports)

Request Params

KeyDatatypeRequiredDescription
for_sitenulltrue / false/ any (default false). Filter for site level mist edges

RESPONSES

status: OK

[{"id":"95ddd29a-6a3c-929e-a431-51a5b09f36a6","name":"Guest","model":"ME-100","magic":"L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD","tunterm_registered":true,"mxagent_registered":true,"proxy":{"url":"http://proxy.internal:8080/"},"mxedge_mgmt":{"mist_password":"MIST_PASSWORD","root_password":"ROOT_PASSWORD"},"oob_ip_config":{"type":"static","ip":"10.2.1.10","netmask":"255.255.255.0","gateway":"10.2.1.254","type6":"static","ip6":"2601:1700:43c0:dc0:20c:29ff:fea7:93bc","netmask6":"/64","gateway6":"2601:1700:43c0:dc0::1","dns":["10.2.1.2","2601:1700:43c0:dc0::2"]},"tunterm_ip_config":{"ip":"10.2.1.1","netmask":"255.255.255.0","gateway":"10.2.1.254","ip6":"2001:1010:1010:1010::2","netmask6":"/64","gateway6":"2001:1010:1010:1010::1"},"tunterm_other_ip_configs":{"5":{"ip":"10.3.3.1","netmask":"255.255.255.0"}},"tunterm_extra_routes":{"11.0.0.0/8":{"via":"10.3.3.1"}},"tunterm_dhcpd_config":{"enabled":false,"servers":["11.2.3.4"],"2":{"enabled":true,"servers":["11.2.3.44"]}},"tunterm_port_config":{"separate_upstream_downstream":true,"downstream_ports":["3"],"upstream_ports":["0","1","2"],"upstream_port_vlan_id":30},"tunterm_switch_config":{"enabled":true,"0":{"vlan_ids":[1,3055],"port_vlan_id":1}},"tunterm_monitoring":[{"protocol":"ping","host":"10.2.8.15","timeout":300,"port":80}],"ntp_servers":[],"mxcluster_id":"572586b7-f97b-a22b-526c-8b97a3f609c4","tunterm_igmp_snooping_config":{"enabled":true,"vlan_ids":[2,3,5],"querier":{"query_interval":125,"max_response_time":10,"robustness":2,"version":3,"mtu":1500}},"tunterm_multicast_config":{"mdns":{"enabled":true,"vlan_ids":[2,3,5]},"ssdp":{"enabled":true,"vlan_ids":[2,3,5]}}}]