# Инструменты

> Данный функционал доступен начиная с версии брокера 3.6.

Раздел "Инструменты" доступен в меню пользователя (только для учетных записей с ролью *Администратор*):

<figure><img src="https://2603182569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6-oafU4c2bTrhoNggH%2Fuploads%2FQtDptEitkuKDSuODumQT%2Ftools-1.png?alt=media&#x26;token=10a53022-e640-4eb3-8072-2f619a81fce2" alt=""><figcaption></figcaption></figure>

## Журналы <a href="#logs" id="logs"></a>

Здесь отображается перечень доступных для загрузки журналов брокера.

Вы можете скачать их по отдельности, нажав на иконку загрузки рядом с нужным файлом, либо архив всех журналов целиком, нажав на кнопку "Скачать все".

<figure><img src="https://2603182569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6-oafU4c2bTrhoNggH%2Fuploads%2FXSphg7z6aGDWXJXCTlEP%2Ftools-2.png?alt=media&#x26;token=e37efd17-0de3-4aa8-be35-eae5bcf07a70" alt=""><figcaption></figcaption></figure>

## REST API Обозреватель <a href="#rest-api-explorer" id="rest-api-explorer"></a>

Обозреватель позволяет выполнять запросы к REST API брокера прямо из браузера.

> Дополнительную информацию вы можете узнать в [Руководстве по REST API](https://kb.pvhostvm.ru/hostvm-vdi/rest-api-guide)

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

Чтобы создать запрос вручную:

* выберите HTTP метод;
* задайте Url;
* при выборе PUT или POST метода запроса укажите параметры тела запроса в появившейся форме;
* нажмите кнопку "Запрос".

После выполнения запроса вы увидите код состояния HTTP-ответа и сам ответ сервера.

<figure><img src="https://2603182569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6-oafU4c2bTrhoNggH%2Fuploads%2F1oU19Ywj7w2VLOlXnegF%2Ftools-3.png?alt=media&#x26;token=6c01cf1a-c250-4ad5-bb97-b01dfea9a46e" alt=""><figcaption></figcaption></figure>

Шаблоны запросов разделены на тематические блоки. Раскройте нужный блок и выберите запрос из появившегося списка.

При нажатии на знак вопроса появится дополнительная информация с описанием запроса, а также параметров path и тела запроса (при наличии).

<figure><img src="https://2603182569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6-oafU4c2bTrhoNggH%2Fuploads%2FRE0z0itDgnlHIcLQyjzO%2Ftools-4.png?alt=media&#x26;token=2e1487dc-7700-40d5-a268-4ba5f09c90c3" alt=""><figcaption></figcaption></figure>

Чтобы создать запрос из шаблона:

* нажмите на нужный шаблон, данные из него подставятся в форму запроса;
* задайте нужные значения для параметров path и тела запроса (при наличии);
* нажмите кнопку "Запрос".

Для некоторых запросов, помимо кода состояния HTTP-ответа и полного ответ сервера будет доступно поле "Обзор" с перечнем найденных элементов в сокращенном формате (имя и id). Id элемента можно скопировать, нажав на иконку рядом, и использовать для дальнейших запросов.

<figure><img src="https://2603182569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6-oafU4c2bTrhoNggH%2Fuploads%2FkhogZGfkFcP6fagRTRdl%2Ftools-5.png?alt=media&#x26;token=4b4fc427-47bf-48d3-ae8f-5799c23f88ed" alt=""><figcaption></figcaption></figure>

## Управление сервисами <a href="#service-management" id="service-management"></a>

Здесь отображается перечень доступных сервис-пулов, с информацией о назначенных пользователям сервисах.

> Кнопка "Сбросить" активна только для типов сервисов, поддерживающих сброс.

> Для управления сеансами пользователей на терминальных серверах сервис-провайдера RDS требуется [установка и настройка агента RDS](https://kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-installation-guide/actor/rds-actor).

Вы можете перезапустить виртуальную машину или сбросить сессию пользователя, для этого выберите и откройте нужный пул, отметьте один или несколько (с помощью Shift или Ctrl) элементов из списка и нажмите кнопку "Сбросить":

<figure><img src="https://2603182569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6-oafU4c2bTrhoNggH%2Fuploads%2FPfdIvMWUnx3flVp39HGD%2Ftools-7.png?alt=media&#x26;token=e00eb466-94ac-481a-b6f0-38ec1685d894" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2603182569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6-oafU4c2bTrhoNggH%2Fuploads%2FoNYxHEQlS4uIXQnyZJ9T%2Ftools-8.png?alt=media&#x26;token=e306e973-6399-474b-9be9-f39b993d836a" alt=""><figcaption></figcaption></figure>

### Разрешения <a href="#permissions" id="permissions"></a>

Вы можете предоставить доступ к управлению сервисами учетным записям с ролью "Оператор" с помощью разрешений.

{% hint style="warning" %}
Настройки доступа синхронизированы с соответствующими разрешениями для сервис-пулов в Панели управления.
{% endhint %}

Для этого отметьте нужный пул, нажмите кнопку "Разрешения" и добавьте учетную запись или группу с нужным уровнем доступа:

* Чтение: просмотр сервисов пула;
* Управление: просмотр и сброс сервисов пула.

## RDS агент <a href="#rds-actor" id="rds-actor"></a>

Здесь отображается перечень зарегистрированных в системе токенов RDS агентов:

`Провайдер` - сервис-провайдер RDS \ Linux Terminal, для которого зарегистрирован токен;

`Токен` - токен агента;

`Дата` - дата создания токена.

> Создание токенов доступно только для [сервис-провайдеров RDS \ Linux Terminal](https://kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/service-providers/rds-linux-terminal).

Чтобы создать токен для провайдера, нажмите `Новый`, выберите провайдер из списка доступных, нажмите `Сохранить`.

> Для каждого экземпляра провайдера, созданного в системе, можно зарегистрировать только один токен.

Если токен уже существует, при попытке сохранения новый токен создан не будет. Если вам необходимо пересоздать токен для провайдера, выберите уже существующий из списка, нажмите `Удалить` и подтвердите удаление. Затем создайте новый токен.

Чтобы скопировать значение токена в буфер обмена, нажмите на нем правой кнопкой мыши для открытия контекстного меню, и выберите пункт `Копировать`.