upgradeOrgMxEdge
POST https://{{host}}/api/v1/orgs/:org_id/mxedges/upgrade
Body Parameters
| Name | Type | Description |
|---|---|---|
mxedge_ids | list | list of mxedge IDs to upgrade or all mxedges in this organization (default) |
channel | string | upgrade channel to follow, stable (default) / beta / alpha |
distro | string | distro upgrade, optional, to specific codename (e.g. bullseye) with highest qualified versions |
versions | object | services to upgrade, ignored if distro upgrade, tunterm or radsecproxy or mxagent or mxocproxy or mxdas |
allow_downgrades | object | optional, default value is false |
strategy | string | big_bang(upgrade all at once) or serial(one at a time), default is big_bang |
Request Body
{"mxedge_ids"=>["387804a7-3474-85ce-15a2-f9a9684c9c90"], "channel"=>"stable", "distro"=>"<codename>", "versions"=>{"mxagent"=>"latest", "tunterm"=>"default", "radsecproxy"=>"<version>"}, "allow_downgrades"=>{"mxagent"=>false, "tunterm"=>true}}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string | ||
X-CSRFToken | string | ||
Content-Type | string |
RESPONSES
status: OK
{"id":"95ddd29a-6a3c-929e-a431-51a5b09f36a6","name":"Edge1","magic":"ExNpT5gi-ADR8WTFd4EiQPY3cP5WdSoD","tunterm_registered":false,"mxagent_registered":false,"mxcluster_id":"572586b7-f97b-a22b-526c-8b97a3f609c4"}