Create k8s cluster pool

Python

import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
task_id_list = client.cloud.k8s.clusters.pools.create(
    cluster_name="my-cluster",
    project_id=1,
    region_id=7,
    flavor_id="g1-standard-1-2",
    min_node_count=3,
    name="my-pool",
)
print(task_id_list.tasks)

package main

import (
	"context"
	"fmt"

	"github.com/G-Core/gcore-go"
	"github.com/G-Core/gcore-go/cloud"
	"github.com/G-Core/gcore-go/option"
)

func main() {
	client := gcore.NewClient(
		option.WithAPIKey("My API Key"),
	)
	taskIDList, err := client.Cloud.K8S.Clusters.Pools.New(
		context.TODO(),
		"my-cluster",
		cloud.K8SClusterPoolNewParams{
			ProjectID:    gcore.Int(1),
			RegionID:     gcore.Int(7),
			FlavorID:     "g1-standard-1-2",
			MinNodeCount: 3,
			Name:         "my-pool",
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", taskIDList.Tasks)
}

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"
  }
}
'

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;
}

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

Python

import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
task_id_list = client.cloud.k8s.clusters.pools.create(
    cluster_name="my-cluster",
    project_id=1,
    region_id=7,
    flavor_id="g1-standard-1-2",
    min_node_count=3,
    name="my-pool",
)
print(task_id_list.tasks)

package main

import (
	"context"
	"fmt"

	"github.com/G-Core/gcore-go"
	"github.com/G-Core/gcore-go/cloud"
	"github.com/G-Core/gcore-go/option"
)

func main() {
	client := gcore.NewClient(
		option.WithAPIKey("My API Key"),
	)
	taskIDList, err := client.Cloud.K8S.Clusters.Pools.New(
		context.TODO(),
		"my-cluster",
		cloud.K8SClusterPoolNewParams{
			ProjectID:    gcore.Int(1),
			RegionID:     gcore.Int(7),
			FlavorID:     "g1-standard-1-2",
			MinNodeCount: 3,
			Name:         "my-pool",
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", taskIDList.Tasks)
}

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"
  }
}
'

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;
}

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