upgradeOrgMultiSitesDevices

POST https://{{host}}/api/v1/orgs/:org_id/devices/upgrade

Body Parameters

Name	Type	Description
`version`	`string`	default is `stable`
`enable_p2p`	`boolean`	whether to allow local AP-to-AP FW upgrade
`site_ids`	`array of strings`	site’s which need to be upgraded
`strategy`	`string`	`big_bang`(upgrade all at once), `serial`(one at a time), `canary` or `rrm`, default is big_bang
`canary_phases`	`array of ints`	phases for canary deployment, default is [1, 10, 50, 100]
`max_failures`	`array of ints`	number of failures allowed within a canary phase or serial rollout. Will be used if provided, else maxfailurepercentage will be used
`max_failure_percentage`	`int`	percentage of failures allowed within a canary phase or serial rollout, default is 5
`rrm_node_order`	`string`	fringetocenter or centertofringe (default fringetocenter)
`rrm_slow_ramp`	`boolean`	true will make rrm batch sizes slowly ramp up
`start_time`	`long`	upgrade start time in epoch seconds, default is now
`reboot_at`	`long`	reboot start time in epoch seconds, default is `start_time`
`force`	`bool`	true will force upgrade when requested version is same as running version

Request Body

{"version"=>"3.1.5", "enable_p2p"=>false, "site_ids"=>["4ac1dcf4-9d8b-7211-65c4-057819f0862b", "d96e3952-53e8-4266-959a-45acd55f5114"], "models"=>["AP41"], "strategy"=>"canary", "canary_phases"=>[5, 25, 50, 100], "max_failures"=>[1, 1, 5], "max_failure_percentage"=>5, "start_time"=>1624399840, "force"=>true}

RESPONSES

status: OK

{&quot;id&quot;:&quot;f57096b9-0c2f-4df6-c77b-ae6ae87a3d43&quot;}