Как пользоваться разделом «Провайдеры»

О чём этот раздел

Показывает provider endpoints, protocol/model/perimeter и health, от которых Router строит допустимые маршруты.

Перед началом

Нужны доступ к IAM.Router, правильный tenant/workspace и право изменять эту конфигурацию. Подготовьте безопасное тестовое значение, например openrouter-prod.

Кнопки и формы

Элемент	За что отвечает
Обновить	Повторно загружает данные с сервера, сохраняя контекст текущей страницы.
Добавить endpoint	Открывает создание объекта. До финального сохранения объект не записывается.
Проверить	Выполняет проверку или пробный запуск до использования в production.
Сохранить	Проверяет видимую форму и сохраняет текущие значения.

Поля формы

Поле	Безопасный пример	Правило ввода
`Имя`	`openrouter-prod`	Уникальный lowercase identifier без URL.
`Model ID`	`qwen/qwen3.7-flash`	Точное значение каталога провайдера.
`Perimeter`	`external`	Выберите реальную границу размещения, не уровень доверия.

Основной путь через интерфейс

Откройте приложение по ссылке выше и войдите с минимально необходимой для раздела ролью.
Выберите нужный tenant или workspace. Не продолжайте, если в шапке отображается другой контур.
В навигации нажмите Провайдеры. Ожидаемый адрес: https://app.iamrouter.ru/providers.
Нажмите Добавить endpoint. Введите документированные безопасные значения: Имя = openrouter-prod, Model ID = qwen/qwen3.7-flash, Perimeter = external. Production-секрет в текстовое поле не вставляйте.
Перед финальным действием Сохранить, Запустить, Опубликовать или Подтвердить перепроверьте все поля. Если есть preview или validation, сначала выполните его.
Проверьте сообщение валидации или изменившуюся строку. Результат должен соответствовать назначению раздела: Показывает provider endpoints, protocol/model/perimeter и health, от которых Router строит допустимые маршруты.
Только после этого переходите к зависимому разделу. Сохраните request/correlation ID, если интерфейс его показывает.

Второй путь: прямая ссылка и CLI/API

Откройте прямую ссылку https://app.iamrouter.ru/providers вместо перехода через sidebar.
После загрузки ещё раз проверьте tenant/workspace: прямая ссылка не должна незаметно менять scope.
Перед автоматизацией API-пути выполните продуктовую read-only команду или проверку. Она подтверждает доступность, но не обходит права приложения:

export IAM_ROUTER_URL=https://api.iamrouter.ru
export IAM_ROUTER_TOKEN='<token>'
curl --fail --silent --show-error "$IAM_ROUTER_URL/healthz"

Как проверить результат

Endpoint отображается healthy, model ID совпадает с провайдером, а credential хранится как secret reference.

Если не получилось

Симптом	Что делать
401 / экран входа	Войдите заново и вернитесь на страницу. Не передавайте session token через URL.
403	Проверьте выбранный tenant и запросите указанную роль; повтор с той же ролью не поможет.
404	Проверьте точный path и включён ли функционал в этом окружении.
409	Найдите объект с именем `openrouter-prod`; продолжите с ним либо выберите уникальное имя.
422 / ошибка валидации	Исправьте только подсвеченные поля. Используйте lowercase identifiers, если форма явно не разрешает иное.
429	Дождитесь указанного retry interval либо уменьшите scope запроса; не запускайте параллельные повторы.
5xx / timeout	После восстановления сервера обновите страницу один раз; не повторяйте опасное действие, пока его результат неизвестен. Сохраните correlation ID и время для поддержки.