Skip to main content
POST
/
cloud
/
v3
/
gpu
/
virtual
/
{project_id}
/
{region_id}
/
check_limits
Check virtual GPU cluster quota
curl --request POST \
  --url https://api.gcore.com/cloud/v3/gpu/virtual/{project_id}/{region_id}/check_limits \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "flavor": "<string>",
  "servers_count": 123,
  "servers_settings": {
    "interfaces": [
      {
        "type": "<string>",
        "ip_family": "ipv4",
        "name": "<string>"
      }
    ],
    "volumes": [
      {
        "size": 123,
        "source": "<string>",
        "type": "cold"
      }
    ]
  }
}
'
{
  "external_ip_count_limit": 123,
  "external_ip_count_requested": 123,
  "external_ip_count_usage": 123,
  "floating_count_limit": 123,
  "floating_count_requested": 123,
  "floating_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,
  "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
flavor
string
required

Cluster flavor

servers_count
integer
required

Number of servers in the cluster

servers_settings
VirtualGpuServerSettingsQuotaSerializer · object

Configuration settings for the servers in the cluster

Response

200 - application/json

OK

external_ip_count_limit
integer

External IP Count limit

external_ip_count_requested
integer

External IP Count requested

external_ip_count_usage
integer

External IP Count usage

floating_count_limit
integer

Floating IP Count usage

floating_count_requested
integer

Floating IP Count requested

floating_count_usage
integer

External IP Count requested

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

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