Команды портала «Агрегатор»
Доступные команды модуля «auth» портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд модуля «auth» портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список доменов аутентификации |
|
PATCH |
Завершает аутентификацию Kerberos PKINIT |
|
PATCH |
Инициализирует аутентификацию Kerberos PKINIT и получает данные на подпись |
|
PATCH |
Прямой запрос на сервер Kerberos PKINIT с подписанным сертификатом |
|
POST |
Авторизация «Агрегатора» на «Универсальном диспетчере». В ответ на подписанный «Агрегатором» токен «Универсальный диспетчер» возвращает сеансовый ключ (токен) |
|
POST |
Аутентификация пользователя на базе аутентификатора, логина и пароля. При отправке запроса необходимо обязательно указать один из параметров:
|
|
POST |
Двухфакторная аутентификация пользователя на базе аутентификатора, логина и пароля. При отправке запроса необходимо обязательно указать один из параметров:
|
|
POST |
Прекращение действие токена/сессии пользователя. Токен аутентификации должен передаваться в заголовке |
|
GET |
Получение глобальных настроек сервера |
Доступные команды модуля «client» портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд модуля «client» портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
API для выдачи параметров подключения компоненту «Клиент» для протоколов RDP и SPICE от «Универсального диспетчера» |
|
GET |
API для выдачи параметров подключения компоненту «Клиент» для протоколов RDP и SPICE от «Универсального диспетчера». Компонент «Клиент» использует метод для проверки готовности сервиса к подключению и уточнения используемого протокола. По полученным данным принимает решение: завершить неудачное подключение, подождать и повторить, подключаться новым/старым методом |
|
POST |
Обновляет ссылку для переподключения к сессии РМ |
|
GET |
Получение и сравнение списка доменов аутентификации из базы данных (БД) и от «Универсального диспетчера», а также получение связанного списка сервисов, если получены совпадающие короткие наименования доменов аутентификации (одинаковые метки доменов) |
Доступные команды модуля «discover» портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд модуля «discover» портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список модулей API, предоставляемых «Агрегатором» |
Доступные команды модуля «health» портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд модуля «health» портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Проверка состояния сервера. Собираются общие показатели и набор числовых метрик. Для авторизации при обращении к запросу используется токен, определенный в переменной Оценка состояния должна производиться в инициаторе запроса на основе набора правил и пороговых значений с учетом конкретной конфигурации системы. Для разных конфигураций системы один и тот же показатель в абсолютном выражении может соответствовать состоянию и «PASS», и «FAIL». Формат запроса:
где:
Пример возвращаемого списка приведен после таблицы |
|
GET |
Возвращает список метрик сервера. Для авторизации при обращении к запросу используется токен, определенный в переменной Формат запроса:
где:
Информацию по всем возвращаемым значениям можно получить в документации библиотеки Вид возвращаемого списка метрик приведен после таблицы |
Пример возвращаемого списка для /aggregator/health/check:
{"version":"5.1","description":"termidesk-aggregator","status":"pass","checks":
{
"celery:connectionTest":
[{"componentId":"celery(common)","componentType":"component","status":"pass"},
{"componentId":"celery@test(worker)","componentType":"component","status":"pass"}],
"database:responseTime":
[{"componentId":"default","componentType":"datastore","observedValue":0.00040602684020996094,"observedUnit":"s","status":"pass"}],
"messages_broker:connectionTest":
[{"componentId":"amqp://termidesk:**@localhost:5672/termidesk","componentType":"component","status":"pass"}],
"fluentd:connectionTest":[],
"sites:connectionTest":
[{"componentId":"site2","componentType":"component","status":"pass"},
{"componentId":"stal","componentType":"component","status":"pass"},
{"componentId":"test-site","componentType":"component","status":"pass"},
{"componentId":"site1-1","componentType":"component","status":"pass"},
{"componentId":"site99","componentType":"component","status":"pass"}
]}
}
Вид возвращаемого списка метрик:
# Версия портала «Агрегатор»
version_info{version="5.1"} 1.0
# Версия ОС
system_info{machine="x86_64",os="Linux 6.1.90-1-generic",version="#astra3+ci20 SMP PREEMPT_DYNAMIC Mon Jul 22 14:15:46 UTC 2024"} 1.0
# Период в секундах, в течение которого система функционирует без проблем
uptime_seconds 66686.97834658623
# Общая загрузка процессора в процентах
cpu_total_percent 4.8
# Общее использование физической памяти в процентах
virtual_memory_total_percent 40.5
# Количество операций чтения с диска
disk_read_count 68201.0
# Количество операций записи на диск
disk_write_count 729848.0
# Число прочитанных с диска байт
disk_read_bytes 2.094142464e+09
# Число записанных на диск байт
disk_write_bytes 7.54249728e+09
# Общий размер физической памяти в байтах
virtual_memory_total_bytes 4.117311488e+09
# Размер доступной физической памяти в байтах
virtual_memory_available_bytes 2.447736832e+09
# Размер используемой физической памяти в байтах
virtual_memory_used_bytes 1.303724032e+09
# Размер свободной физической памяти в байтах
virtual_memory_free_bytes 3.78679296e+08
# Общий размер диска в байтах
disk_total_bytes 1.5742214144e+010
# Используемый размер диска в байтах
disk_used_bytes 1.4512279552e+010
# Свободный размер диска в байтах
disk_free_bytes 4.07957504e+08
# Количество авторизованных пользователей в портале «Агрегатор пользователя»
user_session_count 1.0
# Количество авторизованных администраторов в портале «Агрегатор администратора»
admin_session_count 11.0
# Количество доменов аутентификации
auth_domain_count 4.0
# Количество ферм поставщиков ресурсов
# TYPE farms_count gauge
farms_count 4.0
# Количество узлов
servers_count 4.0
# Количество сайтов
sites_count 4.0
Доступные команды модуля «userinfo» портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд модуля «userinfo» портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Получение параметров брендирования |
|
PUT |
Обновление параметров брендирования |
|
GET |
Получение информации о пользователе |
Доступные команды модуля «webui» портала «Агрегатор»
Команды, связанные с объектами инфраструктуры
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с объектами инфраструктуры портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список объектов инфраструктуры («Порталов») |
|
DELETE |
Удаляет объект инфраструктуры («Порталов») |
|
PATCH |
Возвращает список метрик объектов инфраструктуры («Порталов») |
|
PATCH |
Возвращает список тегов объектов инфраструктуры («Порталов») |
|
GET |
Формирует файл экспорта объектов инфраструктуры («Порталов») |
|
POST |
Получает файл экспорта объектов инфраструктуры («Порталов») |
Команды, связанные с событиями аудита портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с событиями аудита портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список событий аудита |
|
GET |
Формирует файл экспорта событий аудита |
|
POST |
Получает файл экспорта событий аудита |
Команды, связанные с доменами аутентификации портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с доменами аутентификации портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список доменов аутентификации, добавленных на портал «Агрегатор» |
|
POST |
Создает домен аутентификации |
|
GET |
Возвращает список групп домена аутентификации |
|
POST |
Создает группу домена аутентификации |
|
GET |
Возвращает группу с идентификатором |
|
PUT |
Обновляет группу с идентификатором |
|
PATCH |
Обновляет группу с идентификатором |
|
DELETE |
Удаляет группу с идентификатором |
|
POST |
Удаляет все группы домена аутентификации с идентификатором |
|
GET |
Возвращает список групп из службы каталогов для домена аутентификации с идентификатором |
|
GET |
Возвращает список пользователей домена аутентификации |
|
POST |
Создает пользователя домена аутентификации |
|
GET |
Возвращает пользователя с идентификатором |
|
PUT |
Обновляет пользователя с идентификатором |
|
PATCH |
Обновляет пользователя с идентификатором |
|
DELETE |
Удаляет пользователя с идентификатором |
|
POST |
Удаляет всех пользователей домена аутентификации с идентификатором |
|
GET |
Возвращает домен аутентификации с идентификатором |
|
PUT |
Обновляет домен аутентификации с идентификатором |
|
PATCH |
Обновляет домен аутентификации с идентификатором |
|
DELETE |
Удаляет домен аутентификации с идентификатором |
|
PATCH |
Добавить, изменить или удалить атрибут домена для сохранения в учетной записи пользователя |
|
POST |
Удаляет домены аутентификации |
|
GET |
Возвращает описание для графического интерфейса домена аутентификации с типом |
|
POST |
Тестирует параметры домена аутентификации |
|
POST |
Тестирует параметры домена аутентификации |
|
GET |
Возвращает список доступных типов доменов аутентификации |
Команды, связанные с парметрами подключения к порталу «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с панелью мониторинга портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает информацию о сервере |
Команды, связанные с панелью мониторинга портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с панелью мониторинга портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Просмотр списка объектов панели мониторинга для «Агрегатора администратора» |
|
GET |
Просмотр списка объектов панели мониторинга для «Агрегатора пользователя» |
Команды, связанные с узлами «Универсального диспетчера» портала
«Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу [ПереченьURLкомандсвязанныхсузламиУниверсальногодиспетчерапорталаАгрегато]).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список узлов «Универсального диспетчера», добавленных на портал «Агрегатор» |
|
POST |
Добавляет узел «Универсального диспетчера» |
|
GET |
Возвращает узел «Универсального диспетчера» с идентификатором |
|
PUT |
Обновляет узел «Универсального диспетчера» с идентификатором |
|
PATCH |
Обновляет узел «Универсального диспетчера» с идентификатором |
|
DELETE |
Удаляет узел «Универсального диспетчера» с идентификатором |
|
POST |
Удаляет все узлы «Универсального диспетчера» |
Команды, связанные с фермами поставщиков ресурсов портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с фермами поставщиков ресурсов портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список ферм поставщиков ресурсов, добавленных на портал «Агрегатор» |
|
POST |
Создает ферму поставщиков ресурсов |
|
GET |
Возвращает ферму поставщиков ресурсов с идентификатором |
|
PUT |
Обновляет ферму поставщиков ресурсов с идентификатором |
|
PATCH |
Обновляет ферму поставщиков ресурсов с идентификатором |
|
DELETE |
Удаляет ферму поставщиков ресурсов с идентификатором |
|
GET |
Возвращает список узлов «Универсального диспетчера» для фермы с идентификатором |
|
GET |
Возвращает список тегов с узлов «Универсального диспетчера» для фермы с идентификатором |
|
POST |
Удаляет все фермы поставщиков ресурсов |
Команды, связанные с изображениями портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с изображением портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает изображение по идентификатору, либо для протокола доставки, либо установленное по умолчанию |
|
GET |
Возвращает изображение для протокола доставки |
Команды, связанные со шлюзами портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных со шлюзами портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список объектов («Шлюзов»), добавленных на портал «Агрегатор» |
|
POST |
Создает объект («Шлюз») |
|
GET |
Возвращает объект («Шлюз») с идентификатором |
|
PUT |
Обновляет объект («Шлюз») с идентификатором |
|
PATCH |
Обновляет объект («Шлюз») с идентификатором |
|
DELETE |
Удаляет объект («Шлюз») с идентификатором |
|
PATCH |
Удаляет все объекты («Шлюзы») |
Команды, связанные с шаблонами техобслуживания
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с шаблонами техобслуживания).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список шаблонов техобслуживания, добавленных на портал «Агрегатор» |
|
POST |
Создает шаблон техобслуживания |
|
GET |
Возвращает шаблон техобслуживания с идентификатором |
|
PUT |
Обновляет шаблон техобслуживания с идентификатором |
|
PATCH |
Обновляет шаблон техобслуживания с идентификатором |
|
DELETE |
Удаляет шаблон техобслуживания с идентификатором |
|
PATCH |
Удаляет шаблоны техобслуживания |
Команды, связанные с функциями мониторинга портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с функциями мониторинга портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Просмотр всех записей журнала в виде списка |
|
POST |
Добавляет запись в журнал |
|
GET |
Просмотр записи журнала с идентификатором |
|
PUT |
Обновляет запись журнала с идентификатором |
|
PATCH |
Обновляет запись журнала с идентификатором |
|
DELETE |
Удаляет запись журнала с идентификатором |
|
PATCH |
Удаляет все записи журнала |
|
GET |
Формирует файл экспорта событий журнала |
|
POST |
Получает файл экспорта событий журнала |
Команды, связанные с группами пользователей
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с группами пользователей портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список групп, добавленных на портал «Агрегатор» |
|
POST |
Создает группу |
|
GET |
Возвращает группу с идентификатором |
|
PUT |
Обновляет группу с идентификатором |
|
PATCH |
Обновляет группу с идентификатором |
|
DELETE |
Удаляет группу с идентификатором |
Команды, связанные с управлением полномочиями (ролями) портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с управлением полномочиями (ролями) портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список ролей, добавленных на портал «Агрегатор» |
|
POST |
Создает роль |
|
GET |
Возвращает роль с идентификатором |
|
PUT |
Обновляет роль с идентификатором |
|
PATCH |
Обновляет роль с идентификатором |
|
DELETE |
Удаляет роль с идентификатором |
|
GET |
Возвращает список доступных пользовательских разрешений |
Команды, связанные с объединенными наборами ресурсов сайтов портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с объединенными наборами ресурсов сайтов портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список объединенных наборов ресурсов, добавленных на портал «Агрегатор» |
|
POST |
Добавляет объединенный набор ресурсов |
|
GET |
Возвращает объединенный набор ресурсов с идентификатором |
|
PUT |
Обновляет объединенный набор ресурсов с идентификатором |
|
PATCH |
Обновляет объединенный набор ресурсов с идентификатором |
|
DELETE |
Удаляет объединенный набор ресурсов с идентификатором |
Команды, связанные с фондами РМ портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с фондами РМ портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список фондов РМ, добавленных на портал «Агрегатор» |
|
PATCH |
Управляет режимом техобслуживания фонда РМ |
|
PUT |
Обновляет фонд РМ |
|
GET |
Возвращает список политик для фонда РМ с идентификатором |
Команды, связанные с сайтами портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу [ПереченьURLкомандсвязанныхссайтамипорталаАгрегато]).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список сайтов, добавленных на портал «Агрегатор» |
|
POST |
Добавляет сайт |
|
GET |
Возвращает сайт с идентификатором |
|
PUT |
Обновляет сайт с идентификатором |
|
PATCH |
Обновляет сайт с идентификатором |
|
DELETE |
Удаляет сайт с идентификатором |
|
GET |
Способ предоставления всех ферм сайта с идентификатором |
|
GET |
Способ предоставления всех правил (объединенных наборов ресурсов) сайта с идентификатором |
|
POST |
Удаляет все сайты |
|
GET |
Способ получения пользователей и групп доменов аутентификации, доступных для добавления на сайт |
Команды, связанные с сессиями пользователей РМ портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с сессиями пользователей РМ портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список активных сессий пользователей РМ |
|
PATCH |
Отключает активную сессию пользователя РМ |
|
PATCH |
Завершает активную сессию пользователя РМ |
|
PATCH |
Генерация уникального URL для подключения к «Удаленному помощнику» |
Команды, связанные с тегами портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с тегами).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список тегов |
|
POST |
Создает тег |
|
GET |
Возвращает тег |
|
PUT |
Обновляет тег |
|
PATCH |
Управляет тегами |
|
DELETE |
Удаляет тег |
|
GET |
Формирует файл экспорта тегов |
|
POST |
Получает файл экспорта тегов |
Команды, связанные с системными параметрами портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с системными параметрами портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список системных параметров |
|
PUT |
Сохраняет параметры конфигурации |
Команды, связанные с управлением РМ портала «Агрегатор»
Доступные администратору URL-команды перечислены в таблице (см. таблицу Перечень URL-команд, связанных с управлением РМ портала «Агрегатор»).
| URL-команда | Тип | Описание |
|---|---|---|
|
GET |
Возвращает список РМ |
|
PATCH |
Назначает владельца РМ |
|
DELETE |
Удаляет РМ |
|
PATCH |
Управление состоянием РМ (ВМ) |
|
PATCH |
Управление режимом техобслуживания РМ |
|
POST |
Отправляет сообщение в РМ |
|
PATCH |
Возвращает ВМ на базовый снапшот |
|
PATCH |
Редактирует список тегов РМ |