April 26th 2019 Updates

Simplified Operations

Device Stats at Org Level [API]

APIs have always been and continues to be the foundation to our Mist AI platform, and this week we expanded its functionality by allowing you to GET statistics for all devices in your organization across all sites. Results are paginated to show 100 devices on each page but by using the HTTP header, you may navigate through the pages to see all devices. You may also use the headers to increase the number of devices shown on each page. Devices listed will show all of the config stats, including their site id. Use this API call to get a more complete picture when trying to monitor all APs in your organization.

Here is a sample output:

GET /api/v1/orgs/:org_id/stats/devices

HTTP 200 OK
Allow: OPTIONS, GET
Content-Type: application/json
Vary: Accept
X-Page-Limit: 100
X-Page-Page: 1
X-Page-Total: 966

[
{
"switch_config": {
"wds": {},
"eth1": {},
"module": {},
"eth0": {}
},
"ip": "10.2.19.218",
"x_m": 9.744,
"site_id": "978c48e6-6ef6-11e6-8bbf-02e208b2d34f",
"tag_uuid": "9777c1a0-6ef6-11e6-8bbf-02e208b2d34f",
"deviceprofile_id": null,
"created_time": 1554845635,
"serial": "1003618020201",
"id": "00000000-0000-0000-1000-5c5b358e6fea",
"uptime": 90724,
"disable_module": false,
"ble_config": {
"eddystone_uid_enabled": false,
"ibeacon_enabled": false,
"beacon_enabled": true,
"power_mode": "default",
"beacon_rate_mode": "default",
"eddystone_url_enabled": false,
"beam_disabled": []
},
"hw_rev": "E06",
"y_m": 5.904,
"version": "0.3.15257",
"disable_eth1": false,
"type": "ap",
"status": "connected",
"map_id": "958ce512-c8b7-11e6-8fff-0242ac110002",
"_ttl": 1209575,
"modified_time": 1556210783,
"mac": "5c5b358e6fea",
"mesh": {
"enabled": false,
"role": "base"
},
"tag_id": 60328,
"radio_config": {
"ant_gain_5": 0,
"ant_gain_24": 0
},
"name": "LD_Testbed",
"org_id": "9777c1a0-6ef6-11e6-8bbf-02e208b2d34f",
"poe_passthrough": false,
"ip_config": {
"type": "dhcp"
},
"y": 246,
"x": 406,
"model": "AP41",
"_id": "5c5b358e6fea",
"last_seen": 1556300824
},

...

Site Variables for Dynamic VLAN [API]

Site variables are useful when setting up a universal template to be used for multiple sites, while still maintaining unique VLAN configuration between the sites. Previously, only tagged VLANs and VLAN Pools were capable of being set to a site variable, but this week we are increasing the scope of site variable capabilities by supporting dynamic VLANs as well. Please note that this function is purely API for now – in the WLAN configurations, set “dynamic_vlan” to your site variable, and then follow the configuration below to define your variable.

PUT /api/v1/sites/:site_id/setting

DYNAMIC_VLANS = "{\"enabled\": true,\"type\": \"airespace-interface-name\",\"vlans\":{\"131\": \"default\",\"322\": \"fast,video\"}\"default_vlan_id\": 999,\"local_vlan_ids\": []}"

This is equivalent to a dynamic vlan with this configuration:

{
"dynamic_vlan": {
"enabled": true,
"type": "airespace-interface-name",
"vlans": {
"131": "default",
"322": "fast,video"
}
}
}