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"
    }
  ]
}
'

{
  "currency_code": "USD",
  "discount_details": [
    {
      "discount": "<string>",
      "resource": "<string>"
    }
  ],
  "discount_percent": "10.50",
  "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",
  "price_without_discount_per_month": 123,
  "tax_percent": 123,
  "total_price_per_hour": 123,
  "total_price_per_month": 123,
  "per_gb": {
    "egress_traffic_baremetal": 1.3
  },
  "vm_count": 1
}

POST

cloud

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"
    }
  ]
}
'

{
  "currency_code": "USD",
  "discount_details": [
    {
      "discount": "<string>",
      "resource": "<string>"
    }
  ],
  "discount_percent": "10.50",
  "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",
  "price_without_discount_per_month": 123,
  "tax_percent": 123,
  "total_price_per_hour": 123,
  "total_price_per_month": 123,
  "per_gb": {
    "egress_traffic_baremetal": 1.3
  },
  "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

region_id

integer

required

Region ID

Body

application/json

Pricing details for creating instances with version 2 interfaces.

flavor

string

required

The flavor of the instance.

interfaces

(NewInterfaceExternalSerializerPydantic · object | NewInterfaceSpecificSubnetFipSerializerPydantic · object | NewInterfaceAnySubnetFipSerializerPydantic · object | NewInterfaceReservedFixedIpFipSerializerPydantic · object)[]

required

Subnet IPs and floating IPs

Instance will be attached to default external network

NewInterfaceExternalSerializerPydantic
NewInterfaceSpecificSubnetFipSerializerPydantic
NewInterfaceAnySubnetFipSerializerPydantic
NewInterfaceReservedFixedIpFipSerializerPydantic

Show child attributes

interfaces.type

string

required

A public IP address will be assigned to the instance.

Allowed value: "external"

interfaces.interface_name

string

Interface name. Defaults to null and is returned as null in the API response if not set.

Maximum string length: 37

interfaces.ip_family

enum<string> | null

default:ipv4

Specify ipv4, ipv6, or dual to enable both.

Available options:

dual,

ipv4,

ipv6

interfaces.security_groups

MandatoryIdSchema schema · object[]

Specifies security group UUIDs to be applied to the instance network interface.

Show child attributes

interfaces.security_groups.id

string<uuid4>

required

Resource ID

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.

names

string[]

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

volumes

InstanceVolumePricingRequestSerializer · object[]

A list of volumes to be created or used.

Show child attributes

volumes.source

enum<string>

required

The source of the volume. It must be one of: 'new-volume', 'image', 'snapshot', 'apptemplate'.

Available options:

apptemplate,

existing-volume,

image,

new-volume,

snapshot

volumes.size

integer | null

Volume size in GiB.

Example:

1000

volumes.snapshot_id

string | null

The snapshot ID. It is mandatory if the volume is created from a snapshot.

Example:

"7cca40d7-a843-4e9f-ae08-62b9a394b1ab"

volumes.type_name

enum<string> | null

The type of the volume. It must be one of: 'standard', 'ssd_hiiops', 'cold', 'ultra'.

Available options:

cold,

ssd_hiiops,

ssd_local,

ssd_lowlatency,

standard,

ultra

Example:

"standard"

Response

200 - application/json

Billing response v2 preview schema for server instance.

currency_code

enum<string> | null

required

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

Available options:

AZN,

EUR,

USD

Example:

"USD"

discount_details

ResourceDiscountSerializer · object[]

required

Discount details per resource.

Show child attributes

discount_details.discount

string

required

Discount value within range [0..1] where 1 is 100%.

discount_details.resource

string

required

Resource name.

discount_percent

string | null

required

Actual discount as a relative value.

Example:

"10.50"

per_hour

DetailedInstancePricingSerializer · object

required

Prices per category charged per hour.

Show child attributes

per_hour.external_ip

number | null

Price of external/public IP over the specified period of time.

Example:

14.4

per_hour.flavor

number | null

Price of flavor over the specified period of time.

Example:

576

per_hour.floating_ip

number | null

Price of floating IP over the specified period of time.

Example:

36

per_hour.volumes

InstanceVolumesPricingSerializer · object

Prices of volumes per type over the specified period of time.

Show child attributes

per_hour.volumes.cold

number | null

Price of cold volume over the specified period of time.

Example:

78

per_hour.volumes.ssd_hiiops

number | null

Price of ssd_hiiops volume over the specified period of time.

Example:

20

per_hour.volumes.ssd_lowlatency

number | null

Price of ssd_lowlatency volume over the specified period of time.

Example:

10

per_hour.volumes.standard

number | null

Price of standard volume over the specified period of time.

Example:

10

per_hour.volumes.ultra

number | null

Price of ultra volume over the specified period of time.

Example:

78

Example:

{
  "cold": 78,
  "ssd_hiiops": 20,
  "ssd_lowlatency": 10,
  "standard": 10,
  "ultra": 78
}

per_month

DetailedInstancePricingSerializer · object

required

Prices per category charged per month.

Show child attributes

per_month.external_ip

number | null

Price of external/public IP over the specified period of time.

Example:

14.4

per_month.flavor

number | null

Price of flavor over the specified period of time.

Example:

576

per_month.floating_ip

number | null

Price of floating IP over the specified period of time.

Example:

36

per_month.volumes

InstanceVolumesPricingSerializer · object

Prices of volumes per type over the specified period of time.

Show child attributes

per_month.volumes.cold

number | null

Price of cold volume over the specified period of time.

Example:

78

per_month.volumes.ssd_hiiops

number | null

Price of ssd_hiiops volume over the specified period of time.

Example:

20

per_month.volumes.ssd_lowlatency

number | null

Price of ssd_lowlatency volume over the specified period of time.

Example:

10

per_month.volumes.standard

number | null

Price of standard volume over the specified period of time.

Example:

10

per_month.volumes.ultra

number | null

Price of ultra volume over the specified period of time.

Example:

78

Example:

{
  "cold": 78,
  "ssd_hiiops": 20,
  "ssd_lowlatency": 10,
  "standard": 10,
  "ultra": 78
}

price_status

enum<string>

required

Price status for the UI.

Available options:

error,

hide,

show

price_without_discount_per_month

number | null

required

Total price VAT inclusive per month without discount.

tax_percent

number

required

Tax rate applied to the subtotal, represented as a percentage

total_price_per_hour

number | null

required

Total price VAT inclusive per hour.

total_price_per_month

number | null

required

Total price VAT inclusive per month.

per_gb

DetailedInstancePricingPerGBSerializer · object

Pricing details per category charged per GB.

Show child attributes

per_gb.egress_traffic_baremetal

number | null

The price of egress traffic per GB.

Example:

0.05

Example:

{ "egress_traffic_baremetal": 1.3 }

vm_count

integer

default:1

Number of virtual machine instances being created.

Enable port security for instance interface Get instance price

⌘I

Overview

IAM

CDN

Managed DNS

Cloud

DDoS Protection

FastEdge

WAAP

Streaming

Object Storage

Resellers

Preview instance price

Authorizations

Path Parameters

Body

Response