Skip to main content
POST
/
cloud
/
v1
/
instances
/
{project_id}
/
{region_id}
/
available_flavors
List flavors matching volume requirements
curl --request POST \
  --url https://api.gcore.com/cloud/v1/instances/{project_id}/{region_id}/available_flavors \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "volumes": [
    {
      "attachment_tag": "root",
      "boot_index": 0,
      "image_id": "f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1",
      "name": "TestVM5 Ubuntu boot image",
      "size": 10,
      "source": "image",
      "type_name": "ssd_hiiops"
    }
  ]
}
'
{
  "count": 1,
  "results": [
    {
      "architecture": "x86_64",
      "disabled": false,
      "flavor_id": "g2-standard-32-64",
      "flavor_name": "g2-standard-32-64",
      "os_type": "linux",
      "ram": 2048,
      "vcpus": 1,
      "capacity": 1,
      "currency_code": "USD",
      "hardware_description": {},
      "price_per_hour": 1,
      "price_per_month": 720,
      "price_status": "show",
      "reserved_capacity": 5
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://gcore-doc-1046.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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

Query Parameters

​
include_prices
boolean

Set to true if flavor listing should include flavor prices

Body

application/json

CreateInstanceVolumeList schema

​
volumes
object[]
required

Volumes details. Non-important info such as names may be omitted.

Response

200 - application/json

List of available flavors

​
count
integer
required

Number of objects

Required range: x >= 0
Example:

1

​
results
Instances flavor schema · object[]
required

Objects