Read Kubernetes version

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

GET /api/v1/clusters/aws/{cluster_id}/k8s-version

Read Kubernetes version

Python

import requests

url = "https://platform.ankra.app/api/v1/clusters/aws/{cluster_id}/k8s-version"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "current_version": "<string>",
  "distribution": "<string>",
  "auto_patch_upgrade_enabled": false,
  "desired_version": "<string>",
  "nodes": [
    {
      "name": "<string>",
      "role": "<string>",
      "state": "<string>",
      "desired_version": "<string>",
      "observed_version": "<string>"
    }
  ],
  "observed_version": "<string>",
  "upgrade_execution": {
    "blocking_pdbs": [
      {
        "disruptions_allowed": 123,
        "name": "<string>",
        "namespace": "<string>"
      }
    ],
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "parked_node": "<string>",
    "status": "<string>"
  },
  "version_drift": false
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-ankra-organisation-id · string

PAT organisation override.

Path Parameters

cluster_id · string<uuid> · required

Response

200

application/json

Successful response

current_version · string | null · required

distribution · string · required

auto_patch_upgrade_enabled · boolean · default: false

desired_version · string | null

nodes · K8sNodeVersion · object[]

Show child attributes

observed_version · string | null

upgrade_execution · K8sUpgradeExecution · object | null

The execution that owns the rollout to the cluster's desired version, with the park its steps recorded.

Show child attributes

version_drift · boolean · default: false