> ## Documentation Index > Fetch the complete documentation index at: https://gcore.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Check cluster quota > Calculate quota requirements for a new K8s cluster before creation. Returns exceeded quotas if regional limits would be violated. Validates requirements for all pools, logging, and cluster infrastructure (floating IPs, load balancers, security groups). Use before cluster creation to validate resource availability. ## OpenAPI ````yaml /api-reference/services_documented/cloud_api.yaml post /cloud/v2/k8s/clusters/{project_id}/{region_id}/check_limits openapi: 3.1.0 info: title: Gcore OpenAPI – Cloud API description: >- This OpenAPI is an aggregated OpenAPI specification that unifies all Gcore products into a single file. It covers Cloud, CDN, DNS, WAAP, DDoS Protection, Object Storage, Streaming, and FastEdge services. version: '2026-05-15T06:37:28.230198+00:00' servers: - url: https://api.gcore.com security: - APIKey: [] tags: - name: Bare Metal x-displayName: Bare Metal - name: Container as a Service x-displayName: Container as a Service - name: Cost Reports x-displayName: Cost Reports - name: DDoS Protection x-displayName: DDoS Protection - name: Everywhere Inference x-displayName: Everywhere Inference - name: Everywhere Inference Apps x-displayName: Everywhere Inference Apps - name: File Shares x-displayName: File Shares - name: Floating IPs x-displayName: Floating IPs - name: Function as a Service x-displayName: Function as a Service - name: GPU Bare Metal x-displayName: GPU Bare Metal - name: GPU Virtual x-displayName: GPU Virtual - name: IP Ranges x-displayName: IP Ranges - name: Images x-displayName: Images - name: Instances x-displayName: Instances - name: Load Balancers x-displayName: Load Balancers - name: Logging x-displayName: Logging - name: Managed Kubernetes x-displayName: Managed Kubernetes - name: Managed PostgreSQL x-displayName: Managed PostgreSQL - name: Networks x-displayName: Networks - name: Placement Groups x-displayName: Placement Groups - name: Projects x-displayName: Projects - name: Quotas x-displayName: Quotas - name: Regions x-displayName: Regions - name: Registry x-displayName: Registry - name: Reservations x-displayName: Reservations - name: Reserved IPs x-displayName: Reserved IPs - name: Routers x-displayName: Routers - name: SSH Keys x-displayName: SSH Keys - name: Secrets x-displayName: Secrets - name: Security Groups x-displayName: Security Groups - name: Snapshot Schedules x-displayName: Snapshot Schedules - name: Snapshots x-displayName: Snapshots - name: Tasks x-displayName: Tasks - name: User Actions x-displayName: User Actions - name: User Role Assignments x-displayName: User Role Assignments - name: Volumes x-displayName: Volumes paths: /cloud/v2/k8s/clusters/{project_id}/{region_id}/check_limits: post: tags: - Managed Kubernetes summary: Check cluster quota description: >- Calculate quota requirements for a new K8s cluster before creation. Returns exceeded quotas if regional limits would be violated. Validates requirements for all pools, logging, and cluster infrastructure (floating IPs, load balancers, security groups). Use before cluster creation to validate resource availability. operationId: K8sClusterCheckLimitsV2.post parameters: - in: path name: project_id required: true description: Project ID schema: description: Project ID example: 1 examples: - 1 title: Project Id type: integer - in: path name: region_id required: true description: Region ID schema: description: Region ID example: 7 examples: - 7 title: Region Id type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/K8sClusterCheckLimitsV2Serializer' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/K8sClusterQuotaResponseSerializer' components: schemas: K8sClusterCheckLimitsV2Serializer: properties: logging: anyOf: - $ref: '#/components/schemas/K8sClusterCheckLimitsLoggingV2Serializer' - type: 'null' default: null description: Logging configuration examples: - destination_region_id: 1 enabled: true topic_name: my-log-name - null pools: anyOf: - items: $ref: '#/components/schemas/K8sClusterCheckLimitsPoolV2Serializer' type: array - type: 'null' default: null description: K8s pools to create examples: - - boot_volume_size: 10 flavor_id: g1-standard-1-2 min_node_count: 1 name: test title: Pools title: K8sClusterCheckLimitsV2Serializer type: object K8sClusterQuotaResponseSerializer: description: >- 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. properties: baremetal_gpu_a100_count_limit: description: Bare metal A100 GPU server count limit example: 5 examples: - 5 title: Baremetal Gpu A100 Count Limit type: integer baremetal_gpu_a100_count_requested: description: Bare metal A100 GPU server count requested example: 10 examples: - 10 title: Baremetal Gpu A100 Count Requested type: integer baremetal_gpu_a100_count_usage: description: Bare metal A100 GPU server count usage example: 3 examples: - 3 title: Baremetal Gpu A100 Count Usage type: integer baremetal_gpu_h100_count_limit: description: Bare metal H100 GPU server count limit example: 5 examples: - 5 title: Baremetal Gpu H100 Count Limit type: integer baremetal_gpu_h100_count_requested: description: Bare metal H100 GPU server count requested example: 10 examples: - 10 title: Baremetal Gpu H100 Count Requested type: integer baremetal_gpu_h100_count_usage: description: Bare metal H100 GPU server count usage example: 3 examples: - 3 title: Baremetal Gpu H100 Count Usage type: integer baremetal_gpu_h200_count_limit: description: Bare metal H200 GPU server count limit example: 5 examples: - 5 title: Baremetal Gpu H200 Count Limit type: integer baremetal_gpu_h200_count_requested: description: Bare metal H200 GPU server count requested example: 10 examples: - 10 title: Baremetal Gpu H200 Count Requested type: integer baremetal_gpu_h200_count_usage: description: Bare metal H200 GPU server count usage example: 3 examples: - 3 title: Baremetal Gpu H200 Count Usage type: integer baremetal_gpu_l40s_count_limit: description: Bare metal L40S GPU server count limit example: 5 examples: - 5 title: Baremetal Gpu L40S Count Limit type: integer baremetal_gpu_l40s_count_requested: description: Bare metal L40S GPU server count requested example: 10 examples: - 10 title: Baremetal Gpu L40S Count Requested type: integer baremetal_gpu_l40s_count_usage: description: Bare metal L40S GPU server count usage example: 3 examples: - 3 title: Baremetal Gpu L40S Count Usage type: integer baremetal_hf_count_limit: description: High-frequency bare metal servers count limit example: 5 examples: - 5 title: Baremetal Hf Count Limit type: integer baremetal_hf_count_requested: description: High-frequency bare metal servers count requested example: 10 examples: - 10 title: Baremetal Hf Count Requested type: integer baremetal_hf_count_usage: description: High-frequency bare metal servers count usage example: 3 examples: - 3 title: Baremetal Hf Count Usage type: integer cluster_count_limit: description: K8s clusters count limit example: 5 examples: - 5 title: Cluster Count Limit type: integer cluster_count_requested: description: K8s clusters count requested example: 6 examples: - 6 title: Cluster Count Requested type: integer cluster_count_usage: description: K8s clusters count usage example: 4 examples: - 4 title: Cluster Count Usage type: integer cpu_count_limit: description: vCPU Count limit example: 10 examples: - 10 title: Cpu Count Limit type: integer cpu_count_requested: description: vCPU Count requested example: 20 examples: - 20 title: Cpu Count Requested type: integer cpu_count_usage: description: vCPU Count usage example: 5 examples: - 5 title: Cpu Count Usage type: integer firewall_count_limit: description: Firewalls Count limit example: 5 examples: - 5 title: Firewall Count Limit type: integer firewall_count_requested: description: Firewalls Count requested example: 6 examples: - 6 title: Firewall Count Requested type: integer firewall_count_usage: description: Firewalls Count usage example: 4 examples: - 4 title: Firewall Count Usage type: integer floating_count_limit: description: Floating IP Count limit example: 5 examples: - 5 title: Floating Count Limit type: integer floating_count_requested: description: Floating IP Count requested example: 6 examples: - 6 title: Floating Count Requested type: integer floating_count_usage: description: Floating IP Count usage example: 4 examples: - 4 title: Floating Count Usage type: integer gpu_count_limit: description: GPU Count limit example: 4 examples: - 4 title: Gpu Count Limit type: integer gpu_count_requested: description: GPU Count requested example: 8 examples: - 8 title: Gpu Count Requested type: integer gpu_count_usage: description: GPU Count usage example: 2 examples: - 2 title: Gpu Count Usage type: integer gpu_virtual_a100_count_limit: description: Virtual A100 GPU card count limit example: 4 examples: - 4 title: Gpu Virtual A100 Count Limit type: integer gpu_virtual_a100_count_requested: description: Virtual A100 GPU card count requested example: 8 examples: - 8 title: Gpu Virtual A100 Count Requested type: integer gpu_virtual_a100_count_usage: description: Virtual A100 GPU card count usage example: 2 examples: - 2 title: Gpu Virtual A100 Count Usage type: integer gpu_virtual_h100_count_limit: description: Virtual H100 GPU card count limit example: 4 examples: - 4 title: Gpu Virtual H100 Count Limit type: integer gpu_virtual_h100_count_requested: description: Virtual H100 GPU card count requested example: 8 examples: - 8 title: Gpu Virtual H100 Count Requested type: integer gpu_virtual_h100_count_usage: description: Virtual H100 GPU card count usage example: 2 examples: - 2 title: Gpu Virtual H100 Count Usage type: integer gpu_virtual_h200_count_limit: description: Virtual H200 GPU card count limit example: 4 examples: - 4 title: Gpu Virtual H200 Count Limit type: integer gpu_virtual_h200_count_requested: description: Virtual H200 GPU card count requested example: 8 examples: - 8 title: Gpu Virtual H200 Count Requested type: integer gpu_virtual_h200_count_usage: description: Virtual H200 GPU card count usage example: 2 examples: - 2 title: Gpu Virtual H200 Count Usage type: integer gpu_virtual_l40s_count_limit: description: Virtual L40S GPU card count limit example: 4 examples: - 4 title: Gpu Virtual L40S Count Limit type: integer gpu_virtual_l40s_count_requested: description: Virtual L40S GPU card count requested example: 8 examples: - 8 title: Gpu Virtual L40S Count Requested type: integer gpu_virtual_l40s_count_usage: description: Virtual L40S GPU card count usage example: 2 examples: - 2 title: Gpu Virtual L40S Count Usage type: integer laas_topic_count_limit: description: LaaS Topics Count limit example: 5 examples: - 5 title: Laas Topic Count Limit type: integer laas_topic_count_requested: description: LaaS Topics Count requested example: 6 examples: - 6 title: Laas Topic Count Requested type: integer laas_topic_count_usage: description: LaaS Topics Count usage example: 4 examples: - 4 title: Laas Topic Count Usage type: integer loadbalancer_count_limit: description: Load Balancers Count limit example: 5 examples: - 5 title: Loadbalancer Count Limit type: integer loadbalancer_count_requested: description: Load Balancers Count requested example: 6 examples: - 6 title: Loadbalancer Count Requested type: integer loadbalancer_count_usage: description: Load Balancers Count usage example: 4 examples: - 4 title: Loadbalancer Count Usage type: integer ram_limit: description: RAM Size, MiB limit example: 20480 examples: - 20480 title: Ram Limit type: integer ram_requested: description: RAM Size, MiB requested example: 40960 examples: - 40960 title: Ram Requested type: integer ram_usage: description: RAM Size, MiB usage example: 10240 examples: - 10240 title: Ram Usage type: integer servergroup_count_limit: description: Placement Group Count limit example: 5 examples: - 5 title: Servergroup Count Limit type: integer servergroup_count_requested: description: Placement Group Count requested example: 10 examples: - 10 title: Servergroup Count Requested type: integer servergroup_count_usage: description: Placement Group Count usage example: 3 examples: - 3 title: Servergroup Count Usage type: integer vm_count_limit: description: VMs Count limit example: 5 examples: - 5 title: Vm Count Limit type: integer vm_count_requested: description: VMs Count requested example: 10 examples: - 10 title: Vm Count Requested type: integer vm_count_usage: description: VMs Count usage example: 3 examples: - 3 title: Vm Count Usage type: integer volume_count_limit: description: Volumes Count limit example: 5 examples: - 5 title: Volume Count Limit type: integer volume_count_requested: description: Volumes Count requested example: 10 examples: - 10 title: Volume Count Requested type: integer volume_count_usage: description: Volumes Count usage example: 3 examples: - 3 title: Volume Count Usage type: integer volume_size_limit: description: Volumes Size, GiB limit example: 400 examples: - 400 title: Volume Size Limit type: integer volume_size_requested: description: Volumes Size, GiB requested example: 800 examples: - 800 title: Volume Size Requested type: integer volume_size_usage: description: Volumes Size, GiB usage example: 200 examples: - 200 title: Volume Size Usage type: integer title: K8sClusterQuotaResponseSerializer type: object K8sClusterCheckLimitsLoggingV2Serializer: properties: destination_region_id: anyOf: - type: integer - type: 'null' default: null description: Destination region id to which the logs will be written examples: - 1 title: Destination Region Id enabled: default: false description: Enable/disable forwarding logs to LaaS example: true examples: - true - false title: Enabled type: boolean retention_policy: anyOf: - $ref: '#/components/schemas/LaasIndexRetentionPolicyPydanticSerializer' - type: 'null' default: null description: The logs retention policy examples: - period: 45 topic_name: anyOf: - maxLength: 223 minLength: 1 pattern: >- ^[a-z0-9](?:[-a-z0-9]*[a-z0-9])?(?:\.[a-z0-9](?:[-a-z0-9]*[a-z0-9])*)*$ type: string - type: 'null' default: null description: The topic name to which the logs will be written examples: - my-log-name title: Topic Name title: K8sClusterCheckLimitsLoggingV2Serializer type: object K8sClusterCheckLimitsPoolV2Serializer: properties: boot_volume_size: anyOf: - maximum: 2000 minimum: 10 type: integer - type: 'null' default: null description: Boot volume size examples: - 50 title: Boot Volume Size flavor_id: description: Flavor ID example: g1-standard-1-2 examples: - g1-standard-1-2 title: Flavor Id type: string max_node_count: anyOf: - maximum: 200 minimum: 1 type: integer - type: 'null' default: null description: Maximum node count examples: - 5 title: Max Node Count min_node_count: anyOf: - maximum: 200 minimum: 1 type: integer - type: 'null' default: 1 description: Minimum node count examples: - 3 title: Min Node Count name: anyOf: - type: string - type: 'null' default: null description: Name of the cluster pool examples: - test title: Name node_count: anyOf: - maximum: 200 minimum: 1 type: integer - type: 'null' default: 1 description: Maximum node count examples: - 5 title: Node Count servergroup_policy: anyOf: - $ref: '#/components/schemas/ServerGroupPolicyEnum' - type: 'null' default: null description: 'Server group policy: anti-affinity, soft-anti-affinity or affinity' examples: - anti-affinity required: - flavor_id title: K8sClusterCheckLimitsPoolV2Serializer type: object LaasIndexRetentionPolicyPydanticSerializer: properties: period: anyOf: - exclusiveMinimum: 0 maximum: 1825 type: integer - type: 'null' description: Duration of days for which logs must be kept. examples: - 45 title: Period required: - period title: LaasIndexRetentionPolicyPydanticSerializer type: object ServerGroupPolicyEnum: enum: - affinity - anti-affinity - soft-anti-affinity title: ServerGroupPolicyEnum type: string securitySchemes: APIKey: description: >- API key for authentication. Make sure to include the word `apikey`, followed by a single space and then your token. Example: `apikey 1234$abcdef` type: apiKey in: header name: Authorization ````