Skip to main content
POST
Start a stopped cluster (browser session)

Authorizations

ankra_session
string
cookie
required

Browser session. Mutations also require X-Ankra-CSRF.

Headers

X-Ankra-CSRF
string
required

Must match the ankra_csrf browser cookie.

Path Parameters

cluster_id
string<uuid>
required

Response

Successful response

marked_to_start_at
string<date-time>
required
created_operations
integer
default:0
scope
string
default:all
state_restore
enum<string>

What the first control plane does with the cluster's etcd: requested (it restores state_snapshot), none (nothing captured, or the cluster kept its etcd), skipped (restore_state=false: it bootstraps an empty etcd).

Available options:
requested,
none,
skipped
state_snapshot_id
string<uuid>

The restored snapshot's id, set with state_restore=requested.

state_snapshot
State Snapshot · object

The restored snapshot, set with state_restore=requested.

captured_state_snapshots
integer
default:0

How many captured state snapshots of the cluster a start could restore, the restored one included.

state_restore_message
string

One sentence on what happens to the cluster's state: the snapshot restored (id, trigger, capture time), or that the cluster boots with an empty etcd and how many captured snapshots are left unrestored.