os.php¶

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

Методы API¶

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

os/list¶

Возвращает список доступных операционных систем с фильтрацией по типу оборудования (VM, BM, GPU), лицензиям и локации. Поддерживает фильтрацию для конкретного сервера или пресета.

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "list",
"os_list": [
  {
    "id": 101,
    "name": "Ubuntu 22.04 LTS",
    "active": 1,
    "tags": [
      {
        "tag": "uefi",
        "value": "true"
      },
      {
        "tag": "vm",
        "value": "true"
      }
    ],
    "price_EUR": 0.0,
    "price_RUB": 0.0,
    "location": "NL",
    "billing_plan": "monthly",
    "cores": 2,
    "ram": 4096,
    "hdd": 80,
    "cpu_sockets": 1,
    "bm": 0,
    "gpu": 0,
    "vds": 0,
    "vgpu": 0
  },
  {
    "id": 102,
    "name": "Windows Server 2022",
    "active": 1,
    "tags": [
      {
        "tag": "uefi",
        "value": "true"
      },
      {
        "tag": "license",
        "value": "required"
      }
    ],
    "price_EUR": 15.0,
    "price_RUB": 1500.0,
    "location": "DE",
    "billing_plan": "monthly",
    "cores": 4,
    "ram": 8192,
    "hdd": 160,
    "cpu_sockets": 1,
    "bm": 1,
    "gpu": 0,
    "vds": 0,
    "vgpu": 0
  }
]
}

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

{
"code": -1,
"message": "no OS found"
}