Чтобы создать шлюз Shared API:
В личном кабинете перейдите в раздел Разработка → API Gateway.
В меню слева выберите Shared.
Нажмите Создать шлюз.
Отобразится окно создания шлюза.
По умолчанию шлюзу назначается системный адрес вида <uuid>.apigw.cloud.ru, где uuid — это идентификатор шлюза. Запросы, отправленные на этот адрес, будут обработаны шлюзом. Системный адрес не может быть удален.
Укажите название шлюза.
(Опционально) Добавьте описание шлюза.
Выберите шаблон шлюза.
Шаблон представляет собой набор полей для добавления правил и бэкендов для шлюза.
Шаблон Обратный прокси предназначен для трансляции клиентских запросов, направленных на публичный хост, на бэкенды (адреса сервисов), скрытые от клиента.
Нажмите Продолжить.
Задайте URI для проксирования.
Пример:
Системный адрес: https://bc8296eda9dc4f2ba3a301ac411a32d8.apigw.cloud.ru
URI для проксирования: /service1
Для отправки запросов к бэкенду через шлюз будет использоваться адрес https://bc8296eda9dc4f2ba3a301ac411a32d8.apigw.cloud.ru/service1.
Выберите тип бэкенда:
Общий бэкенд — доступен всем шлюзам внутри проекта для Shared API Gateway.
Частный бэкенд — будет указан для правила и недоступен другим шлюзам в группе или проекте, а также другим правилам.
Не выбран — бэкенд не выбран на этом этапе.
Политики «Mock API», «Авторизация» не требуют наличия бэкенда.
В зависимости от типа бэкенда:
Выберите общий бэкенд в списке Общий бэкенд или нажмите Создать общий бэкенд, чтобы перейти к созданию стандартного бэкенда.
Выберите Частный бэкенд.
Укажите адрес бэкенда или создайте частный бэкенд.
(Опционально) Если на предыдущем шаге вы выбрали создать общий бэкенд, выберите созданный общий бэкенд.
Укажите параметры логирования:
Логирование запросов — активируйте опцию, чтобы использовать cервис для записи логов запросов к шлюзу. Записи доступны в интерфейсе сервиса логирования. Использование сервиса не тарифицируется.
Лог-группа — это способ группировки логов. По умолчанию указана группа default. Оставьте значение по умолчанию или выберите пользовательскую группу, если она ранее была создана в сервисе логирования.
Нажмите Продолжить.
Автоматически будет создано правило с указанным URI для проксирования.
В мастере создания шлюза по умолчанию добавляется одно правило. После создания шлюза вы сможете добавить любое количество правил. Каждое правило описывает требования к обработке запросов, направленных на определенные пути в рамках шлюза.
(Опционально) Добавьте политики для правила.
Нажмите Создать.
Будет создан шлюз с одним активным правилом для всех HTTP-методов и добавленными политиками. Правило можно затем изменить.
Запросы по всем HTTP-методам, направленные на адрес шлюза по заданным URI для проксирования, будут перенаправлены на заданный бэкенд. К запросам будут применены заданные политики обработки запросов.
Для вызова используйте метод (например, «GET») и URL созданного API-шлюза, например — https://bc8296eda9dc4f2ba3a301ac411a32d8.apigw.cloud.ru/service1.
ПодсказкаВы можете просмотреть созданный общий бэкенд в Shared → Общие бэкенды.