Check cluster pool quota

Calculate quota requirements for a new cluster pool before creation. Returns exceeded quotas if regional limits would be violated. Use before pool creation to validate resource availability. Checks: CPU, RAM, volumes, VMs, GPUs, and baremetal quotas depending on flavor type.

POST /cloud/v2/k8s/clusters/{project_id}/{region_id}/pools/check_limits

Python

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
)
k8s_cluster_pool_quota = client.cloud.k8s.clusters.pools.check_quota(
    project_id=1,
    region_id=7,
    flavor_id="g1-standard-1-2",
)
print(k8s_cluster_pool_quota.baremetal_gpu_a100_count_limit)

200

{
  "baremetal_gpu_a100_count_limit": 123,
  "baremetal_gpu_a100_count_requested": 123,
  "baremetal_gpu_a100_count_usage": 123,
  "baremetal_gpu_h100_count_limit": 123,
  "baremetal_gpu_h100_count_requested": 123,
  "baremetal_gpu_h100_count_usage": 123,
  "baremetal_gpu_h200_count_limit": 123,
  "baremetal_gpu_h200_count_requested": 123,
  "baremetal_gpu_h200_count_usage": 123,
  "baremetal_gpu_l40s_count_limit": 123,
  "baremetal_gpu_l40s_count_requested": 123,
  "baremetal_gpu_l40s_count_usage": 123,
  "baremetal_hf_count_limit": 123,
  "baremetal_hf_count_requested": 123,
  "baremetal_hf_count_usage": 123,
  "cluster_count_limit": 123,
  "cluster_count_requested": 123,
  "cluster_count_usage": 123,
  "cpu_count_limit": 123,
  "cpu_count_requested": 123,
  "cpu_count_usage": 123,
  "firewall_count_limit": 123,
  "firewall_count_requested": 123,
  "firewall_count_usage": 123,
  "floating_count_limit": 123,
  "floating_count_requested": 123,
  "floating_count_usage": 123,
  "gpu_count_limit": 123,
  "gpu_count_requested": 123,
  "gpu_count_usage": 123,
  "gpu_virtual_a100_count_limit": 123,
  "gpu_virtual_a100_count_requested": 123,
  "gpu_virtual_a100_count_usage": 123,
  "gpu_virtual_h100_count_limit": 123,
  "gpu_virtual_h100_count_requested": 123,
  "gpu_virtual_h100_count_usage": 123,
  "gpu_virtual_h200_count_limit": 123,
  "gpu_virtual_h200_count_requested": 123,
  "gpu_virtual_h200_count_usage": 123,
  "gpu_virtual_l40s_count_limit": 123,
  "gpu_virtual_l40s_count_requested": 123,
  "gpu_virtual_l40s_count_usage": 123,
  "laas_topic_count_limit": 123,
  "laas_topic_count_requested": 123,
  "laas_topic_count_usage": 123,
  "loadbalancer_count_limit": 123,
  "loadbalancer_count_requested": 123,
  "loadbalancer_count_usage": 123,
  "ram_limit": 123,
  "ram_requested": 123,
  "ram_usage": 123,
  "servergroup_count_limit": 123,
  "servergroup_count_requested": 123,
  "servergroup_count_usage": 123,
  "vm_count_limit": 123,
  "vm_count_requested": 123,
  "vm_count_usage": 123,
  "volume_count_limit": 123,
  "volume_count_requested": 123,
  "volume_count_usage": 123,
  "volume_size_limit": 123,
  "volume_size_requested": 123,
  "volume_size_usage": 123
}

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

Body

application/json

flavor_id · string · required

Flavor ID

Example:

"g1-standard-1-2"

boot_volume_size · integer | null

Boot volume size

Required range: 10 <= x <= 2000

Example:

50

max_node_count · integer | null

Maximum node count

Required range: 1 <= x <= 200

Example:

5

min_node_count · integer | null · default: 1

Minimum node count

Required range: 1 <= x <= 200

Example:

3

name · string | null

Name of the cluster pool

Example:

"test"

node_count · integer | null · default: 1

Maximum node count

Required range: 1 <= x <= 200

Example:

5

servergroup_policy · enum<string> | null

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

Available options: affinity, anti-affinity, soft-anti-affinity

Example:

"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

Example:

5

baremetal_gpu_a100_count_requested · integer

Bare metal A100 GPU server count requested

Example:

10

baremetal_gpu_a100_count_usage · integer

Bare metal A100 GPU server count usage

Example:

3

baremetal_gpu_h100_count_limit · integer

Bare metal H100 GPU server count limit

Example:

5

baremetal_gpu_h100_count_requested · integer

Bare metal H100 GPU server count requested

Example:

10

baremetal_gpu_h100_count_usage · integer

Bare metal H100 GPU server count usage

Example:

3

baremetal_gpu_h200_count_limit · integer

Bare metal H200 GPU server count limit

Example:

5

baremetal_gpu_h200_count_requested · integer

Bare metal H200 GPU server count requested

Example:

10

baremetal_gpu_h200_count_usage · integer

Bare metal H200 GPU server count usage

Example:

3

baremetal_gpu_l40s_count_limit · integer

Bare metal L40S GPU server count limit

Example:

5

baremetal_gpu_l40s_count_requested · integer

Bare metal L40S GPU server count requested

Example:

10

baremetal_gpu_l40s_count_usage · integer

Bare metal L40S GPU server count usage

Example:

3

baremetal_hf_count_limit · integer

High-frequency bare metal servers count limit

Example:

5

baremetal_hf_count_requested · integer

High-frequency bare metal servers count requested

Example:

10

baremetal_hf_count_usage · integer

High-frequency bare metal servers count usage

Example:

3

cluster_count_limit · integer

K8s clusters count limit

Example:

5

cluster_count_requested · integer

K8s clusters count requested

Example:

6

cluster_count_usage · integer

K8s clusters count usage

Example:

4

cpu_count_limit · integer

vCPU Count limit

Example:

10

cpu_count_requested · integer

vCPU Count requested

Example:

20

cpu_count_usage · integer

vCPU Count usage

Example:

5

firewall_count_limit · integer

Firewalls Count limit

Example:

5

firewall_count_requested · integer

Firewalls Count requested

Example:

6

firewall_count_usage · integer

Firewalls Count usage

Example:

4

floating_count_limit · integer

Floating IP Count limit

Example:

5

floating_count_requested · integer

Floating IP Count requested

Example:

6

floating_count_usage · integer

Floating IP Count usage

Example:

4

gpu_count_limit · integer

GPU Count limit

Example:

4

gpu_count_requested · integer

GPU Count requested

Example:

8

gpu_count_usage · integer

GPU Count usage

Example:

2

gpu_virtual_a100_count_limit · integer

Virtual A100 GPU card count limit

Example:

4

gpu_virtual_a100_count_requested · integer

Virtual A100 GPU card count requested

Example:

8

gpu_virtual_a100_count_usage · integer

Virtual A100 GPU card count usage

Example:

2

gpu_virtual_h100_count_limit · integer

Virtual H100 GPU card count limit

Example:

4

gpu_virtual_h100_count_requested · integer

Virtual H100 GPU card count requested

Example:

8

gpu_virtual_h100_count_usage · integer

Virtual H100 GPU card count usage

Example:

2

gpu_virtual_h200_count_limit · integer

Virtual H200 GPU card count limit

Example:

4

gpu_virtual_h200_count_requested · integer

Virtual H200 GPU card count requested

Example:

8

gpu_virtual_h200_count_usage · integer

Virtual H200 GPU card count usage

Example:

2

gpu_virtual_l40s_count_limit · integer

Virtual L40S GPU card count limit

Example:

4

gpu_virtual_l40s_count_requested · integer

Virtual L40S GPU card count requested

Example:

8

gpu_virtual_l40s_count_usage · integer

Virtual L40S GPU card count usage

Example:

2

laas_topic_count_limit · integer

LaaS Topics Count limit

Example:

5

laas_topic_count_requested · integer

LaaS Topics Count requested

Example:

6

laas_topic_count_usage · integer

LaaS Topics Count usage

Example:

4

loadbalancer_count_limit · integer

Load Balancers Count limit

Example:

5

loadbalancer_count_requested · integer

Load Balancers Count requested

Example:

6

loadbalancer_count_usage · integer

Load Balancers Count usage

Example:

4

ram_limit · integer

RAM Size, MiB limit

Example:

20480

ram_requested · integer

RAM Size, MiB requested

Example:

40960

ram_usage · integer

RAM Size, MiB usage

Example:

10240

servergroup_count_limit · integer

Placement Group Count limit

Example:

5

servergroup_count_requested · integer

Placement Group Count requested

Example:

10

servergroup_count_usage · integer

Placement Group Count usage

Example:

3

vm_count_limit · integer

VMs Count limit

Example:

5

vm_count_requested · integer

VMs Count requested

Example:

10

vm_count_usage · integer

VMs Count usage

Example:

3

volume_count_limit · integer

Volumes Count limit

Example:

5

volume_count_requested · integer

Volumes Count requested

Example:

10

volume_count_usage · integer

Volumes Count usage

Example:

3

volume_size_limit · integer

Volumes Size, GiB limit

Example:

400

volume_size_requested · integer

Volumes Size, GiB requested

Example:

800

volume_size_usage · integer

Volumes Size, GiB usage

Example:

200