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": "<string>",
  "interfaces": [
    {
      "interface_name": "eth0",
      "ip_family": "ipv4",
      "type": "external"
    }
  ],
  "name_templates": [
    "<string>"
  ],
  "names": [
    "<string>"
  ],
  "volumes": [
    {
      "source": "apptemplate",
      "size": 1000,
      "snapshot_id": "7cca40d7-a843-4e9f-ae08-62b9a394b1ab",
      "type_name": "standard"
    }
  ]
}
'
{
  "per_hour": {
    "external_ip": 14.4,
    "flavor": 576,
    "floating_ip": 36,
    "volumes": {
      "cold": 78,
      "ssd_hiiops": 20,
      "ssd_lowlatency": 10,
      "standard": 10,
      "ultra": 78
    }
  },
  "per_month": {
    "external_ip": 14.4,
    "flavor": 576,
    "floating_ip": 36,
    "volumes": {
      "cold": 78,
      "ssd_hiiops": 20,
      "ssd_lowlatency": 10,
      "standard": 10,
      "ultra": 78
    }
  },
  "price_status": "error",
  "currency_code": "USD",
  "discount_percent": "10.50",
  "per_gb": {
    "egress_traffic_baremetal": 1.3
  },
  "price_without_discount_per_month": "800.00",
  "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

Example:

1

​
region_id
integer
required

Region ID

Example:

1

Body

application/json

Pricing details for creating instances with version 2 interfaces.

​
flavor
string
required

The flavor of the instance.

Example:

"g1-standard-1-2"

​
interfaces
(NewInterfaceExternalSerializerPydantic · object | NewInterfaceSpecificSubnetFipSerializerPydantic · object | NewInterfaceAnySubnetFipSerializerPydantic · object | NewInterfaceReservedFixedIpFipSerializerPydantic · object)[]
required

Subnet IPs and floating IPs

Instance will be attached to default external network

Example:
{
  "interface_name": "eth0",
  "ip_family": "ipv4",
  "type": "external"
}
​
name_templates
(string | null)[]

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

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

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

Example:
["my-instance-1"]
​
volumes
InstanceVolumePricingRequestSerializer · object[]

A list of volumes to be created or used.

Example:
[
  {
    "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
DetailedInstancePricingSerializer · object
required

Prices per category charged per hour.

Example:
{
  "external_ip": 0.02,
  "flavor": 0.8,
  "floating_ip": 0.05,
  "volumes": {
    "cold": 0.1083,
    "ssd_hiiops": 0.0278,
    "standard": 0.0139
  }
}
​
per_month
DetailedInstancePricingSerializer · object
required

Prices per category charged per month.

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

Price status for the UI.

Available options:
error,
hide,
show
Examples:

"show"

"hide"

​
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
Required string length: 3
Example:

"USD"

​
discount_percent
string | null

Actual discount as a relative value.

Example:

"10.50"

​
per_gb
DetailedInstancePricingPerGBSerializer · object

Pricing details per category charged per GB.

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

Total price VAT inclusive per month without discount.

Example:

"800.00"

​
total_price_per_hour
number | null

Total price VAT inclusive per hour.

Example:

"1.02"

​
total_price_per_month
number | null

Total price VAT inclusive per month.

Example:

"734.4"

​
vm_count
integer
default:1

Number of virtual machine instances being created.

Examples:

1

10