v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB

Managed Kubernetes

Get k8s cluster

get/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}

Path parameters

project_idinteger required

Project ID

Example:1

Project ID

region_idinteger required

Region ID

Example:7

Region ID

cluster_namestring required

Cluster name

Example:my-cluster

Cluster name

Response

autoscaler_configobject nullable

Cluster autoscaler configuration.

It contains overrides to the default cluster-autoscaler parameters provided by the platform.

created_atstring required

Function creation date

creator_task_idstring nullable

Task that created this entity

fixed_networkstring nullable

Fixed network id

fixed_subnetstring nullable

Fixed subnet id

idstring required

Cluster pool uuid

is_ipv6boolean

Enable public v6 address

is_publicboolean required

Cluster is public

keypairstring required

Keypair

namestring required

Name

pods_ip_poolstring nullable

The IP pool for the pods

pods_ipv6_poolstring nullable

The IPv6 pool for the pods

services_ip_poolstring nullable

The IP pool for the services

services_ipv6_poolstring nullable

The IPv6 pool for the services

status'Deleting' | 'Provisioned' | 'Provisioning' required

task_idstring nullable

The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.

versionstring required

K8s version

Example response

{
  "add_ons": {
    "slurm": {
      "enabled": true,
      "file_share_id": "cbc94d0e-06c6-4d12-9e86-9782ba14fc8c",
      "ssh_key_ids": [
        "25735292-bd97-44b0-a1af-d7eab876261d",
        "efc01f3a-35b9-4385-89f9-e38439093ee7"
      ],
      "worker_count": 2
    }
  },
  "authentication": {
    "kubeconfig_created_at": "2024-02-15T11:53:03Z",
    "kubeconfig_expires_at": "2026-02-15T11:53:03Z",
    "oidc": {
      "client_id": "kubernetes",
      "groups_claim": "groups",
      "groups_prefix": "oidc:",
      "issuer_url": "https://accounts.provider.example",
      "required_claims": {
        "claim": "value"
      },
      "signing_algs": [
        "RS512"
      ],
      "username_claim": "sub",
      "username_prefix": "oidc:"
    }
  },
  "autoscaler_config": {
    "scale-down-unneeded-time": "5m"
  },
  "cni": {
    "cilium": {
      "mask_size": 24,
      "mask_size_v6": 120
    }
  },
  "created_at": "2023-02-15T11:53:03Z",
  "creator_task_id": "1772de21-f013-4b70-9f8f-a518985b3bc2",
  "csi": {
    "nfs": {
      "vast_enabled": true
    }
  },
  "ddos_profile": {
    "enabled": true,
    "fields": [
      {
        "base_field": 10,
        "field_value": [
          45046,
          45047
        ]
      }
    ],
    "profile_template": 29
  },
  "fixed_network": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "fixed_subnet": "90729bc3-dd37-4761-ae09-b32f2f0a365b",
  "id": "f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1",
  "is_ipv6": true,
  "keypair": "mykeypair",
  "logging": {
    "destination_region_id": 1,
    "enabled": true,
    "retention_policy": {
      "period": 45
    },
    "topic_name": "my-log-name"
  },
  "name": "test k8s",
  "pods_ip_pool": "172.16.0.0/18",
  "pods_ipv6_pool": "2a03:90c0:88:393::/64",
  "pools": [
    {
      "auto_healing_enabled": true,
      "boot_volume_size": 50,
      "boot_volume_type": "ssd_hiiops",
      "created_at": "2023-02-15T11:53:03+03:00",
      "crio_config": {
        "default-ulimits": "nofile=1024:2048"
      },
      "flavor_id": "g1-standard-1-2",
      "id": "f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1",
      "is_public_ipv4": true,
      "kubelet_config": {
        "podMaxPids": "4096"
      },
      "labels": {
        "my-label": "foo"
      },
      "max_node_count": 10,
      "min_node_count": 1,
      "name": "test",
      "node_count": 2,
      "servergroup_id": "1772de21-f013-4b70-9f8f-a518985b3bc2",
      "servergroup_name": "my-server-group",
      "servergroup_policy": "anti-affinity",
      "status": "Running",
      "taints": {
        "my-taint": "bar:NoSchedule"
      }
    }
  ],
  "services_ip_pool": "172.24.0.0/18",
  "services_ipv6_pool": "2a03:90c0:88:381::/108",
  "version": "v1.28.1"
}