Documentation | Reservations › List Of Bare Metal Flavors That Are Available For Reservation

Reservations

reservations

Methods

Create Reservation -> { id, active_from, active_to, 16 more... }

post/v1/reservations

Create reservation

Delete Reservation ->

delete/v1/reservations/{reservation_id}

Delete reservation

List Reservations -> OffsetPage<{ id, active_from, active_to, 16 more... }>

get/v1/reservations

List reservations

Parameters

activated_from: string

Optional

(format: date)

Lower bound, starting from what date the reservation was/will be activated

activated_to: string

Optional

(format: date)

High bound, before what date the reservation was/will be activated

created_from: string

Optional

(format: date-time)

Lower bound the filter, showing result(s) equal to or greater than date the reservation was created

created_to: string

Optional

(format: date-time)

High bound the filter, showing result(s) equal to or less date the reservation was created

deactivated_from: string

Optional

(format: date)

Lower bound, starting from what date the reservation was/will be deactivated

deactivated_to: string

Optional

(format: date)

High bound, before what date the reservation was/will be deactivated

limit: number

Optional

(minimum: 1)

Limit of reservation list page

metric_name: string

Optional

Name from billing features for specific resource

offset: number

Optional

(minimum: 0)

Offset in reservation list

region_id: number

Optional

Region for reservation

status: Array<

Optional

Field for fixed a status by reservation workflow

"ACTIVATED"

"APPROVED"

"COPIED"

"CREATED"

"EXPIRED"

"REJECTED"

"RESERVED"

"WAITING_FOR_PAYMENT"

Response fields

count: number

(minimum: 0)

Number of objects

results: Array<{ id, active_from, active_to, 16 more... }>

Objects

Request example

curl https://api.gcore.com/cloud/v1/reservations \
    -H "APIKey: $CLOUD_API_API_KEY"

200Example

{
  "count": 1,
  "results": [
    {
      "id": 10218,
      "active_from": "2024-12-02",
      "active_to": "2025-12-02",
      "activity_period": "month",
      "activity_period_length": 12,
      "amount_prices": {
        "commit_price_per_month": "1302.45570000",
        "commit_price_per_unit": "1.75061250",
        "commit_price_total": "15629.46840000",
        "currency_code": "EUR",
        "overcommit_price_per_month": "3060.60768000",
        "overcommit_price_per_unit": "4.11372000",
        "overcommit_price_total": "36727.29216000"
      },
      "billing_plan_id": 1114,
      "created_at": "2019-12-27T18:11:19.117Z",
      "error": null,
      "eta": "2025-11-01",
      "is_expiration_message_visible": true,
      "name": "Test_name_TestReservation_1733140407.738675",
      "next_statuses": [
        "APPROVED",
        "REJECTED"
      ],
      "region_id": 4,
      "region_name": "LUX-4",
      "remind_expiration_message": null,
      "resources": [
        {
          "activity_period": "month",
          "activity_period_length": 12,
          "billing_plan_item_id": 2584252,
          "commit_price_per_month": "434.15190000",
          "commit_price_per_unit": "0.58353750",
          "commit_price_total": "5209.82280000",
          "cpu": "2xIntel Xeon 8468",
          "disk": "8 x 3.84 TB NVMe",
          "overcommit_billing_plan_item_id": 2585397,
          "overcommit_price_per_month": "1020.20256000",
          "overcommit_price_per_unit": "1.37124000",
          "overcommit_price_total": "12242.43072000",
          "ram": "2TB RAM",
          "resource_count": 3,
          "resource_name": "bm0-infrastructure-small-fake_min",
          "resource_type": "flavor",
          "unit_name": "H",
          "unit_size_month": "744.00000000",
          "unit_size_total": "8928.00000000"
        }
      ],
      "status": "CREATED",
      "user_status": "user_status"
    }
  ]
}

List Of Bare Metal Flavors That Are Available For Reservation -> Array<{ activity_period, activity_period_length, architecture, 9 more... }>

get/v1/bm_reservation_flavors/{region_id}

List of bare metal flavors that are available for reservation

Parameters

region_id: number

client_id_: number

Optional

Client identifier. Must be used for users w/o client_id in jwt

disabled: boolean

Optional

Flag for filtering disabled flavors in the region. Defaults to true

ensure_cached: string

Optional

None

windows_os: boolean

Optional

Set to true to get only flavors with Windows OS, false to get only with Linux OS, None option to without the OS filter. Defaults to none.

Request example

curl https://api.gcore.com/cloud/v1/bm_reservation_flavors/$REGION_ID \
    -H "APIKey: $CLOUD_API_API_KEY"

200Example

[
  {
    "activity_period": "month",
    "activity_period_length": [
      12,
      36
    ],
    "architecture": "architecture",
    "available_count": 23,
    "flavor_id": "g1-gpu-1-2-1",
    "flavor_name": "g1-gpu-1-2-1",
    "hardware_description": {
      "cpu": "cpu",
      "disk": "disk",
      "ephemeral": "ephemeral",
      "gpu": "1x NVIDIA 11GB",
      "ipu": "ipu",
      "network": "network",
      "poplar_count": "poplar_count",
      "ram": "ram"
    },
    "os_type": "os_type",
    "ram": 2048,
    "resource_class": "resource_class",
    "vcpus": 1
  }
]

Get Specific Reservation -> { id, active_from, active_to, 16 more... }

get/v1/reservations/{reservation_id}

Get specific reservation