import requests
url = "https://platform.ankra.app/api/v1/clusters/aws/{cluster_id}/start"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://platform.ankra.app/api/v1/clusters/aws/{cluster_id}/start', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url https://platform.ankra.app/api/v1/clusters/aws/{cluster_id}/start \
--header 'Authorization: Bearer <token>'{
"marked_to_start_at": "2023-11-07T05:31:56Z",
"created_operations": 0,
"scope": "all",
"state_restore": "requested",
"state_snapshot_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state_snapshot": {
"captured_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"trigger": "<string>"
},
"captured_state_snapshots": 0,
"state_restore_message": "<string>"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "Cluster not found"
}Start a stopped cluster
Bearer PAT authentication; RBAC permission clusters.operate. Answers 404 while the organisation’s aws_provider feature flag is off.
import requests
url = "https://platform.ankra.app/api/v1/clusters/aws/{cluster_id}/start"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://platform.ankra.app/api/v1/clusters/aws/{cluster_id}/start', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url https://platform.ankra.app/api/v1/clusters/aws/{cluster_id}/start \
--header 'Authorization: Bearer <token>'{
"marked_to_start_at": "2023-11-07T05:31:56Z",
"created_operations": 0,
"scope": "all",
"state_restore": "requested",
"state_snapshot_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state_snapshot": {
"captured_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"trigger": "<string>"
},
"captured_state_snapshots": 0,
"state_restore_message": "<string>"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "Cluster not found"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
PAT organisation override.
Path Parameters
Response
Successful response
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).
requested, none, skipped The restored snapshot's id, set with state_restore=requested.
The restored snapshot, set with state_restore=requested.
Show child attributes
Show child attributes
How many captured state snapshots of the cluster a start could restore, the restored one included.
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.