v32

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

Managed Kubernetes

Create k8s cluster pool

post/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools

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

Request body

auto_healing_enabledboolean nullable

Enable auto healing

boot_volume_sizeinteger nullable

Boot volume size

Boot volume type

crio_configobject nullable

Cri-o configuration for pool nodes

flavor_idstring required

Flavor ID

is_public_ipv4boolean nullable

Enable public v4 address

kubelet_configobject nullable

Kubelet configuration for pool nodes

labelsobject nullable

Labels applied to the cluster pool

max_node_countinteger nullable

Maximum node count

min_node_countinteger required

Minimum node count

namestring required

Pool's name

servergroup_policy'affinity' | 'anti-affinity' | 'soft-anti-affinity'

taintsobject nullable

Taints applied to the cluster pool

Example request

{
  "auto_healing_enabled": true,
  "boot_volume_size": 50,
  "boot_volume_type": "ssd_hiiops",
  "crio_config": {
    "default-ulimits": "nofile=1024:2048"
  },
  "flavor_id": "g1-standard-1-2",
  "is_public_ipv4": true,
  "kubelet_config": {
    "podMaxPids": "4096"
  },
  "labels": {
    "my-label": "foo"
  },
  "max_node_count": 5,
  "min_node_count": 3,
  "name": "my-pool",
  "taints": {
    "my-taint": "bar:NoSchedule"
  }
}

Response

tasksstring[] required

List of task IDs representing asynchronous operations. Use these IDs to monitor operation progress:

GET /v1/tasks/{task_id} - Check individual task status and details Poll task status until completion (FINISHED/ERROR) before proceeding with dependent operations.

idstring required

Example response

{
  "tasks": [
    "d478ae29-dedc-4869-82f0-96104425f565"
  ]
}