Software

Invoke the upgrade operation

Initiate a cluster wide upgrade to the image provided. During normal operations the system will automatically detect that an upgrade is needed, this action is only intended as a manual last resort.

SecurityaccessToken
Request
query Parameters
site
string

Send the request to the specfifed site

Request Body schema:
image
required
string
Responses
204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

503

Service Unavailable (strongbox sealed)

post/v1/state/system/cluster/software/upgrade
Request samples
image: avassa/supd:latest

Invoke the upgrade-host operation

Initiate a host upgrade attempt. Only works on an edge node. This is different from the upgrade action in that it only tries to upgrade this host, not the whole cluster. Only to be used when a regular upgrade has failed or to get out of an upgrade corner case.

SecurityaccessToken
Request
query Parameters
site
string

Send the request to the specfifed site

Request Body schema:
host
string <domain-name>

The host on which to initiate the host upgrade on. If omitted it will be initiated on this host.

Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

503

Service Unavailable (strongbox sealed)

post/v1/state/system/cluster/software/upgrade-host
Request samples
host: metrograph-002
Response samples
result: in-progress