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": "g3-ai-32-192-1500-l40s-48-1",
  "servers_count": 3,
  "servers_settings": {
    "interfaces": [
      {
        "type": "<string>",
        "ip_family": "ipv4",
        "name": "eth0",
        "security_groups": [
          {
            "id": "b4849ffa-89f2-45a1-951f-0ae5b7809d98"
          }
        ]
      }
    ],
    "volumes": [
      {
        "size": 100,
        "source": "<string>"
      }
    ]
  }
}
'
{
  "baremetal_network_count_limit": 1,
  "baremetal_network_count_requested": 1,
  "baremetal_network_count_usage": 1,
  "external_ip_count_limit": 10,
  "external_ip_count_requested": 1,
  "external_ip_count_usage": 1,
  "floating_count_limit": 1,
  "floating_count_requested": 1,
  "floating_count_usage": 1,
  "gpu_virtual_a100_count_limit": 10,
  "gpu_virtual_a100_count_requested": 1,
  "gpu_virtual_a100_count_usage": 1,
  "gpu_virtual_h100_count_limit": 10,
  "gpu_virtual_h100_count_requested": 1,
  "gpu_virtual_h100_count_usage": 1,
  "gpu_virtual_h200_count_limit": 10,
  "gpu_virtual_h200_count_requested": 1,
  "gpu_virtual_h200_count_usage": 1,
  "gpu_virtual_l40s_count_limit": 10,
  "gpu_virtual_l40s_count_requested": 1,
  "gpu_virtual_l40s_count_usage": 1,
  "volume_count_limit": 10,
  "volume_count_requested": 1,
  "volume_count_usage": 1,
  "volume_size_limit": 10,
  "volume_size_requested": 1,
  "volume_size_usage": 1
}

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
string
required

Cluster flavor

Example:

"g3-ai-32-192-1500-l40s-48-1"

​
servers_count
integer
required

Number of servers in the cluster

Example:

3

​
servers_settings
VirtualGpuServerSettingsQuotaSerializer · object

Configuration settings for the servers in the cluster

Response

200 - application/json

OK

​
baremetal_network_count_limit
integer

Bare metal Network Count limit

Example:

1

​
baremetal_network_count_requested
integer

Bare metal Network Count requested

Example:

1

​
baremetal_network_count_usage
integer

Bare metal Network Count usage

Example:

1

​
external_ip_count_limit
integer

External IP Count limit

Example:

10

​
external_ip_count_requested
integer

External IP Count requested

Example:

1

​
external_ip_count_usage
integer

External IP Count usage

Example:

1

​
floating_count_limit
integer

Floating IP Count usage

Example:

1

​
floating_count_requested
integer

Floating IP Count requested

Example:

1

​
floating_count_usage
integer

External IP Count requested

Example:

1

​
gpu_virtual_a100_count_limit
integer

Virtual A100 GPU card count limit

Example:

10

​
gpu_virtual_a100_count_requested
integer

Virtual A100 GPU card count requested

Example:

1

​
gpu_virtual_a100_count_usage
integer

Virtual A100 GPU card count usage

Example:

1

​
gpu_virtual_h100_count_limit
integer

Virtual H100 GPU card count limit

Example:

10

​
gpu_virtual_h100_count_requested
integer

Virtual H100 GPU card count requested

Example:

1

​
gpu_virtual_h100_count_usage
integer

Virtual H100 GPU card count usage

Example:

1

​
gpu_virtual_h200_count_limit
integer

Virtual H200 GPU card count limit

Example:

10

​
gpu_virtual_h200_count_requested
integer

Virtual H200 GPU card count requested

Example:

1

​
gpu_virtual_h200_count_usage
integer

Virtual H200 GPU card count usage

Example:

1

​
gpu_virtual_l40s_count_limit
integer

Virtual L40S GPU card count limit

Example:

10

​
gpu_virtual_l40s_count_requested
integer

Virtual L40S GPU card count requested

Example:

1

​
gpu_virtual_l40s_count_usage
integer

Virtual L40S GPU card count usage

Example:

1

​
volume_count_limit
integer

Volumes Count limit

Example:

10

​
volume_count_requested
integer

Volumes Count requested

Example:

1

​
volume_count_usage
integer

Volumes Count usage

Example:

1

​
volume_size_limit
integer

Volumes Size, GiB limit

Example:

10

​
volume_size_requested
integer

Volumes Size, GiB requested

Example:

1

​
volume_size_usage
integer

Volumes Size, GiB usage

Example:

1