Documentation | Reservations › Create Reservation

Reservations

reservations

Methods

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

post/v1/reservations

Create reservation

Response fields

id: number

Reservation id

active_from: string

(format: date)

Reservation active from date

active_to: string

(format: date)

Reservation active to date

activity_period: string

Name of the billing period, e.g month

activity_period_length: number

Length of the full reservation period by activity_period

amount_prices: { commit_price_per_month, commit_price_per_unit, commit_price_total, 4 more... }

Reservation amount prices

billing_plan_id: number

Billing plan id

created_at: string

(format: date-time)

Reservation creation date

error: string

Error message if any occured during reservation

eta: string

(format: date)

ETA delivery if bare metal out of stock. Value None means that bare metal in stock.

is_expiration_message_visible: boolean

Hide or show expiration message to customer.

name: string

Reservation name

next_statuses: Array<string>

List of possible next reservation statuses

region_id: number

Region id

region_name: string

Region name

remind_expiration_message: string

(format: date)

The date when show expiration date to customer

resources: Array<{ activity_period, activity_period_length, billing_plan_item_id, 16 more... }>

List of reservation resources

status: string

Reservation status

user_status: string

User status

Request example

curl https://api.gcore.com/cloud/v1/reservations \
    -H 'Content-Type: application/json' \
    -H "APIKey: $CLOUD_API_API_KEY" \
    -d '{
      "name": "name",
      "period": "MONTHS12",
      "region_id": 0,
      "resources": [
        {
          "resource_name": "bm1-hf-medium",
          "resource_type": "flavor",
          "resource_value": 2
        }
      ]
    }'

200Example

{
  "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"
}

Delete Reservation ->

delete/v1/reservations/{reservation_id}

Delete reservation

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

get/v1/reservations

List reservations

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

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

get/v1/reservations/{reservation_id}

Get specific reservation