Skip to main content
POST
/
cloud
/
v2
/
k8s
/
clusters
/
{project_id}
/
{region_id}
/
pools
/
check_limits
Check cluster pool quota
curl --request POST \
  --url https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/pools/check_limits \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "boot_volume_size": 50,
  "flavor_id": "g1-standard-1-2",
  "max_node_count": 5,
  "min_node_count": 3,
  "name": "test",
  "node_count": 5,
  "servergroup_policy": "anti-affinity"
}'
{
  "baremetal_gpu_a100_count_limit": 5,
  "baremetal_gpu_a100_count_requested": 10,
  "baremetal_gpu_a100_count_usage": 3,
  "baremetal_gpu_h100_count_limit": 5,
  "baremetal_gpu_h100_count_requested": 10,
  "baremetal_gpu_h100_count_usage": 3,
  "baremetal_gpu_h200_count_limit": 5,
  "baremetal_gpu_h200_count_requested": 10,
  "baremetal_gpu_h200_count_usage": 3,
  "baremetal_gpu_l40s_count_limit": 5,
  "baremetal_gpu_l40s_count_requested": 10,
  "baremetal_gpu_l40s_count_usage": 3,
  "baremetal_hf_count_limit": 5,
  "baremetal_hf_count_requested": 10,
  "baremetal_hf_count_usage": 3,
  "cluster_count_limit": 5,
  "cluster_count_requested": 6,
  "cluster_count_usage": 4,
  "cpu_count_limit": 10,
  "cpu_count_requested": 20,
  "cpu_count_usage": 5,
  "firewall_count_limit": 5,
  "firewall_count_requested": 6,
  "firewall_count_usage": 4,
  "floating_count_limit": 5,
  "floating_count_requested": 6,
  "floating_count_usage": 4,
  "gpu_count_limit": 4,
  "gpu_count_requested": 8,
  "gpu_count_usage": 2,
  "gpu_virtual_a100_count_limit": 4,
  "gpu_virtual_a100_count_requested": 8,
  "gpu_virtual_a100_count_usage": 2,
  "gpu_virtual_h100_count_limit": 4,
  "gpu_virtual_h100_count_requested": 8,
  "gpu_virtual_h100_count_usage": 2,
  "gpu_virtual_h200_count_limit": 4,
  "gpu_virtual_h200_count_requested": 8,
  "gpu_virtual_h200_count_usage": 2,
  "gpu_virtual_l40s_count_limit": 4,
  "gpu_virtual_l40s_count_requested": 8,
  "gpu_virtual_l40s_count_usage": 2,
  "laas_topic_count_limit": 5,
  "laas_topic_count_requested": 6,
  "laas_topic_count_usage": 4,
  "loadbalancer_count_limit": 5,
  "loadbalancer_count_requested": 6,
  "loadbalancer_count_usage": 4,
  "ram_limit": 20480,
  "ram_requested": 40960,
  "ram_usage": 10240,
  "servergroup_count_limit": 5,
  "servergroup_count_requested": 10,
  "servergroup_count_usage": 3,
  "vm_count_limit": 5,
  "vm_count_requested": 10,
  "vm_count_usage": 3,
  "volume_count_limit": 5,
  "volume_count_requested": 10,
  "volume_count_usage": 3,
  "volume_size_limit": 400,
  "volume_size_requested": 800,
  "volume_size_usage": 200
}

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

Examples:

1

region_id
integer
required

Region ID

Examples:

7

Body

application/json
flavor_id
string
required

Flavor ID

Examples:

"g1-standard-1-2"

boot_volume_size
integer | null

Boot volume size

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

50

max_node_count
integer | null

Maximum node count

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

5

min_node_count
integer | null
default:1

Minimum node count

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

3

name
string | null

Name of the cluster pool

Examples:

"test"

node_count
integer | null
default:1

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
Examples:

"anti-affinity"

Response

200 - application/json

OK

Response schema for K8s cluster quota check.

Returns quota fields that are exceeded. Fields are only included when regional limits would be violated. Empty response means no quotas exceeded.

baremetal_gpu_a100_count_limit
integer

Bare metal A100 GPU server count limit

Examples:

5

baremetal_gpu_a100_count_requested
integer

Bare metal A100 GPU server count requested

Examples:

10

baremetal_gpu_a100_count_usage
integer

Bare metal A100 GPU server count usage

Examples:

3

baremetal_gpu_h100_count_limit
integer

Bare metal H100 GPU server count limit

Examples:

5

baremetal_gpu_h100_count_requested
integer

Bare metal H100 GPU server count requested

Examples:

10

baremetal_gpu_h100_count_usage
integer

Bare metal H100 GPU server count usage

Examples:

3

baremetal_gpu_h200_count_limit
integer

Bare metal H200 GPU server count limit

Examples:

5

baremetal_gpu_h200_count_requested
integer

Bare metal H200 GPU server count requested

Examples:

10

baremetal_gpu_h200_count_usage
integer

Bare metal H200 GPU server count usage

Examples:

3

baremetal_gpu_l40s_count_limit
integer

Bare metal L40S GPU server count limit

Examples:

5

baremetal_gpu_l40s_count_requested
integer

Bare metal L40S GPU server count requested

Examples:

10

baremetal_gpu_l40s_count_usage
integer

Bare metal L40S GPU server count usage

Examples:

3

baremetal_hf_count_limit
integer

High-frequency bare metal servers count limit

Examples:

5

baremetal_hf_count_requested
integer

High-frequency bare metal servers count requested

Examples:

10

baremetal_hf_count_usage
integer

High-frequency bare metal servers count usage

Examples:

3

cluster_count_limit
integer

K8s clusters count limit

Examples:

5

cluster_count_requested
integer

K8s clusters count requested

Examples:

6

cluster_count_usage
integer

K8s clusters count usage

Examples:

4

cpu_count_limit
integer

vCPU Count limit

Examples:

10

cpu_count_requested
integer

vCPU Count requested

Examples:

20

cpu_count_usage
integer

vCPU Count usage

Examples:

5

firewall_count_limit
integer

Firewalls Count limit

Examples:

5

firewall_count_requested
integer

Firewalls Count requested

Examples:

6

firewall_count_usage
integer

Firewalls Count usage

Examples:

4

floating_count_limit
integer

Floating IP Count limit

Examples:

5

floating_count_requested
integer

Floating IP Count requested

Examples:

6

floating_count_usage
integer

Floating IP Count usage

Examples:

4

gpu_count_limit
integer

GPU Count limit

Examples:

4

gpu_count_requested
integer

GPU Count requested

Examples:

8

gpu_count_usage
integer

GPU Count usage

Examples:

2

gpu_virtual_a100_count_limit
integer

Virtual A100 GPU card count limit

Examples:

4

gpu_virtual_a100_count_requested
integer

Virtual A100 GPU card count requested

Examples:

8

gpu_virtual_a100_count_usage
integer

Virtual A100 GPU card count usage

Examples:

2

gpu_virtual_h100_count_limit
integer

Virtual H100 GPU card count limit

Examples:

4

gpu_virtual_h100_count_requested
integer

Virtual H100 GPU card count requested

Examples:

8

gpu_virtual_h100_count_usage
integer

Virtual H100 GPU card count usage

Examples:

2

gpu_virtual_h200_count_limit
integer

Virtual H200 GPU card count limit

Examples:

4

gpu_virtual_h200_count_requested
integer

Virtual H200 GPU card count requested

Examples:

8

gpu_virtual_h200_count_usage
integer

Virtual H200 GPU card count usage

Examples:

2

gpu_virtual_l40s_count_limit
integer

Virtual L40S GPU card count limit

Examples:

4

gpu_virtual_l40s_count_requested
integer

Virtual L40S GPU card count requested

Examples:

8

gpu_virtual_l40s_count_usage
integer

Virtual L40S GPU card count usage

Examples:

2

laas_topic_count_limit
integer

LaaS Topics Count limit

Examples:

5

laas_topic_count_requested
integer

LaaS Topics Count requested

Examples:

6

laas_topic_count_usage
integer

LaaS Topics Count usage

Examples:

4

loadbalancer_count_limit
integer

Load Balancers Count limit

Examples:

5

loadbalancer_count_requested
integer

Load Balancers Count requested

Examples:

6

loadbalancer_count_usage
integer

Load Balancers Count usage

Examples:

4

ram_limit
integer

RAM Size, MiB limit

Examples:

20480

ram_requested
integer

RAM Size, MiB requested

Examples:

40960

ram_usage
integer

RAM Size, MiB usage

Examples:

10240

servergroup_count_limit
integer

Placement Group Count limit

Examples:

5

servergroup_count_requested
integer

Placement Group Count requested

Examples:

10

servergroup_count_usage
integer

Placement Group Count usage

Examples:

3

vm_count_limit
integer

VMs Count limit

Examples:

5

vm_count_requested
integer

VMs Count requested

Examples:

10

vm_count_usage
integer

VMs Count usage

Examples:

3

volume_count_limit
integer

Volumes Count limit

Examples:

5

volume_count_requested
integer

Volumes Count requested

Examples:

10

volume_count_usage
integer

Volumes Count usage

Examples:

3

volume_size_limit
integer

Volumes Size, GiB limit

Examples:

400

volume_size_requested
integer

Volumes Size, GiB requested

Examples:

800

volume_size_usage
integer

Volumes Size, GiB usage

Examples:

200