Skip to main content
POST
/
cloud
/
v2
/
k8s
/
clusters
/
{project_id}
/
{region_id}
/
{cluster_name}
/
pools
Python
from gcore import Gcore

client = Gcore(
    api_key="My API Key",
)
task_id_list = client.cloud.k8s.clusters.pools.create(
    cluster_name="cluster_name",
    project_id=0,
    region_id=0,
    flavor_id="g1-standard-1-2",
    min_node_count=3,
    name="my-pool",
)
print(task_id_list.tasks)
{
  "tasks": [
    "d478ae29-dedc-4869-82f0-96104425f565"
  ]
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

​
project_id
integer
required

Project identifier

​
region_id
integer
required

Region identifier

​
cluster_name
string
required

Cluster name

Body

application/json
​
flavor_id
string
required

Flavor ID

Examples:

"g1-standard-1-2"

​
min_node_count
integer
required

Minimum node count

Required range: 1 <= x <= 200
Examples:

3

​
name
string
required

Pool's name

Required string length: 1 - 20
Examples:

"my-pool"

​
auto_healing_enabled
boolean | null
default:false

Enable auto healing

Examples:

true

false

​
boot_volume_size
integer | null

Boot volume size

Required range: 10 <= x <= 2000
Examples:

50

​
boot_volume_type
enum<string> | null

Boot volume type

Available options:
cold,
ssd_hiiops,
ssd_local,
ssd_lowlatency,
standard,
ultra
Examples:

"ssd_hiiops"

​
crio_config
object | null

Cri-o configuration for pool nodes

Examples:
{ "default-ulimits": "nofile=1024:2048" }
​
is_public_ipv4
boolean | null
default:false

Enable public v4 address

Examples:

true

false

​
kubelet_config
object | null

Kubelet configuration for pool nodes

Examples:
{ "podMaxPids": "4096" }
​
labels
object | null

Labels applied to the cluster pool

Examples:
{ "my-label": "foo" }
​
max_node_count
integer | null

Maximum node count

Required range: 1 <= x <= 200
Examples:

5

​
servergroup_policy
enum<string> | null

Server group policy: anti-affinity, soft-anti-affinity or affinity

Available options:
affinity,
anti-affinity,
soft-anti-affinity
​
taints
object | null

Taints applied to the cluster pool

Examples:
{ "my-taint": "bar:NoSchedule" }

Response

Task IDs for pool creation

​
tasks
string[]
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.

Examples:
["d478ae29-dedc-4869-82f0-96104425f565"]