Switch to the next CA certificate.

Prev Next
Post
/certificate-authority/ca/next/switch

Switch to the next CA certificate. Note that this is a highly disruptive action. Read the manual before proceeding.

Security
HTTP
Type bearer
Body parameters

CA switch parameters.

object
force
boolean

Force the CA switch without making sure all Appliances are ready.

Defaultfalse
Responses
204

The migration to the next CA certificate was successful. Note that this action may trigger a restart of the Controller before returning a response.

401

Token error. Login again.

object

Generic HTTP error.

id
string

Machine readable error code.

message
string

Human readable error details.

403

Insufficient permissions to access this resource.

object

Generic HTTP error.

id
string

Machine readable error code.

message
string

Human readable error details.

404

The requested resource can not be found.

object

Generic HTTP error.

id
string

Machine readable error code.

message
string

Human readable error details.

406

Invalid 'Accept' header.

object

Generic HTTP error.

id
string

Machine readable error code.

message
string

Human readable error details.

412

One or more Appliances have failed the healthcheck for CA switch.

Expand All
object
id
string

Machine readable error code.

message
string

Human readable error details.

failedAppliances
object

A dictionary of Appliance name and failure reason.

Example{ "aws1": "Next certificate is not available yet. Try again later." }
500

Unexpected server side error.

object

Generic HTTP error.

id
string

Machine readable error code.

message
string

Human readable error details.