os.php¶

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

Методы API¶

Метод	Действие	Описание
`list`	получение списка ОС	Возвращает список операционных систем. При указании id или instance_id фильтрует ОС по совместимости с оборудованием или пресетом. Возвращает также список исключенных ОС.

os/list¶

Возвращает список операционных систем. При указании id или instance_id фильтрует ОС по совместимости с оборудованием или пресетом. Возвращает также список исключенных ОС.

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "list",
"os_list": [
{
"id": 101,
"name": "Ubuntu 20.04",
"active": 1,
"price_EUR": 0,
"price_RUB": 0,
"billing_plan": {
"USD": {
"hourly": 0.01,
"daily": 0.24,
"monthly": 7.2
},
"EUR": {
"hourly": 0.01,
"daily": 0.24,
"monthly": 7.2
}
},
"tags": [
{
"tag": "linux",
"value": "1",
"internal": 0
}
]
}
],
"os_excluded": [
{
"os_id": 105,
"name": "Windows Server 2019",
"foreman_id": 55
}
]
}

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

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

```