Skip to main content
POST
/
cloud
/
v2
/
k8s
/
clusters
/
{project_id}
/
{region_id}
/
check_limits
Check cluster quota
curl --request POST \
  --url https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id}/check_limits \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "logging": {
    "destination_region_id": 1,
    "enabled": true,
    "topic_name": "my-log-name"
  },
  "pools": [
    {
      "boot_volume_size": 10,
      "flavor_id": "g1-standard-1-2",
      "min_node_count": 1,
      "name": "test"
    }
  ]
}
'
{
  "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
logging
K8sClusterCheckLimitsLoggingV2Serializer · object

Logging configuration

Example:
{
"destination_region_id": 1,
"enabled": true,
"topic_name": "my-log-name"
}
pools
K8sClusterCheckLimitsPoolV2Serializer · object[] | null

K8s pools to create

Example:
[
{
"boot_volume_size": 10,
"flavor_id": "g1-standard-1-2",
"min_node_count": 1,
"name": "test"
}
]

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