Моментальные серверы

Last modified by Hostkey Admin on 2023/06/26 16:33

HOSTKEY предоставляет несколько основных видов услуг:

серверы индивидуальной сборки - одно- и двухпроцессорные серверы, построенные по спецификациям заказчика из аппаратного обеспечения последнего поколения
стандартные конфигурации (инстансы): вычислительные (ВМ), физические серверы, физические серверы с графическими процессорами и vGPU серверы (ВМ с графическим процессором PCIe-passthrough). Эти конфигурации собраны заранее и разворачиваются автоматически в течение 10-20 минут.
стоковые серверы - физические серверы старых поколений, нестандартные конфигурации, серверы без модулей удаленного управления.
сервера с Ryzen/i9/i10 — высокоскоростные однопроцессорные серверы, построенные на базе новейших процессоров Ryzen 9 или i9/i10. Как правило, без модулей дистанционного управления.

Заказать моментальные серверы возможно через API. Все платежи за моментальные серверы идут со счета биллинга. Для размещения заказа на счету клиента должна быть необходимая сумма.

Действия по заказу моментальных серверов

Ресурс	Действие	Описание
presets.php	list	вызов списка доступных инстансов для определенного региона
os.php	list	получение списка ОС для инстанса
traffic_plans.php	list	получение тарифного плана трафика для инстанса
eq.php	order_instance	получение информации об оплате аренды сервера или иного продукта

В названии инстансов могут использоваться следующие сокращения:

BM - физические серверы;
VM - виртуальные инстансы (VM);
Compute - виртуальные серверы общего назначения на базе KVM (VPS);
Gpu - GPU серверы;
Vgpu - vGPU серверы.

Presets/List

В настоящее время доступны инстансы в России, Нидерландах и США. Используя вызов “list”, можно получить актуальный список доступных инстансов с указанием стоимости аренды. Токен доступа не требуется.

HTTP-метод - POST

Параметр	Обязательный параметр	Тип	Значение/по умолчанию	Описание
action	*	string	list	ключевое действие - вызов списка доступных инстансов для определенного региона
location	*	string		местоположение инстанса

curl -s "https://invapi.hostkey.ru/presets.php" -X POST \
--data "action=list" \
--data "location=" \

Пример ответа:

{
   "result": "OK",
   "action": "list",
   "presets": [{
       "id": 1,   **- id инстанса**
       "name": "vm.nano", - **название инстанса**
       "active": 1, **- количество активных инстансов**
       "monthly_ru": 270, **- цена в рублях с учетом регионального НДС**
       "monthly_com": 3, **- цена в евро с учетом регионального НДС. Для клиентов из ЕС без ID плательщика НДС, должен быть добавлен соответствующий местный НДС **
       "description": "VM instance 1\/2\/20", **- описание**
       "cpu": 1, **- количество CPU**
       "ram": 2, - ** объем RAM в Gb**
       "hdd": 20, **- объем жесткого диска в Gb**
       "gpu": "", **- указывается GPU, если установлен**
       "locations": "RU,NL,US", **- перечень локаций, в которых доступен инстанс. Россия, Нидерланды и США**
       "virtual": 1, **- указание на то, что инстанс является виртуальным (VM)**
       "tags": [{ **- набор тегов для указания правильного пользовательского интерфейса**
           "id": 7112, **- тег ID**
           "tag": "vm", **- это VM**
           "value": "true",
           "extra": "",
           "internal": 1
        }, {
           "id": 7123,
           "tag": "compute",
           "value": "1",
           "extra": "",
           "internal": 1
        }],
       "available": 3 **- количество инстансов, доступных для моментального заказа**
    }, ... , {
       "id": 15,
       "name": "bm.v1-mini",
       "active": 1,
       "monthly_ru": 3600,
       "monthly_com": 35,
       "description": "BM i3\/8\/240", ** - физические сервера с двухъядерным процессором i3**
       "cpu": 2,
       "ram": 8,
       "hdd": 240,
       "gpu": "",
       "locations": "RU,NL",
       "virtual": 0,
       "tags": [{
           "id": 7130,
           "tag": "bm", **- это физический сервер**
           "value": "true",
           "extra": "",
           "internal": 1
        }],
       "available": 3
    }, ... , {
       "id": 8,
       "name": "vgpu.v1-mini",
       "active": 1,
       "monthly_ru": 8800,
       "monthly_com": 157,
       "description": "vGPU 4\/16\/240 + 1080",
       "cpu": 4,
       "ram": 16,
       "hdd": 240,
       "gpu": "1xGTX1080", **этот сервер оснащен графическим процессором GTX 1080 **
       "locations": "RU,NL",
       "virtual": 1,
       "tags": [{
           "id": 7118,
           "tag": "gpu", **- это GPU сервер**
           "value": "1",
           "extra": "",
           "internal": 1
        }, {
           "id": 11428,
           "tag": "vgpu", **- это vGPU сервер**
           "value": "true",
           "extra": "",
           "internal": 1
        }],
       "available": 0
    } ...
}

Сведения об ОС и список постустановочных задач необходимы для оформления заказа.

OS/List

По сути, можно игнорировать все теги с этим запросом. Вызов вернет только подходящую ОС для конкретного инстанса. Все цены на лицензии Windows уже рассчитаны.

Следует учитывать, что все цены указаны только для создания надлежащего пользовательского интерфейса. Они будут пересчитаны в бэкэнде во время заказа.

HTTP-метод - POST

Параметр	Обязательный параметр	Тип	Значение/по умолчанию	Описание
action	*	string	list	ключевое действие - получение списка ОС для конкретного инстанса
location	*	string		местоположение инстанса
instance_id	*	int		ID инстанса

curl -s "https://invapi.hostkey.ru/os.php" -X POST \
--data "action=list" \
--data "instance_id=" \

Пример ответа:

{
   "result": "OK",
   "action": "list",
   "os_list": [{
       "id": 112,   **- OS ID**
       "name": "CentOS 7", ** - название ОС**
       "tags": [{
           "id": 11524,
           "tag": "bm", ** эта ОС подходит для серверов BM**
           "value": "true",
           "extra": "",
           "internal": 0
        }, {
           "id": 11525,
           "tag": "gpu", **эта ОС подходит для GPU серверов**
           "value": "true",
           "extra": "",
           "internal": 0
        }, {
           "id": 11526,
           "tag": "vgpu", **эта ОС подходит для VGPU серверов**
           "value": "true",
           "extra": "",
           "internal": 0
        }, {
           "id": 11527,
           "tag": "vm", **эта ОС подходит для серверов VM**
           "value": "true",
           "extra": "",
           "internal": 0
        }]
    }, {
       "id": 166,
       "name": "Windows Server 2019 VM",
       "api_enabled": 0,
       "type_login": 1,
       "pxe_os_id": null,
       "active": 1,
       "description": "WS19 DC для VMs",
       "tags": [{
           "id": 11568,
           "tag": "vm",
           "value": "true",
           "extra": "",
           "internal": 0
        }, {
           "id": 11569,
           "tag": "vgpu",
           "value": "true",
           "extra": "",
           "internal": 0
        }, {
           "id": 11571,
           "tag": "VPS_free",
           "value": "true",
           "extra": "",
           "internal": 0
        }, {
           "id": 13080,
           "tag": "min_ram", **- минимальные требования к объёму оперативной памяти**
           "value": "4", ** - 4Gb**
           "extra": "",
           "internal": 0
        }, {
           "id": 13081,
           "tag": "min_hdd", **- минимальные требования к объему жесткого диска**
           "value": "32", ** 32Gb**
           "extra": "",
           "internal": 0
        }]
    }, {
       "id": 151,
       "name": "Windows Server 2019 Standard",
       "api_enabled": 0,
       "type_login": 1,
       "pxe_os_id": null,
       "active": 1,
       "description": "null",
       "tags": [{
           "id": 11403,
           "tag": "price_per_core_EUR", **- Плата за лицензию MS для продукта SPLA в евро за ядро, минимум 8 лицензий**
           "value": "3.5",
           "extra": "",
           "internal": 0
        }, {
           "id": 11562,
           "tag": "bm",
           "value": "true",
           "extra": "",
           "internal": 0
        }, {
           "id": 11563,
           "tag": "gpu",
           "value": "true",
           "extra": "",
           "internal": 0
        }, {
           "id": 11660,
           "tag": "price_per_core_RUB", - **- Стоимость лицензии MS на продукт SPLA в рублях за ядро, минимум 8 лицензий**
           "value": "315",
           "extra": "",
           "internal": 0
        }, {
           "id": 13078,
           "tag": "min_ram",
           "value": "4",
           "extra": "",
           "internal": 0
        }, {
           "id": 13079,
           "tag": "min_hdd",
           "value": "32",
           "extra": "",
           "internal": 0
        }],
       "price_EUR": 28, - **- расчетная стоимость этой лицензии в евро (без НДС)**
       "price_RUB": 2520 **- расчетная стоимость данной лицензии в рублях (с НДС)**
    }]
}

Traffic_plans/List

HTTP-метод - POST

Параметр	Обязательный параметр	Тип	Значение/по умолчанию	Описание
action	*	string	list	ключевое действие - получение тарифного плана для инстанса
location	*	string		местоположение инстанса
instance_id	*	int		ID инстанса

curl -s "https://invapi.hostkey.ru/traffic_plans.php" -X POST \
--data "action=list" \
--data "location=" \
--data "instance=" \

Пример ответа:

{
   "result": "OK",
   "action": "list",
   "traffic_plans": [{
       "id": 12, **id тарифного плана трафика**
       "name": "50Tb free (1Gbps)", **- название тарифного плана трафика**
       "limit_in": 999, **- входящий лимит Тб**
       "limit_out": 50, ** - исходящий лимит Тб**
       "rate_in": 0, **-стоимость избыточного входящего трафика в евро/Tb
       "rate_out": 2, **-стоимость избыточного исходящего трафика в евро/Tb
       "bandwidth": 1000, **- ограничение пропускной способности (Мбит/с)**
       "locations": "NL,", **- регион**
       "currency_id": 0, **- этот план для евро, id валюты== 0**
       "active": 1,
       "web_plan": 0,
       "price": 0, **- фиксированная цена, бесплатно**
       "tags": [{
           "id": 12383,
           "tag": "gpu",
           "value": "true",
           "extra": "",
           "internal": 0
        }, {
           "id": 11446,
           "tag": "bm",
           "value": "true",
           "extra": "",
           "internal": 1
        }]
    }, {
       "id": 23,
       "name": "1 Гбит/с без учета справедливого использования",
       "limit_in": 999,
       "limit_out": 999,
       "rate_in": 0,
       "rate_out": 0,
       "bandwidth": 1000,
       "locations": "NL,US,",
       "currency_id": 0,
       "active": 1,
       "web_plan": 0,
       "price": 0,
       "tags": [{
           "id": 11420,
           "tag": "unmetered",
           "value": "true",
           "extra": "",
           "internal": 1
        }, {
           "id": 13934,
           "tag": "gpu",
           "value": "true",
           "extra": "",
           "internal": 1
        }, {
           "id": 13935,
           "tag": "bm",
           "value": "true",
           "extra": "",
           "internal": 1
        }]
    }, {
       "id": 33,
       "name": "50Tb (1Gbps port) NL",
       "limit_in": 999,
       "limit_out": 50,
       "rate_in": 0,
       "rate_out": 180,
       "bandwidth": 1000,
       "locations": "NL,",
       "currency_id": 1, **- цена указана в рублях, эта надпись будет получена, если у выбранная валюта - рубль**
       "active": 1,
       "web_plan": 0,
       "price": 0,
       "tags": [{
           "id": 12382,
           "tag": "gpu",
           "value": "true",
           "extra": "",
           "internal": 0
        }, {
           "id": 11474,
           "tag": "bm",
           "value": "true",
           "extra": "",
           "internal": 1
        }]
    }, {
       "id": 14,
       "name": "1Gbps unmetered",
       "limit_in": 999,
       "limit_out": 999,
       "rate_in": 0,
       "rate_out": 0,
       "bandwidth": 1000,
       "locations": "NL,",
       "currency_id": 0,
       "active": 1,
       "web_plan": 0,
       "price": 140,
       "tags": [{
           "id": 11450,
           "tag": "bm",
           "value": "true",
           "extra": "",
           "internal": 1
        }, {
           "id": 11451,
           "tag": "unmetered",
           "value": "true",
           "extra": "",
           "internal": 1
        }, {
           "id": 11462,
           "tag": "gpu",
           "value": "true",
           "extra": "",
           "internal": 1
        }]
    }, {
       "id": 35,
       "name": "1Gbps unlimited NL",
       "limit_in": 999,
       "limit_out": 999,
       "rate_in": 0,
       "rate_out": 2,
       "bandwidth": 1000,
       "locations": "NL,",
       "currency_id": 1,
       "active": 1,
       "web_plan": 0,
       "price": 12600,
       "tags": [~{~{
   "result": "OK",
   "action": "list",
   "traffic_plans": [{
       "id": 12,
       "name": "50Tb free (1Gbps)",
       "limit_in": 999,
       "limit_out": 50,
       "rate_in": 0,
       "rate_out": 2,
       "bandwidth": 1000,
       "locations": "NL,",
       "currency_id": 0,
       "active": 1,
       "web_plan": 0,
       "price": 0,
       "tags": [{
           "id": 12383,
           "tag": "gpu",
           "value": "true",
           "extra": "",
           "internal": 0
        }, {
           "id": 11446,
           "tag": "bm",
           "value": "true",
           "extra": "",
           "internal": 1
        }]
    }, {
       "id": 23,
       "name": "1Gbps unmetered fair usage",
       "limit_in": 999,
       "limit_out": 999,
       "rate_in": 0,
       "rate_out": 0,
       "bandwidth": 1000,
       "locations": "NL,US,",
       "currency_id": 0,
       "active": 1,
       "web_plan": 0,
       "price": 0,
       "tags": [{
           "id": 11420,
           "tag": "unmetered",
           "value": "true",
           "extra": "",
           "internal": 1
        }, {
           "id": 13934,
           "tag": "gpu",
           "value": "true",
           "extra": "",
           "internal": 1
        }, {
           "id": 13935,
           "tag": "bm",
           "value": "true",
           "extra": "",
           "internal": 1
        }]
    }, {
       "id": 33,
       "name": "50Tb (1Gbps port) NL",
       "limit_in": 999,
       "limit_out": 50,
       "rate_in": 0,
       "rate_out": 180,
       "bandwidth": 1000,
       "locations": "NL,",
       "currency_id": 1,
       "active": 1,
       "web_plan": 0,
       "price": 0,
       "tags": [{
           "id": 12382,
           "tag": "gpu",
           "value": "true",
           "extra": "",
           "internal": 0
        }, {
           "id": 11474,
           "tag": "bm",
           "value": "true",
           "extra": "",
           "internal": 1
        }]
    }, {
       "id": 14,
       "name": "1Gbps unmetered",
       "limit_in": 999,
       "limit_out": 999,
       "rate_in": 0,
       "rate_out": 0,
       "bandwidth": 1000,
       "locations": "NL,",
       "currency_id": 0,
       "active": 1,
       "web_plan": 0,
       "price": 140,
       "tags": [{
           "id": 11450,
           "tag": "bm",
           "value": "true",
           "extra": "",
           "internal": 1
        }, {
           "id": 11451,
           "tag": "unmetered",
           "value": "true",
           "extra": "",
           "internal": 1
        }, {
           "id": 11462,
           "tag": "gpu",
           "value": "true",
           "extra": "",
           "internal": 1
        }]
    }, {
       "id": 35,
       "name": "1Gbps unlimited NL",
       "limit_in": 999,
       "limit_out": 999,
       "rate_in": 0,
       "rate_out": 2,
       "bandwidth": 1000,
       "locations": "NL,",
       "currency_id": 1,
       "active": 1,
       "web_plan": 0,
       "price": 12600,
       "tags": [{
           "id": 11468,
           "tag": "bm",
           "value": "true",
           "extra": "",
           "internal": 1
        }, {
           "id": 11469,
           "tag": "unmetered",
           "value": "true",
           "extra": "",
           "internal": 1
        }, {
           "id": 11470,
           "tag": "gpu",
           "value": "true",
           "extra": "",
           "internal": 1
        }]
    }]
}
           "id": 11468,
           "tag": "bm",
           "value": "true",
           "extra": "",
           "internal": 1
       }, {
           "id": 11469,
           "tag": "unmetered",
           "value": "true",
           "extra": "",
           "internal": 1
        }, {
           "id": 11470,
           "tag": "gpu",
           "value": "true",
           "extra": "",
           "internal": 1
        }]
    }]
}

Eq/Order_instance

HTTP-метод - POST

Параметр	Обязательный параметр	Тип	Значение/по умолчанию	Описание
action	*	string	order_instance	ключевое действие - заказ конкретного инстанса
token	*	string		сессионный токен
deploy_period	*	string		месяц, квартал, 6 месяцев, год. Скидки на сервер составляют 3, 6 и 12%, за исключением тарифных планов и лицензий
deploy_notify	*	string		уведомление по электронной почте об успешном завершении развертывания
pin	*	int		PIN-код
id	*	int		ID сервера, пока неизвестен
os_id	*	int		ID ОС из списка операционных систем
root_pass	*	string		пароль root по умолчанию
hostname		string		имя хоста развернутого инстанса. По умолчанию используется ID инстанса
ssh_key		string		открытый ключ ssh для пользователя root
post_install_callback		string		URL для вызова после успешного развертывания
post_install_script		string		код для запуска после успешного развертывания
os_name		string		название ОС
own_os		string		если установлено значение 1, инстанс будет доставлен без переустановки. Этот вызов полезен, если планируется установить ОС позже
jenkins_task		string		ID задачи Jenkins для запуска после развертывания. Допустимые значения: 1 - установка драйвера GPU, 2 - драйвер GPU плюс докер NVIDIA, 3 - драйвер, докер плюс патч IOMMU, -1 - ничего не делать
traffic_plan	*	string		ID выбранного плана трафика
preset	*	string		код инстанса для развертывания
location_name	*	string		название локации сервера - NL/RU/US - Нидерланды, Россия, США

curl -s "https://invapi.hostkey.ru/eq.php" -X POST \
--data "action=order_instance" \
--data "token=" \
--data "deploy_period=" \
--data "deploy_notify=" \
--data "email=" \
--data "pin=" \
--data "id=" \
--data "os_id=" \
--data "root_pass=" \
--data "hostname=" \
--data "ssh_key=" \
--data "post_install_callback=" \
--data "post_install_script=" \
--data "reinstall_key=" \
--data "os_name=" \
--data "imitate_deploy=" \
--data "imitate_error=0" \
--data "own_os=" \
--data "jenkins_task=" \
--data "traffic_plan=" \
--data "invoice_relid=" \
--data "preset=" \
--data "location_name=" \

После получения запроса INVAPI выберет/создаст соответствующий сервер в определенном месте и продолжит его деплой. Перед любой установкой будет произведена проверка наличия средств на кредитном счете. Если установка пройдет успешно, новый сервер будет привязан к учетной записи клиента. По запросу клиент будет уведомлен по электронной почте. Все платные лицензии будут добавлены в качестве дополнений к заказу.

Для этого действия есть соответствующий асинхронный ответ

Пример ответа:

Описание ключей:

callback - асинхронный ключ для отслеживания процесса установки;
deploy_status - install - означает, что установка была начата;
id - ID нового сервера.

Для этого действия есть соответствующий асинхронный ответ

Асинхронные ответы:

Приступить к использованию сервера можно после получения статуса “ОК” в ответе “result”. При возникновении сбоя в процессе развертывания сервера, на почту будет отправлено уведомление. Развертывание может занять до 20 минут, обычно этот процесс занимает от 5 до 10 минут.

Tags:

Моментальные серверы

Presets/List

OS/List

Traffic_plans/List

Eq/Order_instance

Navigation