Skip to main content
POST
/
cloud
/
v2
/
pricing
/
{project_id}
/
{region_id}
/
instances
Preview instance price
curl --request POST \
  --url https://api.gcore.com/cloud/v2/pricing/{project_id}/{region_id}/instances \
  --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": [
    "my-instance-1"
  ],
  "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"
    }
  ]
}
'
{
  "currency_code": "USD",
  "per_gb": {
    "egress_traffic_baremetal": 1.3
  },
  "per_hour": {
    "external_ip": 0.02,
    "flavor": 0.8,
    "floating_ip": 0.05,
    "volumes": {
      "cold": 0.1083,
      "ssd_hiiops": 0.0278,
      "standard": 0.0139
    }
  },
  "per_month": {
    "external_ip": 14.4,
    "flavor": 576,
    "floating_ip": 36,
    "volumes": {
      "cold": 78,
      "ssd_hiiops": 20,
      "standard": 10
    }
  },
  "price_status": "show",
  "total_price_per_hour": 1.02,
  "total_price_per_month": 734.4,
  "vm_count": 1
}

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

Pricing details for creating instances with version 2 interfaces.

​
flavor
string
required

The flavor of the instance.

Examples:

"g1-standard-1-2"

​
interfaces
Interfaces · array
required

Subnet IPs and floating IPs

​
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"]
​
volumes
InstanceVolumePricingRequestSerializer · object[]

A list of volumes to be created or used.

Examples:
[
  {
    "image_id": "b5b4d65d-945f-4b98-ab6f-332319c724ef",
    "size": 10,
    "source": "image",
    "type_name": "ssd_hiiops"
  },
  {
    "size": 5,
    "source": "new-volume",
    "type_name": "standard"
  }
]

Response

200 - application/json

OK

Billing response v2 preview schema for server instance.

​
per_hour
object
required

Prices per category charged per hour.

Examples:
{
  "external_ip": 14.4,
  "flavor": 576,
  "floating_ip": 36,
  "volumes": {
    "cold": 78,
    "ssd_hiiops": 20,
    "standard": 10,
    "ultra": 78
  }
}
​
per_month
object
required

Prices per category charged per month.

Examples:
{
  "external_ip": 14.4,
  "flavor": 576,
  "floating_ip": 36,
  "volumes": {
    "cold": 78,
    "ssd_hiiops": 20,
    "standard": 10,
    "ultra": 78
  }
}
​
price_status
enum<string>
required

Price status for the UI.

Available options:
error,
hide,
show
​
currency_code
enum<string> | null

Currency code (3-letter code per ISO 4217).

Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHF,
CLP,
CNY,
COP,
CRC,
CUC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRO,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
SSP,
STD,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VEF,
VND,
VUV,
WST,
XAF,
XAG,
XAU,
XBA,
XBB,
XBC,
XBD,
XCD,
XDR,
XOF,
XPD,
XPF,
XPT,
XSU,
XTS,
XUA,
XXX,
YER,
ZAR,
ZMW,
ZWL
Examples:

"USD"

"EUR"

​
discount_percent
string | null

Actual discount as a relative value.

Examples:

"10.50"

"5.00"

​
per_gb
object | null

Pricing details per category charged per GB.

Examples:
{ "egress_traffic_baremetal": 1.3 }
​
price_without_discount_per_month
number | null

Total price VAT inclusive per month without discount.

Examples:

"800.00"

"1000.50"

​
total_price_per_hour
number | null

Total price VAT inclusive per hour.

Examples:

"1.02"

"2.50"

​
total_price_per_month
number | null

Total price VAT inclusive per month.

Examples:

"734.4"

"1200.00"

​
vm_count
integer
default:1

Number of virtual machine instances being created.

Examples:

1

10