Resize a standalone VM (browser session)

Browser session authentication; RBAC permission clusters.write. PAT mutations support wait=false where implemented; browser mutations require CSRF. Answers 404 while the organisation’s aws_provider feature flag is off.

PUT /org/clusters/aws/{cluster_id}/vms/{vm_id}/instance-type

Resize a standalone VM (browser session)

Python

import requests

url = "https://api.platform.ankra.app/org/clusters/aws/{cluster_id}/vms/{vm_id}/instance-type"

payload = {
    "abandon_pending_resize": False,
    "force_drain": False,
    "instance_type": "<string>"
}
headers = {
    "cookie": "ankra_session=",
    "X-Ankra-CSRF": "<x-ankra-csrf>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "instance_type": "<string>",
  "operation_id": "<string>"
}

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

vm_id · string<uuid> · required

Body

application/json

abandon_pending_resize · boolean · default: false

Abandon the resize the group has pending instead of asking for one: each server's definition goes back to the type it actually runs and its resize markers are cleared, with nothing drained or powered off. Use it for a resize that cannot land (a drain the PodDisruptionBudgets block, a disk the provider will not shrink). instance_type is not needed when this is true; a group with no pending resize answers 409.

force_drain · boolean · default: false

Bypass PodDisruptionBudgets when draining each node before it is power-cycled. Off by default: a budget is a workload owner's stated availability requirement.

instance_type · string

The new instance type for every node in the group. Changing it power-cycles each node, so the nodes are rolled in bounded lanes and each is drained before it goes down.

Response

200

application/json

Successful response

UpdateStandaloneVMInstanceTypeResult

AsyncWriteAcceptedResponse

id · string<uuid> · required

name · string · required

instance_type · string · required

operation_id · string | null · required