POST
/
cloud
/
v2
/
instances
/
{project_id}
/
{region_id}
/
check_limits
Check instance quota
curl --request POST \
  --url https://api.gcore.com/cloud/v2/instances/{project_id}/{region_id}/check_limits \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "flavor": "g1-standard-1-2",
  "interfaces": [
    {
      "floating_ip": {
        "source": "new"
      },
      "network_id": "ddc28e44-2acb-499b-985b-831f29432e1c",
      "subnet_id": "2731a56e-a5c9-44be-80c2-02c57c594573",
      "type": "subnet"
    },
    {
      "floating_ip": {
        "existing_floating_id": "57be69f6-6f6a-4f03-a4ad-8eb86c69ec0a",
        "source": "existing"
      },
      "network_id": "53609647-2619-420a-b046-59905c8e3370",
      "subnet_id": "e3c6ee77-48cb-416b-b204-11b492cc776e3",
      "type": "subnet"
    },
    {
      "network_id": "783b36b4-3ef4-48ac-879d-5b3ea53180d8",
      "subnet_id": "382a83e5-1b38-49f9-bd83-730353b29ed4",
      "type": "subnet"
    },
    {
      "network_id": "783b36b4-3ef4-48ac-879d-5b3ea53180d8",
      "type": "any_subnet"
    },
    {
      "type": "external"
    }
  ],
  "names": [
    "cirroz1",
    "cirroz2"
  ],
  "volumes": [
    {
      "size": 10,
      "source": "image",
      "type_name": "ssd_hiiops"
    },
    {
      "size": 5,
      "source": "new-volume",
      "type_name": "standard"
    },
    {
      "snapshot_id": "7cca40d7-a843-4e9f-ae08-62b9a394b1ab",
      "source": "snapshot"
    }
  ]
}'
{
  "baremetal_basic_count_requested": 1,
  "baremetal_gpu_a100_count_requested": 1,
  "baremetal_gpu_count_requested": 1,
  "baremetal_gpu_h100_count_requested": 1,
  "baremetal_gpu_l40s_count_requested": 1,
  "baremetal_hf_count_requested": 1,
  "baremetal_infrastructure_count_requested": 1,
  "baremetal_network_count_requested": 1,
  "baremetal_storage_count_requested": 1,
  "caas_container_count_requested": 1,
  "caas_cpu_count_requested": 1,
  "caas_gpu_count_requested": 1,
  "caas_ram_size_requested": 1,
  "cluster_count_requested": 1,
  "cpu_count_requested": 1,
  "dbaas_postgres_cluster_count_requested": 1,
  "external_ip_count_requested": 1,
  "faas_cpu_count_requested": 1,
  "faas_function_count_requested": 1,
  "faas_namespace_count_requested": 1,
  "faas_ram_size_requested": 1,
  "firewall_count_requested": 1,
  "floating_count_requested": 1,
  "gpu_count_requested": 1,
  "gpu_virtual_a100_count_requested": 1,
  "gpu_virtual_h100_count_requested": 1,
  "gpu_virtual_l40s_count_requested": 1,
  "image_count_requested": 1,
  "image_size_requested": 1,
  "ipu_count_requested": 1,
  "laas_topic_count_requested": 1,
  "loadbalancer_count_requested": 1,
  "network_count_requested": 1,
  "ram_requested": 1,
  "registry_count_requested": 1,
  "registry_storage_requested": 1,
  "router_count_requested": 1,
  "secret_count_requested": 1,
  "servergroup_count_requested": 1,
  "sfs_count_requested": 1,
  "sfs_size_requested": 1,
  "shared_vm_count_requested": 1,
  "snapshot_schedule_count_requested": 1,
  "subnet_count_requested": 1,
  "vm_count_requested": 1,
  "volume_count_requested": 1,
  "volume_size_requested": 1,
  "volume_snapshots_count_requested": 1,
  "volume_snapshots_size_requested": 1,
  "baremetal_basic_count_limit": 0,
  "baremetal_basic_count_usage": 0,
  "baremetal_gpu_a100_count_limit": 0,
  "baremetal_gpu_a100_count_usage": 0,
  "baremetal_gpu_count_limit": 0,
  "baremetal_gpu_count_usage": 0,
  "baremetal_gpu_h100_count_limit": 0,
  "baremetal_gpu_h100_count_usage": 0,
  "baremetal_gpu_l40s_count_limit": 0,
  "baremetal_gpu_l40s_count_usage": 0,
  "baremetal_hf_count_limit": 0,
  "baremetal_hf_count_usage": 0,
  "baremetal_infrastructure_count_limit": 0,
  "baremetal_infrastructure_count_usage": 0,
  "baremetal_network_count_limit": 0,
  "baremetal_network_count_usage": 0,
  "baremetal_storage_count_limit": 0,
  "baremetal_storage_count_usage": 0,
  "caas_container_count_limit": 0,
  "caas_container_count_usage": 0,
  "caas_cpu_count_limit": 0,
  "caas_cpu_count_usage": 0,
  "caas_gpu_count_limit": 0,
  "caas_gpu_count_usage": 0,
  "caas_ram_size_limit": 0,
  "caas_ram_size_usage": 0,
  "cluster_count_limit": 0,
  "cluster_count_usage": 0,
  "cpu_count_limit": 0,
  "cpu_count_usage": 0,
  "dbaas_postgres_cluster_count_limit": 0,
  "dbaas_postgres_cluster_count_usage": 0,
  "external_ip_count_limit": 0,
  "external_ip_count_usage": 0,
  "faas_cpu_count_limit": 0,
  "faas_cpu_count_usage": 0,
  "faas_function_count_limit": 0,
  "faas_function_count_usage": 0,
  "faas_namespace_count_limit": 0,
  "faas_namespace_count_usage": 0,
  "faas_ram_size_limit": 0,
  "faas_ram_size_usage": 0,
  "firewall_count_limit": 0,
  "firewall_count_usage": 0,
  "floating_count_limit": 0,
  "floating_count_usage": 0,
  "gpu_count_limit": 0,
  "gpu_count_usage": 0,
  "gpu_virtual_a100_count_limit": 0,
  "gpu_virtual_a100_count_usage": 0,
  "gpu_virtual_h100_count_limit": 0,
  "gpu_virtual_h100_count_usage": 0,
  "gpu_virtual_l40s_count_limit": 0,
  "gpu_virtual_l40s_count_usage": 0,
  "image_count_limit": 0,
  "image_count_usage": 0,
  "image_size_limit": 0,
  "image_size_usage": 0,
  "ipu_count_limit": 0,
  "ipu_count_usage": 0,
  "laas_topic_count_limit": 0,
  "laas_topic_count_usage": 0,
  "loadbalancer_count_limit": 0,
  "loadbalancer_count_usage": 0,
  "network_count_limit": 0,
  "network_count_usage": 0,
  "ram_limit": 0,
  "ram_usage": 0,
  "registry_count_limit": 0,
  "registry_count_usage": 0,
  "registry_storage_limit": 0,
  "registry_storage_usage": 0,
  "router_count_limit": 0,
  "router_count_usage": 0,
  "secret_count_limit": 0,
  "secret_count_usage": 0,
  "servergroup_count_limit": 0,
  "servergroup_count_usage": 0,
  "sfs_count_limit": 0,
  "sfs_count_usage": 0,
  "sfs_size_limit": 0,
  "sfs_size_usage": 0,
  "shared_vm_count_limit": 0,
  "shared_vm_count_usage": 0,
  "snapshot_schedule_count_limit": 0,
  "snapshot_schedule_count_usage": 0,
  "subnet_count_limit": 0,
  "subnet_count_usage": 0,
  "vm_count_limit": 0,
  "vm_count_usage": 0,
  "volume_count_limit": 0,
  "volume_count_usage": 0,
  "volume_size_limit": 0,
  "volume_size_usage": 0,
  "volume_snapshots_count_limit": 0,
  "volume_snapshots_count_usage": 0,
  "volume_snapshots_size_limit": 0,
  "volume_snapshots_size_usage": 0
}

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
​
interfaces
object[]

Subnet IPs and floating IPs

​
name_templates
(string | null)[]

List of instance name templates. Either this or names must be specified.

​
names
string[]

List of instance names. Either this or name_templates must be specified.

​
volumes
object[]

Response

Dict of exceeding quotas

​
baremetal_basic_count_limit
integer

Basic bare metal servers count limit

​
baremetal_basic_count_requested
integer

Basic bare metal servers count requested

​
baremetal_basic_count_usage
integer

Basic bare metal servers count usage

​
baremetal_gpu_a100_count_limit
integer

Baremetal A100 GPU card count limit

​
baremetal_gpu_a100_count_requested
integer

Baremetal A100 GPU card count requested

​
baremetal_gpu_a100_count_usage
integer

Baremetal A100 GPU card count usage

​
baremetal_gpu_count_limit
integer

AI GPU bare metal servers count limit

​
baremetal_gpu_count_requested
integer

AI GPU bare metal servers count requested

​
baremetal_gpu_count_usage
integer

AI GPU bare metal servers count usage

​
baremetal_gpu_h100_count_limit
integer

Baremetal H100 GPU card count limit

​
baremetal_gpu_h100_count_requested
integer

Baremetal H100 GPU card count requested

​
baremetal_gpu_h100_count_usage
integer

Baremetal H100 GPU card count usage

​
baremetal_gpu_l40s_count_limit
integer

Baremetal L40S GPU card count limit

​
baremetal_gpu_l40s_count_requested
integer

Baremetal L40S GPU card count requested

​
baremetal_gpu_l40s_count_usage
integer

Baremetal L40S GPU card 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

​
baremetal_infrastructure_count_limit
integer

Infrastructure bare metal servers count limit

​
baremetal_infrastructure_count_requested
integer

Infrastructure bare metal servers count requested

​
baremetal_infrastructure_count_usage
integer

Infrastructure bare metal servers count usage

​
baremetal_network_count_limit
integer

Bare metal Network Count limit

​
baremetal_network_count_requested
integer

Bare metal Network Count requested

​
baremetal_network_count_usage
integer

Bare metal Network Count usage

​
baremetal_storage_count_limit
integer

Storage bare metal servers count limit

​
baremetal_storage_count_requested
integer

Storage bare metal servers count requested

​
baremetal_storage_count_usage
integer

Storage bare metal servers count usage

​
caas_container_count_limit
integer

Containers count limit

​
caas_container_count_requested
integer

Containers count requested

​
caas_container_count_usage
integer

Containers count usage

​
caas_cpu_count_limit
integer

mCPU count for containers limit

​
caas_cpu_count_requested
integer

mCPU count for containers requested

​
caas_cpu_count_usage
integer

mCPU count for containers usage

​
caas_gpu_count_limit
integer

Containers gpu count limit

​
caas_gpu_count_requested
integer

Containers gpu count requested

​
caas_gpu_count_usage
integer

Containers gpu count usage

​
caas_ram_size_limit
integer

MB memory count for containers limit

​
caas_ram_size_requested
integer

MB memory count for containers requested

​
caas_ram_size_usage
integer

MB memory count for containers 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

​
dbaas_postgres_cluster_count_limit
integer

DBaaS cluster count limit

​
dbaas_postgres_cluster_count_requested
integer

DBaaS cluster count requested

​
dbaas_postgres_cluster_count_usage
integer

DBaaS cluster count usage

​
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

​
faas_cpu_count_limit
integer

mCPU count for functions limit

​
faas_cpu_count_requested
integer

mCPU count for functions requested

​
faas_cpu_count_usage
integer

mCPU count for functions usage

​
faas_function_count_limit
integer

Functions count limit

​
faas_function_count_requested
integer

Functions count requested

​
faas_function_count_usage
integer

Functions count usage

​
faas_namespace_count_limit
integer

Functions namespace count limit

​
faas_namespace_count_requested
integer

Functions namespace count requested

​
faas_namespace_count_usage
integer

Functions namespace count usage

​
faas_ram_size_limit
integer

MB memory count for functions limit

​
faas_ram_size_requested
integer

MB memory count for functions requested

​
faas_ram_size_usage
integer

MB memory count for functions 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_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

​
image_count_limit
integer

Images Count limit

​
image_count_requested
integer

Images Count requested

​
image_count_usage
integer

Images Count usage

​
image_size_limit
integer

Images Size, GiB limit

​
image_size_requested
integer

Images Size, GiB requested

​
image_size_usage
integer

Images Size, GiB usage

​
ipu_count_limit
integer

IPU Count limit

​
ipu_count_requested
integer

IPU Count requested

​
ipu_count_usage
integer

IPU 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

​
network_count_limit
integer

Networks Count limit

​
network_count_requested
integer

Networks Count requested

​
network_count_usage
integer

Networks Count usage

​
ram_limit
integer

RAM Size, GiB limit

​
ram_requested
integer

RAM Size, GiB requested

​
ram_usage
integer

RAM Size, GiB usage

​
registry_count_limit
integer

Registries count limit

​
registry_count_requested
integer

Registries count requested

​
registry_count_usage
integer

Registries count usage

​
registry_storage_limit
integer

Registries volume usage, GiB limit

​
registry_storage_requested
integer

Registries volume usage, GiB requested

​
registry_storage_usage
integer

Registries volume usage, GiB usage

​
router_count_limit
integer

Routers Count limit

​
router_count_requested
integer

Routers Count requested

​
router_count_usage
integer

Routers Count usage

​
secret_count_limit
integer

Secret Count limit

​
secret_count_requested
integer

Secret Count requested

​
secret_count_usage
integer

Secret Count 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

​
sfs_count_limit
integer

Shared file system Count limit

​
sfs_count_requested
integer

Shared file system Count requested

​
sfs_count_usage
integer

Shared file system Count usage

​
sfs_size_limit
integer

Shared file system Size, GiB limit

​
sfs_size_requested
integer

Shared file system Size, GiB requested

​
sfs_size_usage
integer

Shared file system Size, GiB usage

​
shared_vm_count_limit
integer

Basic VMs Count limit

​
shared_vm_count_requested
integer

Basic VMs Count requested

​
shared_vm_count_usage
integer

Basic VMs Count usage

​
snapshot_schedule_count_limit
integer

Snapshot Schedules Count limit

​
snapshot_schedule_count_requested
integer

Snapshot Schedules Count requested

​
snapshot_schedule_count_usage
integer

Snapshot Schedules Count usage

​
subnet_count_limit
integer

Subnets Count limit

​
subnet_count_requested
integer

Subnets Count requested

​
subnet_count_usage
integer

Subnets Count usage

​
vm_count_limit
integer

Instances Dedicated Count limit

​
vm_count_requested
integer

Instances Dedicated Count requested

​
vm_count_usage
integer

Instances Dedicated 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

​
volume_snapshots_count_limit
integer

Snapshots Count limit

​
volume_snapshots_count_requested
integer

Snapshots Count requested

​
volume_snapshots_count_usage
integer

Snapshots Count usage

​
volume_snapshots_size_limit
integer

Snapshots Size, GiB limit

​
volume_snapshots_size_requested
integer

Snapshots Size, GiB requested

​
volume_snapshots_size_usage
integer

Snapshots Size, GiB usage