getOrgMxEdges
GET https://{{host}}/api/v1/orgs/:org_id/mxedges
Query Parameters
Name | Type | Description |
---|
for_site | boolean | true / false/ any (default false). Filter for site level mist edges |
Response Parameters
Name | Type | Description |
---|
mxcluster_id | string | MxCluster this MxEdge belongs to |
oob_ip_config | object | ip configuration of the Mist Edge out-of-band management interface |
proxy | object | Proxy Configuration to talk to Mist |
tunterm_ip_config | object | ip configuration of the Mist Tunnel interface |
tunterm_other_ip_configs | object | ip configuration of the Mist Tunneled VLANs |
tunterm_extra_routes | object | extra routes for Mist Tunneled VLANs |
tunterm_dhcpd_config | object | DHCP server/relay configuration of Mist Tunneled VLANs |
services | list | list of services to run, tunterm only for now |
tunterm_port_config | object | ethernet port configurations |
separate_upstream_downstream | boolean | weather to separate upstream / downstream ports. default is false where all ports will be used. |
downstream_ports | list | list of ports to be used for downstream (to AP) purpose |
upstream_ports | list | list of ports to be used for upstrea purpose (to LAN) |
upstream_port_vlan_id | int | native VLAN id for upstream ports, default is 1 |
tunterm_igmp_snooping_config | object | tunterm igmp snooping config |
MxEdge OOB IP Config
Name | Type | Description |
---|
oob_ip_config | object | ip config |
type | string | static. default: not managed from cloud. |
ip | string | required if type==static |
netmask | string | required if type==static |
gateway | string | required if type==static |
dns | list | if type==static. default is 8.8.8.8, 8.8.4.4 |
MxEdge Mist Tunnel IP Config
Name | Type | Description |
---|
tunterm_ip_config | object | ip config |
ip | string | required |
netmask | string | required |
gateway | string | required |
MxEdge Mist Tunnel VLAN IP Config
Parameter | Type | Description |
---|
tuntermotherip_configs | object | ip configs by VLAN ID |
ip | string | required |
netmask | string | required |
Parameter | Type | Description |
---|
tuntermextraroutes | object | key is the dest |
via | string | next-hop |
DHCP server/relay for Mist Tunneled VLANs
Parameter | Type | Description |
---|
tuntermdhcpdconfig | object | global and per-VLAN |
type | string | relay (default) |
enabled | boolean | enabled or not, default is false |
servers | list | DHCP servers; required if type==relay |
Tunterm IGMP Snooping Config
Parameter | Type | Description |
---|
tuntermigmpsnooping_config | object | tunterm igmp snooping config |
vlan_ids | array of ints | the list of vlans on which tunterm performs IGMP snooping |
querier.query_interval | int | querier’s query interval, in seconds |
querier.maxresponsetime | int | querier’s query response interval, in tenths-of-seconds |
querier.robustness | int | querier’s robustness (1 to 7) |
querier.version | int | querier’s maximum protocol version |
querier.mtu | int | the MTU we use (needed when forming large IGMPv3 Reports) |
Request Params
Key | Datatype | Required | Description |
---|
for_site | null | | true / 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]}}}]