Hi, The API documentation is pretty good but lacks details of all return values for what I suspect are enums for the state. Specifically:
Thanks, Martin
Solved! Go to solution.
I hear you! Was messing about with the firmware update call and one of the firmware release types was "candidate", which I'm not really clear about.
They definitely need to tell us all the possible return values for a call and what they mean.
I believe for the device status call online and offline are the only two possibilites.
I was able to find this for you:
https://documentation.meraki.com/MX/Monitoring_and_Reporting/Appliance_Status/MX_Uplink_Settings
If you look at the Uplink Status section you should be able to find the possible states. I completely agree with you though!
I hear you! Was messing about with the firmware update call and one of the firmware release types was "candidate", which I'm not really clear about.
They definitely need to tell us all the possible return values for a call and what they mean.
I believe for the device status call online and offline are the only two possibilites.
I was able to find this for you:
https://documentation.meraki.com/MX/Monitoring_and_Reporting/Appliance_Status/MX_Uplink_Settings
If you look at the Uplink Status section you should be able to find the possible states. I completely agree with you though!
Thanks for the link, missed that section of the docs, though I'm cautious if the docs would reflect all possible states. I'm curious if device status is more and online/offline for example does the status change when it's rebooting, upgrading. or even in some unknown state.
The API docs show the relevant possible values for device status: https://developer.cisco.com/meraki/api-v1/#!get-organization-devices-statuses-overview
Thanks John, my last point was a more general one of knowing what the valid set of values are for various statuses. For example:
As far as I know that is not documented. Agree it would be nice if it was.
Ones I am aware of:
get-organization-appliance-uplink-statuses "active", "ready", "failed", "not connected"
get-organization-appliance-vpn-statuses : "reachable" "unreachable" and "unknown"