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"
}