os.php¶

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

Методы API¶

Метод	Действие	Описание
`list`	получение списка ОС	Возвращает список доступных операционных систем, отфильтрованных по параметрам оборудования (CPU, RAM, HDD), типу виртуализации (VM, BM, GPU, VDS) и лицензионным ограничениям сервера или пресета.

os/list¶

Возвращает список доступных операционных систем, отфильтрованных по параметрам оборудования (CPU, RAM, HDD), типу виртуализации (VM, BM, GPU, VDS) и лицензионным ограничениям сервера или пресета.

HTTP-метод: POST|GET

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `list`
token	❌	string	Токен авторизации
id	❌	int	ID сервера для подбора подходящей ОС
instance_id	❌	int	ID пресета для подбора параметров оборудования
location	❌	string	Код локации (например, NL)

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

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

Пример успешного ответа

{
"result": "OK",
"action": "list",
"os_list": [
{
"id": 101,
"name": "Ubuntu 22.04 LTS",
"active": 1,
"price_EUR": 5.5,
"billing_plan": {
"USD": "...",
"EUR": "..."
},
"ram": 4096,
"cores": 2,
"cpu_sockets": 1,
"hdd": 50,
"gpu": 0,
"bm": 0,
"vm": 1,
"vds": 0,
"location": "NL",
"allow_test_os": true,
"billing_plan_rub": {
"RUB": "..."
}
}
],
"os_excluded": [
{
"os_id": 105,
"name": "Windows Server 2022",
"foreman_id": 505
}
]
}

Примеры ошибок

``` { "code": -1, "message": "os/list: no OS found" }

```