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

region_id
integer
required

Region ID

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

baremetal_gpu_a100_count_requested
integer

Bare metal A100 GPU server count requested

baremetal_gpu_a100_count_usage
integer

Bare metal A100 GPU server count usage

baremetal_gpu_h100_count_limit
integer

Bare metal H100 GPU server count limit

baremetal_gpu_h100_count_requested
integer

Bare metal H100 GPU server count requested

baremetal_gpu_h100_count_usage
integer

Bare metal H100 GPU server count usage

baremetal_gpu_h200_count_limit
integer

Bare metal H200 GPU server count limit

baremetal_gpu_h200_count_requested
integer

Bare metal H200 GPU server count requested

baremetal_gpu_h200_count_usage
integer

Bare metal H200 GPU server count usage

baremetal_gpu_l40s_count_limit
integer

Bare metal L40S GPU server count limit

baremetal_gpu_l40s_count_requested
integer

Bare metal L40S GPU server count requested

baremetal_gpu_l40s_count_usage
integer

Bare metal L40S GPU server count usage

baremetal_hf_count_limit
integer

High-frequency bare metal servers count limit

baremetal_hf_count_requested
integer

High-frequency bare metal servers count requested

baremetal_hf_count_usage
integer

High-frequency bare metal servers count usage

cluster_count_limit
integer

K8s clusters count limit

cluster_count_requested
integer

K8s clusters count requested

cluster_count_usage
integer

K8s clusters count usage

cpu_count_limit
integer

vCPU Count limit

cpu_count_requested
integer

vCPU Count requested

cpu_count_usage
integer

vCPU Count usage

firewall_count_limit
integer

Firewalls Count limit

firewall_count_requested
integer

Firewalls Count requested

firewall_count_usage
integer

Firewalls Count usage

floating_count_limit
integer

Floating IP Count limit

floating_count_requested
integer

Floating IP Count requested

floating_count_usage
integer

Floating IP Count usage

gpu_count_limit
integer

GPU Count limit

gpu_count_requested
integer

GPU Count requested

gpu_count_usage
integer

GPU Count usage

gpu_virtual_a100_count_limit
integer

Virtual A100 GPU card count limit

gpu_virtual_a100_count_requested
integer

Virtual A100 GPU card count requested

gpu_virtual_a100_count_usage
integer

Virtual A100 GPU card count usage

gpu_virtual_h100_count_limit
integer

Virtual H100 GPU card count limit

gpu_virtual_h100_count_requested
integer

Virtual H100 GPU card count requested

gpu_virtual_h100_count_usage
integer

Virtual H100 GPU card count usage

gpu_virtual_h200_count_limit
integer

Virtual H200 GPU card count limit

gpu_virtual_h200_count_requested
integer

Virtual H200 GPU card count requested

gpu_virtual_h200_count_usage
integer

Virtual H200 GPU card count usage

gpu_virtual_l40s_count_limit
integer

Virtual L40S GPU card count limit

gpu_virtual_l40s_count_requested
integer

Virtual L40S GPU card count requested

gpu_virtual_l40s_count_usage
integer

Virtual L40S GPU card count usage

laas_topic_count_limit
integer

LaaS Topics Count limit

laas_topic_count_requested
integer

LaaS Topics Count requested

laas_topic_count_usage
integer

LaaS Topics Count usage

loadbalancer_count_limit
integer

Load Balancers Count limit

loadbalancer_count_requested
integer

Load Balancers Count requested

loadbalancer_count_usage
integer

Load Balancers Count usage

ram_limit
integer

RAM Size, MiB limit

ram_requested
integer

RAM Size, MiB requested

ram_usage
integer

RAM Size, MiB usage

servergroup_count_limit
integer

Placement Group Count limit

servergroup_count_requested
integer

Placement Group Count requested

servergroup_count_usage
integer

Placement Group Count usage

vm_count_limit
integer

VMs Count limit

vm_count_requested
integer

VMs Count requested

vm_count_usage
integer

VMs Count usage

volume_count_limit
integer

Volumes Count limit

volume_count_requested
integer

Volumes Count requested

volume_count_usage
integer

Volumes Count usage

volume_size_limit
integer

Volumes Size, GiB limit

volume_size_requested
integer

Volumes Size, GiB requested

volume_size_usage
integer

Volumes Size, GiB usage