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",
  "discount_percent": "10.50",
  "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",
  "price_without_discount_per_month": 123,
  "tax_percent": 0,
  "total_price_per_hour": 123,
  "total_price_per_month": 123,
  "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.

​
currency_code
enum<string> | null
required

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

Available options:
AZN,
EUR,
USD
Examples:

"USD"

"EUR"

​
discount_percent
string | null
required

Actual discount as a relative value.

Examples:

"10.50"

"5.00"

​
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
​
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

Examples:

0

17

12

​
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
object | null

Pricing details per category charged per GB.

Examples:
{ "egress_traffic_baremetal": 1.3 }
​
vm_count
integer
default:1

Number of virtual machine instances being created.

Examples:

1

10