Create k8s cluster pool

curl --request POST \
  --url https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "flavor_id": "g1-standard-1-2",
  "min_node_count": 3,
  "name": "my-pool",
  "auto_healing_enabled": true,
  "boot_volume_size": 50,
  "boot_volume_type": "ssd_hiiops",
  "crio_config": {
    "default-ulimits": "nofile=1024:2048"
  },
  "is_public_ipv4": true,
  "kubelet_config": {
    "podMaxPids": "4096"
  },
  "labels": {
    "my-label": "foo"
  },
  "max_node_count": 5,
  "security_group_ids": [
    "e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce"
  ],
  "taints": {
    "my-taint": "bar:NoSchedule"
  }
}
'

import requests

url = "https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools"

payload = {
    "flavor_id": "g1-standard-1-2",
    "min_node_count": 3,
    "name": "my-pool",
    "auto_healing_enabled": True,
    "boot_volume_size": 50,
    "boot_volume_type": "ssd_hiiops",
    "crio_config": { "default-ulimits": "nofile=1024:2048" },
    "is_public_ipv4": True,
    "kubelet_config": { "podMaxPids": "4096" },
    "labels": { "my-label": "foo" },
    "max_node_count": 5,
    "security_group_ids": ["e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce"],
    "taints": { "my-taint": "bar:NoSchedule" }
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    flavor_id: 'g1-standard-1-2',
    min_node_count: 3,
    name: 'my-pool',
    auto_healing_enabled: true,
    boot_volume_size: 50,
    boot_volume_type: 'ssd_hiiops',
    crio_config: {'default-ulimits': 'nofile=1024:2048'},
    is_public_ipv4: true,
    kubelet_config: {podMaxPids: '4096'},
    labels: {'my-label': 'foo'},
    max_node_count: 5,
    security_group_ids: ['e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce'],
    taints: {'my-taint': 'bar:NoSchedule'}
  })
};

fetch('https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'flavor_id' => 'g1-standard-1-2',
    'min_node_count' => 3,
    'name' => 'my-pool',
    'auto_healing_enabled' => true,
    'boot_volume_size' => 50,
    'boot_volume_type' => 'ssd_hiiops',
    'crio_config' => [
        'default-ulimits' => 'nofile=1024:2048'
    ],
    'is_public_ipv4' => true,
    'kubelet_config' => [
        'podMaxPids' => '4096'
    ],
    'labels' => [
        'my-label' => 'foo'
    ],
    'max_node_count' => 5,
    'security_group_ids' => [
        'e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce'
    ],
    'taints' => [
        'my-taint' => 'bar:NoSchedule'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools"

	payload := strings.NewReader("{\n  \"flavor_id\": \"g1-standard-1-2\",\n  \"min_node_count\": 3,\n  \"name\": \"my-pool\",\n  \"auto_healing_enabled\": true,\n  \"boot_volume_size\": 50,\n  \"boot_volume_type\": \"ssd_hiiops\",\n  \"crio_config\": {\n    \"default-ulimits\": \"nofile=1024:2048\"\n  },\n  \"is_public_ipv4\": true,\n  \"kubelet_config\": {\n    \"podMaxPids\": \"4096\"\n  },\n  \"labels\": {\n    \"my-label\": \"foo\"\n  },\n  \"max_node_count\": 5,\n  \"security_group_ids\": [\n    \"e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce\"\n  ],\n  \"taints\": {\n    \"my-taint\": \"bar:NoSchedule\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"flavor_id\": \"g1-standard-1-2\",\n  \"min_node_count\": 3,\n  \"name\": \"my-pool\",\n  \"auto_healing_enabled\": true,\n  \"boot_volume_size\": 50,\n  \"boot_volume_type\": \"ssd_hiiops\",\n  \"crio_config\": {\n    \"default-ulimits\": \"nofile=1024:2048\"\n  },\n  \"is_public_ipv4\": true,\n  \"kubelet_config\": {\n    \"podMaxPids\": \"4096\"\n  },\n  \"labels\": {\n    \"my-label\": \"foo\"\n  },\n  \"max_node_count\": 5,\n  \"security_group_ids\": [\n    \"e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce\"\n  ],\n  \"taints\": {\n    \"my-taint\": \"bar:NoSchedule\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"flavor_id\": \"g1-standard-1-2\",\n  \"min_node_count\": 3,\n  \"name\": \"my-pool\",\n  \"auto_healing_enabled\": true,\n  \"boot_volume_size\": 50,\n  \"boot_volume_type\": \"ssd_hiiops\",\n  \"crio_config\": {\n    \"default-ulimits\": \"nofile=1024:2048\"\n  },\n  \"is_public_ipv4\": true,\n  \"kubelet_config\": {\n    \"podMaxPids\": \"4096\"\n  },\n  \"labels\": {\n    \"my-label\": \"foo\"\n  },\n  \"max_node_count\": 5,\n  \"security_group_ids\": [\n    \"e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce\"\n  ],\n  \"taints\": {\n    \"my-taint\": \"bar:NoSchedule\"\n  }\n}"

response = http.request(request)
puts response.read_body

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

POST

cloud

k8s

clusters

{project_id}

{region_id}

{cluster_name}

pools

Create k8s cluster pool

curl --request POST \
  --url https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "flavor_id": "g1-standard-1-2",
  "min_node_count": 3,
  "name": "my-pool",
  "auto_healing_enabled": true,
  "boot_volume_size": 50,
  "boot_volume_type": "ssd_hiiops",
  "crio_config": {
    "default-ulimits": "nofile=1024:2048"
  },
  "is_public_ipv4": true,
  "kubelet_config": {
    "podMaxPids": "4096"
  },
  "labels": {
    "my-label": "foo"
  },
  "max_node_count": 5,
  "security_group_ids": [
    "e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce"
  ],
  "taints": {
    "my-taint": "bar:NoSchedule"
  }
}
'

import requests

url = "https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools"

payload = {
    "flavor_id": "g1-standard-1-2",
    "min_node_count": 3,
    "name": "my-pool",
    "auto_healing_enabled": True,
    "boot_volume_size": 50,
    "boot_volume_type": "ssd_hiiops",
    "crio_config": { "default-ulimits": "nofile=1024:2048" },
    "is_public_ipv4": True,
    "kubelet_config": { "podMaxPids": "4096" },
    "labels": { "my-label": "foo" },
    "max_node_count": 5,
    "security_group_ids": ["e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce"],
    "taints": { "my-taint": "bar:NoSchedule" }
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    flavor_id: 'g1-standard-1-2',
    min_node_count: 3,
    name: 'my-pool',
    auto_healing_enabled: true,
    boot_volume_size: 50,
    boot_volume_type: 'ssd_hiiops',
    crio_config: {'default-ulimits': 'nofile=1024:2048'},
    is_public_ipv4: true,
    kubelet_config: {podMaxPids: '4096'},
    labels: {'my-label': 'foo'},
    max_node_count: 5,
    security_group_ids: ['e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce'],
    taints: {'my-taint': 'bar:NoSchedule'}
  })
};

fetch('https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'flavor_id' => 'g1-standard-1-2',
    'min_node_count' => 3,
    'name' => 'my-pool',
    'auto_healing_enabled' => true,
    'boot_volume_size' => 50,
    'boot_volume_type' => 'ssd_hiiops',
    'crio_config' => [
        'default-ulimits' => 'nofile=1024:2048'
    ],
    'is_public_ipv4' => true,
    'kubelet_config' => [
        'podMaxPids' => '4096'
    ],
    'labels' => [
        'my-label' => 'foo'
    ],
    'max_node_count' => 5,
    'security_group_ids' => [
        'e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce'
    ],
    'taints' => [
        'my-taint' => 'bar:NoSchedule'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools"

	payload := strings.NewReader("{\n  \"flavor_id\": \"g1-standard-1-2\",\n  \"min_node_count\": 3,\n  \"name\": \"my-pool\",\n  \"auto_healing_enabled\": true,\n  \"boot_volume_size\": 50,\n  \"boot_volume_type\": \"ssd_hiiops\",\n  \"crio_config\": {\n    \"default-ulimits\": \"nofile=1024:2048\"\n  },\n  \"is_public_ipv4\": true,\n  \"kubelet_config\": {\n    \"podMaxPids\": \"4096\"\n  },\n  \"labels\": {\n    \"my-label\": \"foo\"\n  },\n  \"max_node_count\": 5,\n  \"security_group_ids\": [\n    \"e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce\"\n  ],\n  \"taints\": {\n    \"my-taint\": \"bar:NoSchedule\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"flavor_id\": \"g1-standard-1-2\",\n  \"min_node_count\": 3,\n  \"name\": \"my-pool\",\n  \"auto_healing_enabled\": true,\n  \"boot_volume_size\": 50,\n  \"boot_volume_type\": \"ssd_hiiops\",\n  \"crio_config\": {\n    \"default-ulimits\": \"nofile=1024:2048\"\n  },\n  \"is_public_ipv4\": true,\n  \"kubelet_config\": {\n    \"podMaxPids\": \"4096\"\n  },\n  \"labels\": {\n    \"my-label\": \"foo\"\n  },\n  \"max_node_count\": 5,\n  \"security_group_ids\": [\n    \"e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce\"\n  ],\n  \"taints\": {\n    \"my-taint\": \"bar:NoSchedule\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/{cluster_name}/pools")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"flavor_id\": \"g1-standard-1-2\",\n  \"min_node_count\": 3,\n  \"name\": \"my-pool\",\n  \"auto_healing_enabled\": true,\n  \"boot_volume_size\": 50,\n  \"boot_volume_type\": \"ssd_hiiops\",\n  \"crio_config\": {\n    \"default-ulimits\": \"nofile=1024:2048\"\n  },\n  \"is_public_ipv4\": true,\n  \"kubelet_config\": {\n    \"podMaxPids\": \"4096\"\n  },\n  \"labels\": {\n    \"my-label\": \"foo\"\n  },\n  \"max_node_count\": 5,\n  \"security_group_ids\": [\n    \"e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce\"\n  ],\n  \"taints\": {\n    \"my-taint\": \"bar:NoSchedule\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "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 ID

Example:

1

region_id

integer

required

Region ID

Example:

7

cluster_name

string

required

Cluster name

Example:

"my-cluster"

Body

application/json

flavor_id

string

required

Flavor ID

Example:

"g1-standard-1-2"

min_node_count

integer

required

Minimum node count

Required range: 1 <= x <= 200

Example:

3

name

string

required

Pool's name

Required string length: 1 - 20

Pattern: ^[a-z][a-z0-9\-]{0,18}[a-z0-9]$

Example:

"my-pool"

auto_healing_enabled

boolean | null

default:false

Enable auto healing

Example:

true

boot_volume_size

integer | null

Boot volume size

Required range: 10 <= x <= 2000

Example:

50

boot_volume_type

enum<string> | null

Boot volume type

Available options:

cold,

ssd_hiiops,

ssd_local,

ssd_lowlatency,

standard,

ultra

Example:

"ssd_hiiops"

crio_config

Crio Config · object | null

Cri-o configuration for pool nodes

Show child attributes

Example:

{ "default-ulimits": "nofile=1024:2048" }

is_public_ipv4

boolean | null

default:false

Enable public v4 address

Example:

true

kubelet_config

Kubelet Config · object | null

Kubelet configuration for pool nodes

Show child attributes

Example:

{ "podMaxPids": "4096" }

labels

Labels · object | null

Labels applied to the cluster pool

Show child attributes

Example:

{ "my-label": "foo" }

max_node_count

integer | null

Maximum node count

Required range: 1 <= x <= 200

Example:

5

security_group_ids

string<uuid4>[]

Security group IDs applied to the cluster pool nodes

Example:

["e6ea8f35-82ce-4fb2-b51c-6a24a3a23bce"]

servergroup_policy

enum<string> | null

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

Available options:

affinity,

anti-affinity,

soft-anti-affinity

taints

Taints · object | null

Taints applied to the cluster pool

Show child attributes

Example:

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

Response

200 - application/json

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.

Example:

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

List k8s cluster pools Get k8s cluster pool

⌘I