Просмотр списка тарифов

Запрос

Для того, чтобы получить информацию о тарифах, необходимо отправить запрос типа GET на /v2/plans с указанием параметров:

Параметр

Тип

Описание

items_per_page

обязательный

Количество элементов на странице (от 1 до 100)

page

обязательный

Номер страницы пагинатора (минимум 1)

region

обязательный

Регион размещения

plan_line

опциональный

Идентификатор линейки тарифных планов

disk

опциональный

Объем диска (ГБ)

memory

опциональный

Количество памяти (ГБ)

vcpus

опциональный

Количество vCPU

unit

опциональный

Тип тарификации (hour — почасовая, month — помесячная)

Примечание

В API v2 пагинация обязательна для всех списков, так как полный набор данных может содержать тысячи элементов.

  • Для изменения количества элементов на странице укажите items_per_page от 10 до 100.

  • Используйте параметр page для перехода между страницами (начинается с 1).

  • Полный перебор всех элементов требует последовательных запросов с увеличением номера страницы.

Возможные значения параметра region:

Значение

Описание

msk1

Архивные тарифы в Москве

openstack-msk1

Тарифы в Москве

openstack-spb1

Тарифы в Санкт-Петербурге

openstack-sam1

Тарифы в Самаре

Возможные значения параметра plan_line:

Значение

Описание

base

Стандартный

hp

Производительный

highcpu

Высокочастотный

ddc

Выделенный CPU

gpu-hp

Производительный с GPU

Пример запроса:

curl \
-X GET \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
'https://api.cloudvps.reg.ru/v2/plans?region=openstack-msk1&page=1&items_per_page=10'

Ответ

В результате будет возвращён JSON с массивом из 10 тарифов (в примере показаны только 2):

{
  "metadata": {
    "pages": {
      "current": 1,            // Текущая страница
      "items_per_page": 100,   // Количество элементов на странице
      "total": 1
    },
    "total": 100               // Количество полученных элементов

  },
  "plans": [
    {
      "disk": 10,
      "id": 10451,
      "memory": 1024,
      "name": "HP C1-M1-D10",
      "plan_line": "hp",
      "price_per_hour": "0.71",
      "price_per_month": 480,
      "slug": "c1-m1-d10-hp",
      "unit": "hour",
      "vcpus": 1,
      "videocards": 0
    },
    {
      "disk": 40,
      "id": 10651,
      "memory": 2048,
      "name": "HP C2-M2-D40",
      "plan_line": "hp",
      "price_per_hour": "1.79",
      "price_per_month": 1200,
      "slug": "c2-m2-d40-hp",
      "unit": "hour",
      "vcpus": 2,
      "videocards": 0
    }
  ]
}

Каждый тариф содержит следующие параметры:

Поле

Описание

disk

Объем диска, ГБ

id

Идентификатор тарифа

memory

Количество памяти, ГБ

name

Имя тарифа

plan_line

Идентификатор линейки тарифов

price_per_hour

Цена за час

price_per_month

Цена за месяц

slug

Уникальный читаемый идентификатор тарифа

unit

Тип тарификации (hour или month)

vcpus

Количество vCPU

videocards

Наличие видеокарты