POST
/
cloud
/
v1
/
bminstances
/
{project_id}
/
{region_id}
/
check_limits
Check bare metal quota
curl --request POST \
  --url https://api.gcore.com/cloud/v1/bminstances/{project_id}/{region_id}/check_limits \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "flavor": "bm1-basic-medium",
  "interfaces": [
    {
      "network_id": "024a29e9-b4b7-4c91-9a46-505be123d9f8",
      "subnet_id": "91200a6c-07e0-42aa-98da-32d1f6545ae7",
      "type": "subnet"
    }
  ],
  "name_templates": [
    "my-instance-{ip_octets}"
  ],
  "names": [
    "my-instance-1"
  ]
}'
{
  "baremetal_basic_count_limit": 0,
  "baremetal_basic_count_requested": 1,
  "baremetal_basic_count_usage": 0,
  "baremetal_gpu_a100_count_limit": 0,
  "baremetal_gpu_a100_count_requested": 1,
  "baremetal_gpu_a100_count_usage": 0,
  "baremetal_gpu_h100_count_limit": 0,
  "baremetal_gpu_h100_count_requested": 1,
  "baremetal_gpu_h100_count_usage": 0,
  "baremetal_gpu_h200_count_limit": 0,
  "baremetal_gpu_h200_count_requested": 1,
  "baremetal_gpu_h200_count_usage": 0,
  "baremetal_gpu_l40s_count_limit": 0,
  "baremetal_gpu_l40s_count_requested": 1,
  "baremetal_gpu_l40s_count_usage": 0,
  "baremetal_hf_count_limit": 0,
  "baremetal_hf_count_requested": 1,
  "baremetal_hf_count_usage": 0,
  "baremetal_infrastructure_count_limit": 0,
  "baremetal_infrastructure_count_requested": 1,
  "baremetal_infrastructure_count_usage": 0,
  "baremetal_network_count_limit": 0,
  "baremetal_network_count_requested": 1,
  "baremetal_network_count_usage": 0,
  "baremetal_storage_count_limit": 0,
  "baremetal_storage_count_requested": 1,
  "baremetal_storage_count_usage": 0,
  "caas_container_count_limit": 0,
  "caas_container_count_requested": 1,
  "caas_container_count_usage": 0,
  "caas_cpu_count_limit": 0,
  "caas_cpu_count_requested": 1,
  "caas_cpu_count_usage": 0,
  "caas_gpu_count_limit": 0,
  "caas_gpu_count_requested": 1,
  "caas_gpu_count_usage": 0,
  "caas_ram_size_limit": 0,
  "caas_ram_size_requested": 1,
  "caas_ram_size_usage": 0,
  "cluster_count_limit": 0,
  "cluster_count_requested": 1,
  "cluster_count_usage": 0,
  "cpu_count_limit": 0,
  "cpu_count_requested": 1,
  "cpu_count_usage": 0,
  "dbaas_postgres_cluster_count_limit": 0,
  "dbaas_postgres_cluster_count_requested": 1,
  "dbaas_postgres_cluster_count_usage": 0,
  "external_ip_count_limit": 0,
  "external_ip_count_requested": 1,
  "external_ip_count_usage": 0,
  "faas_cpu_count_limit": 0,
  "faas_cpu_count_requested": 1,
  "faas_cpu_count_usage": 0,
  "faas_function_count_limit": 0,
  "faas_function_count_requested": 1,
  "faas_function_count_usage": 0,
  "faas_namespace_count_limit": 0,
  "faas_namespace_count_requested": 1,
  "faas_namespace_count_usage": 0,
  "faas_ram_size_limit": 0,
  "faas_ram_size_requested": 1,
  "faas_ram_size_usage": 0,
  "firewall_count_limit": 0,
  "firewall_count_requested": 1,
  "firewall_count_usage": 0,
  "floating_count_limit": 0,
  "floating_count_requested": 1,
  "floating_count_usage": 0,
  "gpu_count_limit": 0,
  "gpu_count_requested": 1,
  "gpu_count_usage": 0,
  "gpu_virtual_a100_count_limit": 0,
  "gpu_virtual_a100_count_requested": 1,
  "gpu_virtual_a100_count_usage": 0,
  "gpu_virtual_h100_count_limit": 0,
  "gpu_virtual_h100_count_requested": 1,
  "gpu_virtual_h100_count_usage": 0,
  "gpu_virtual_h200_count_limit": 0,
  "gpu_virtual_h200_count_requested": 1,
  "gpu_virtual_h200_count_usage": 0,
  "gpu_virtual_l40s_count_limit": 0,
  "gpu_virtual_l40s_count_requested": 1,
  "gpu_virtual_l40s_count_usage": 0,
  "image_count_limit": 0,
  "image_count_requested": 1,
  "image_count_usage": 0,
  "image_size_limit": 0,
  "image_size_requested": 1,
  "image_size_usage": 0,
  "ipu_count_limit": 0,
  "ipu_count_requested": 1,
  "ipu_count_usage": 0,
  "laas_topic_count_limit": 0,
  "laas_topic_count_requested": 1,
  "laas_topic_count_usage": 0,
  "loadbalancer_count_limit": 0,
  "loadbalancer_count_requested": 1,
  "loadbalancer_count_usage": 0,
  "network_count_limit": 0,
  "network_count_requested": 1,
  "network_count_usage": 0,
  "ram_limit": 0,
  "ram_requested": 1,
  "ram_usage": 0,
  "registry_count_limit": 0,
  "registry_count_requested": 1,
  "registry_count_usage": 0,
  "registry_storage_limit": 0,
  "registry_storage_requested": 1,
  "registry_storage_usage": 0,
  "router_count_limit": 0,
  "router_count_requested": 1,
  "router_count_usage": 0,
  "secret_count_limit": 0,
  "secret_count_requested": 1,
  "secret_count_usage": 0,
  "servergroup_count_limit": 0,
  "servergroup_count_requested": 1,
  "servergroup_count_usage": 0,
  "sfs_count_limit": 0,
  "sfs_count_requested": 1,
  "sfs_count_usage": 0,
  "sfs_size_limit": 0,
  "sfs_size_requested": 1,
  "sfs_size_usage": 0,
  "shared_vm_count_limit": 0,
  "shared_vm_count_requested": 1,
  "shared_vm_count_usage": 0,
  "snapshot_schedule_count_limit": 0,
  "snapshot_schedule_count_requested": 1,
  "snapshot_schedule_count_usage": 0,
  "subnet_count_limit": 0,
  "subnet_count_requested": 1,
  "subnet_count_usage": 0,
  "vm_count_limit": 0,
  "vm_count_requested": 1,
  "vm_count_usage": 0,
  "volume_count_limit": 0,
  "volume_count_requested": 1,
  "volume_count_usage": 0,
  "volume_size_limit": 0,
  "volume_size_requested": 1,
  "volume_size_usage": 0,
  "volume_snapshots_count_limit": 0,
  "volume_snapshots_count_requested": 1,
  "volume_snapshots_count_usage": 0,
  "volume_snapshots_size_limit": 0,
  "volume_snapshots_size_requested": 1,
  "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

Examples:

1

region_id
integer
required

Region ID

Examples:

1

Body

application/json
flavor
string | null

Bare metal flavor name.

Examples:

"bm1-basic-medium"

interfaces
Interfaces · array

Subnet IPs and floating IPs

Examples:
[
{
"network_id": "024a29e9-b4b7-4c91-9a46-505be123d9f8",
"subnet_id": "91200a6c-07e0-42aa-98da-32d1f6545ae7",
"type": "subnet"
}
]
name_templates
Name Templates · array

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

Examples:
["my-instance-{ip_octets}"]
names
string[]

A list of instance names. Either this or name_templates must be specified.

Examples:
["my-instance-1"]

Response

200 - application/json

OK

baremetal_basic_count_limit
integer

Basic bare metal servers count limit

Examples:

0

baremetal_basic_count_requested
integer

Basic bare metal servers count requested

Examples:

1

baremetal_basic_count_usage
integer

Basic bare metal servers count usage

Examples:

0

baremetal_gpu_a100_count_limit
integer

Baremetal A100 GPU card count limit

Examples:

0

baremetal_gpu_a100_count_requested
integer

Baremetal A100 GPU card count requested

Examples:

1

baremetal_gpu_a100_count_usage
integer

Baremetal A100 GPU card count usage

Examples:

0

baremetal_gpu_h100_count_limit
integer

Baremetal H100 GPU card count limit

Examples:

0

baremetal_gpu_h100_count_requested
integer

Baremetal H100 GPU card count requested

Examples:

1

baremetal_gpu_h100_count_usage
integer

Baremetal H100 GPU card count usage

Examples:

0

baremetal_gpu_h200_count_limit
integer

Baremetal H200 GPU card count limit

Examples:

0

baremetal_gpu_h200_count_requested
integer

Baremetal H200 GPU card count requested

Examples:

1

baremetal_gpu_h200_count_usage
integer

Baremetal H200 GPU card count usage

Examples:

0

baremetal_gpu_l40s_count_limit
integer

Baremetal L40S GPU card count limit

Examples:

0

baremetal_gpu_l40s_count_requested
integer

Baremetal L40S GPU card count requested

Examples:

1

baremetal_gpu_l40s_count_usage
integer

Baremetal L40S GPU card count usage

Examples:

0

baremetal_hf_count_limit
integer

High-frequency bare metal servers count limit

Examples:

0

baremetal_hf_count_requested
integer

High-frequency bare metal servers count requested

Examples:

1

baremetal_hf_count_usage
integer

High-frequency bare metal servers count usage

Examples:

0

baremetal_infrastructure_count_limit
integer

Infrastructure bare metal servers count limit

Examples:

0

baremetal_infrastructure_count_requested
integer

Infrastructure bare metal servers count requested

Examples:

1

baremetal_infrastructure_count_usage
integer

Infrastructure bare metal servers count usage

Examples:

0

baremetal_network_count_limit
integer

Bare metal Network Count limit

Examples:

0

baremetal_network_count_requested
integer

Bare metal Network Count requested

Examples:

1

baremetal_network_count_usage
integer

Bare metal Network Count usage

Examples:

0

baremetal_storage_count_limit
integer

Storage bare metal servers count limit

Examples:

0

baremetal_storage_count_requested
integer

Storage bare metal servers count requested

Examples:

1

baremetal_storage_count_usage
integer

Storage bare metal servers count usage

Examples:

0

caas_container_count_limit
integer

Containers count limit

Examples:

0

caas_container_count_requested
integer

Containers count requested

Examples:

1

caas_container_count_usage
integer

Containers count usage

Examples:

0

caas_cpu_count_limit
integer

mCPU count for containers limit

Examples:

0

caas_cpu_count_requested
integer

mCPU count for containers requested

Examples:

1

caas_cpu_count_usage
integer

mCPU count for containers usage

Examples:

0

caas_gpu_count_limit
integer

Containers gpu count limit

Examples:

0

caas_gpu_count_requested
integer

Containers gpu count requested

Examples:

1

caas_gpu_count_usage
integer

Containers gpu count usage

Examples:

0

caas_ram_size_limit
integer

MB memory count for containers limit

Examples:

0

caas_ram_size_requested
integer

MB memory count for containers requested

Examples:

1

caas_ram_size_usage
integer

MB memory count for containers usage

Examples:

0

cluster_count_limit
integer

K8s clusters count limit

Examples:

0

cluster_count_requested
integer

K8s clusters count requested

Examples:

1

cluster_count_usage
integer

K8s clusters count usage

Examples:

0

cpu_count_limit
integer

vCPU Count limit

Examples:

0

cpu_count_requested
integer

vCPU Count requested

Examples:

1

cpu_count_usage
integer

vCPU Count usage

Examples:

0

dbaas_postgres_cluster_count_limit
integer

DBaaS cluster count limit

Examples:

0

dbaas_postgres_cluster_count_requested
integer

DBaaS cluster count requested

Examples:

1

dbaas_postgres_cluster_count_usage
integer

DBaaS cluster count usage

Examples:

0

external_ip_count_limit
integer

External IP Count limit

Examples:

0

external_ip_count_requested
integer

External IP Count requested

Examples:

1

external_ip_count_usage
integer

External IP Count usage

Examples:

0

faas_cpu_count_limit
integer

mCPU count for functions limit

Examples:

0

faas_cpu_count_requested
integer

mCPU count for functions requested

Examples:

1

faas_cpu_count_usage
integer

mCPU count for functions usage

Examples:

0

faas_function_count_limit
integer

Functions count limit

Examples:

0

faas_function_count_requested
integer

Functions count requested

Examples:

1

faas_function_count_usage
integer

Functions count usage

Examples:

0

faas_namespace_count_limit
integer

Functions namespace count limit

Examples:

0

faas_namespace_count_requested
integer

Functions namespace count requested

Examples:

1

faas_namespace_count_usage
integer

Functions namespace count usage

Examples:

0

faas_ram_size_limit
integer

MB memory count for functions limit

Examples:

0

faas_ram_size_requested
integer

MB memory count for functions requested

Examples:

1

faas_ram_size_usage
integer

MB memory count for functions usage

Examples:

0

firewall_count_limit
integer

Firewalls Count limit

Examples:

0

firewall_count_requested
integer

Firewalls Count requested

Examples:

1

firewall_count_usage
integer

Firewalls Count usage

Examples:

0

floating_count_limit
integer

Floating IP Count limit

Examples:

0

floating_count_requested
integer

Floating IP Count requested

Examples:

1

floating_count_usage
integer

Floating IP Count usage

Examples:

0

gpu_count_limit
integer

GPU Count limit

Examples:

0

gpu_count_requested
integer

GPU Count requested

Examples:

1

gpu_count_usage
integer

GPU Count usage

Examples:

0

gpu_virtual_a100_count_limit
integer

Virtual A100 GPU card count limit

Examples:

0

gpu_virtual_a100_count_requested
integer

Virtual A100 GPU card count requested

Examples:

1

gpu_virtual_a100_count_usage
integer

Virtual A100 GPU card count usage

Examples:

0

gpu_virtual_h100_count_limit
integer

Virtual H100 GPU card count limit

Examples:

0

gpu_virtual_h100_count_requested
integer

Virtual H100 GPU card count requested

Examples:

1

gpu_virtual_h100_count_usage
integer

Virtual H100 GPU card count usage

Examples:

0

gpu_virtual_h200_count_limit
integer

Virtual H200 GPU card count limit

Examples:

0

gpu_virtual_h200_count_requested
integer

Virtual H200 GPU card count requested

Examples:

1

gpu_virtual_h200_count_usage
integer

Virtual H200 GPU card count usage

Examples:

0

gpu_virtual_l40s_count_limit
integer

Virtual L40S GPU card count limit

Examples:

0

gpu_virtual_l40s_count_requested
integer

Virtual L40S GPU card count requested

Examples:

1

gpu_virtual_l40s_count_usage
integer

Virtual L40S GPU card count usage

Examples:

0

image_count_limit
integer

Images Count limit

Examples:

0

image_count_requested
integer

Images Count requested

Examples:

1

image_count_usage
integer

Images Count usage

Examples:

0

image_size_limit
integer

Images Size, GiB limit

Examples:

0

image_size_requested
integer

Images Size, GiB requested

Examples:

1

image_size_usage
integer

Images Size, GiB usage

Examples:

0

ipu_count_limit
integer

IPU Count limit

Examples:

0

ipu_count_requested
integer

IPU Count requested

Examples:

1

ipu_count_usage
integer

IPU Count usage

Examples:

0

laas_topic_count_limit
integer

LaaS Topics Count limit

Examples:

0

laas_topic_count_requested
integer

LaaS Topics Count requested

Examples:

1

laas_topic_count_usage
integer

LaaS Topics Count usage

Examples:

0

loadbalancer_count_limit
integer

Load Balancers Count limit

Examples:

0

loadbalancer_count_requested
integer

Load Balancers Count requested

Examples:

1

loadbalancer_count_usage
integer

Load Balancers Count usage

Examples:

0

network_count_limit
integer

Networks Count limit

Examples:

0

network_count_requested
integer

Networks Count requested

Examples:

1

network_count_usage
integer

Networks Count usage

Examples:

0

ram_limit
integer

RAM Size, GiB limit

Examples:

0

ram_requested
integer

RAM Size, GiB requested

Examples:

1

ram_usage
integer

RAM Size, GiB usage

Examples:

0

registry_count_limit
integer

Registries count limit

Examples:

0

registry_count_requested
integer

Registries count requested

Examples:

1

registry_count_usage
integer

Registries count usage

Examples:

0

registry_storage_limit
integer

Registries volume usage, GiB limit

Examples:

0

registry_storage_requested
integer

Registries volume usage, GiB requested

Examples:

1

registry_storage_usage
integer

Registries volume usage, GiB usage

Examples:

0

router_count_limit
integer

Routers Count limit

Examples:

0

router_count_requested
integer

Routers Count requested

Examples:

1

router_count_usage
integer

Routers Count usage

Examples:

0

secret_count_limit
integer

Secret Count limit

Examples:

0

secret_count_requested
integer

Secret Count requested

Examples:

1

secret_count_usage
integer

Secret Count usage

Examples:

0

servergroup_count_limit
integer

Placement Group Count limit

Examples:

0

servergroup_count_requested
integer

Placement Group Count requested

Examples:

1

servergroup_count_usage
integer

Placement Group Count usage

Examples:

0

sfs_count_limit
integer

Shared file system Count limit

Examples:

0

sfs_count_requested
integer

Shared file system Count requested

Examples:

1

sfs_count_usage
integer

Shared file system Count usage

Examples:

0

sfs_size_limit
integer

Shared file system Size, GiB limit

Examples:

0

sfs_size_requested
integer

Shared file system Size, GiB requested

Examples:

1

sfs_size_usage
integer

Shared file system Size, GiB usage

Examples:

0

shared_vm_count_limit
integer

Basic VMs Count limit

Examples:

0

shared_vm_count_requested
integer

Basic VMs Count requested

Examples:

1

shared_vm_count_usage
integer

Basic VMs Count usage

Examples:

0

snapshot_schedule_count_limit
integer

Snapshot Schedules Count limit

Examples:

0

snapshot_schedule_count_requested
integer

Snapshot Schedules Count requested

Examples:

1

snapshot_schedule_count_usage
integer

Snapshot Schedules Count usage

Examples:

0

subnet_count_limit
integer

Subnets Count limit

Examples:

0

subnet_count_requested
integer

Subnets Count requested

Examples:

1

subnet_count_usage
integer

Subnets Count usage

Examples:

0

vm_count_limit
integer

Instances Dedicated Count limit

Examples:

0

vm_count_requested
integer

Instances Dedicated Count requested

Examples:

1

vm_count_usage
integer

Instances Dedicated Count usage

Examples:

0

volume_count_limit
integer

Volumes Count limit

Examples:

0

volume_count_requested
integer

Volumes Count requested

Examples:

1

volume_count_usage
integer

Volumes Count usage

Examples:

0

volume_size_limit
integer

Volumes Size, GiB limit

Examples:

0

volume_size_requested
integer

Volumes Size, GiB requested

Examples:

1

volume_size_usage
integer

Volumes Size, GiB usage

Examples:

0

volume_snapshots_count_limit
integer

Snapshots Count limit

Examples:

0

volume_snapshots_count_requested
integer

Snapshots Count requested

Examples:

1

volume_snapshots_count_usage
integer

Snapshots Count usage

Examples:

0

volume_snapshots_size_limit
integer

Snapshots Size, GiB limit

Examples:

0

volume_snapshots_size_requested
integer

Snapshots Size, GiB requested

Examples:

1

volume_snapshots_size_usage
integer

Snapshots Size, GiB usage

Examples:

0