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

Запрос

Для того, чтобы получить информацию о тарифах, необходимо отправить запрос типа 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	Наличие видеокарты