Swagger UI

В этом разделе описано, как пользоваться доступными API-методами Платформы с помощью Swagger UI:

Подготовка — инструкция авторизации в Swagger UI.
Использование — алгоритм использования API-методов.
Основные параметры — инструкция получения параметров для использования API-методов.

Чтобы открыть страницу документации в Swagger, нажмите на значок пользователя → «Swagger API».

Подготовка

Чтобы воспользоваться API-методами, необходимо авторизоваться через Swagger UI:

Создайте токен нужного вам типа в зависимости от API-методов, которые будете использовать, или используйте существующий токен:

токен типа установка нужен для использования метода, связанного с Агентом;

токен типа метрики нужен для использования методов, связанны с метриками;

токен типа датасеты нужен для использования методов, связанных с датасетами;

токен типа публичное API нужен для использования всех остальных API-методов.

Нажмите на кнопку «Authorize» («Авторизоваться»).

В поле «Value» появившегося модального окна вставьте ключ и нажмите на кнопку «Authorize».

Использование

Алгоритм использования API-методов через Swagger UI:

Кликните на стрелочку или любой другой элемент строки конкретного API-метода, чтобы его развернуть.

Нажмите на кнопку «Try it out» (цифра 1 на рисунке ниже).

Введите параметры (цифра 2 на рисунке выше), если они требуются. Чтобы воспользоваться API-методом, требующим ввода параметров, достаточно заполнить обязательные поля, помеченные красным словом «required».

Кликните на кнопку «Execute».

Если полученный код ответа соответствует коду из примера, запрос выполнился успешно.

Основные параметры

workspaceCode

Подробнее

Код рабочего пространства можно получить, воспользовавшись API-методом получения всех рабочих пространств данного тенанта.

В ответе запроса придёт вся информация о рабочих пространствах данного тенанта, в том числе их код.

instanceKey

Подробнее

Ключ экземпляра БД можно получить, воспользовавшись API-методом получения всех экземпляров данного рабочего пространства.

В ответе запроса придёт вся информация об экземплярах данного рабочего пространства, в том числе их ключ.

clusterKey

Подробнее

Ключ кластера можно получить, воспользовавшись API-методом получения всех кластеров данного рабочего пространства.

В ответе запроса придёт вся информация о кластерах данного рабочего пространства, в том числе их ключ.

integrationMetricType

Подробнее

integrationMetricType - это название системы мониторинга, с помощью которой вам нужно вывести метрики. На данный момент у Платформы две таких интеграции:

prometheus
zabbix

dbName

Подробнее

Имя базы данных можно получить, воспользовавшись API-методом получения всех БД данного экземпляра.

В ответе запроса придёт вся информация о БД данного экземпляра, в том числе их названия.

groupId

Подробнее

ID группы находится на странице всех групп данного тенанта в столбце «ИД группы».

userId

Подробнее

ID пользователя можно получить двумя способами:

Зайдя на страницу пользователей данного тенанта. Данный параметр находится в столбце «ИД пользователя».

Воспользовавшись API-методом получения всех пользователей данной группы по её ID.

В ответе запроса придёт вся информация о пользователях данной группы, в том числе их ID.

userProps

Подробнее

Этот параметр включает в себя два поля:

languageCode - локаль пользователя («ru» или «en»).

timeZone - часовой пояс пользователя в формате «Континент/регион» (например, «Europe/Moscow»).

ownerID

Подробнее

ID Владельца тенанта это ID пользователя, которому даны права Владельца тенанта. Его можно получить, воспользовавшись API-методом получения всех Владельцев данного тенанта.

В ответе запроса придёт вся информация о Владельцах данного тенанта, в том числе их ID.