getOrgMultiSitesDevicesUpgrade
GET https://{{host}}/api/v1/orgs/:org_id/devices/upgrade/:upgrade_id
Response Parameters
| Name | Type | Description |
|---|---|---|
id | uuid | unique id for the org upgrade |
target_version | string | version to upgrade to |
strategy | string | upgrade strategy |
enable_p2p | bool | whether to allow local AP-to-AP FW upgrade |
force | bool | whether to force upgrade when requested version is same as running version |
upgrades | array of upgrades | array of site upgrades, one upgrade for each site |
upgrade.id | uuid | unique id for the site upgrade |
upgrade.status | string | status upgrade is in (created/in_progress/completed/cancelled) |
upgrade.start_time | int | upgrade start time in epoch |
upgrade.targets.total | int | count of devices part of this upgrade |
upgrade.targets.scheduled | array of strings | devices which cloud has scheduled an upgrade |
upgrade.targets.download_requested | array of strings | devices which cloud has requested to download firmware |
upgrade.targets.downloaded | array of strings | devices which have the firmware downloaded |
upgrade.targets.reboot_in_progress | array of strings | devices which are rebooting |
upgrade.targets.rebooted | array of strings | devices which have rebooted successfully |
upgrade.targets.upgraded | array of strings | devices which have upgraded successfully |
upgrade.targets.skipped | array of strings | devices which have skipped upgrade since requested version was same as running version. Use force to always upgrade |
upgrade.targets.failed | array of strings | devices which have failed to upgrade |
RESPONSES
status: OK
{"id":"510faff9-0c55-4112-8796-f7589da0f7bc","target_version":"apfw-0.7.20216-gilly-d4fc","strategy":"big_bang","enable_p2p":false,"force":false,"upgrades":[{"site_id":"1916d52a-4a90-11e5-8b45-1258369c38a9","upgrade":{"id":"9b5fde1d-bda4-486f-8eb6-4368aa30cf30","status":"created","start_time":1626892546,"targets":{"scheduled":[],"downloaded":[],"download_requested":[],"reboot_in_progress":[],"rebooted":[],"skipped":[],"failed":[],"total":1}}},{"site_id":"65c2095a-e049-4267-88a5-5019e4b69a4d","upgrade":{"id":"510faff9-0c55-4112-8796-f7589da0f7bc","status":"created","start_time":1626892546,"targets":{"scheduled":[],"downloaded":[],"download_requested":[],"reboot_in_progress":[],"rebooted":[],"skipped":[],"failed":[],"total":1}}}]}