tocdepth

2

Быстрый старт

В рамках быстрого старта рассмотрен пример создания и настройки шлюза API с помощью сервиса API Gateway. В качестве исходного хоста используется внешний HTTP-ресурс.

  1. В личном кабинете перейдите в раздел Разное → API Gateway.

  2. Нажмите Создать API-шлюз.

  3. Введите имя и краткое описание шлюза API.

  4. Нажмите Создать.

    После создания карточка шлюза будет доступна в рабочей области. Шлюзу назначается адрес. Запросы, отправленные на этот адрес, будут обработаны шлюзом.

  5. Перейдите в созданный шлюз.

  6. Откройте вкладку Подключения и нажмите Создать подключение.

  7. Задайте обязательные параметры подключения.

    • Название — пользовательское название подключения. Используется для указания точки маршрутизации запросов.

    • Протокол — протокол, по которому осуществляется подключение к целевым хостам.

    • Адрес подключения — доменное имя целевого хоста или IP-адрес подключения.

  8. Нажмите Создать.

  9. Перейдите на вкладку Правила и нажмите Создать правило.

    Подсказка

    Каждому шлюзу можно назначить произвольное количество правил, которые описывают требования к обработке запросов, направленных на определенные пути в рамках шлюза. Каждому правилу можно задать произвольное количество URI, а также обогатить правило подключением плагинов — дополнительных настроек, модифицирующих правила обработки запросов по данным путям.

    Создание правила состоит из шагов:

    1. Выбор правила.

      • Укажите Название правила.

      • Выберите Тип правила, например — «Маршрутизация запросов». Тип правила определяет основные функциональные возможности правила.

      Нажмите Продолжить.

    2. Параметры правила.

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

      • HTTP-методы — методы, запросы по которым будут обработаны данным правилом.

      • Подключение, содержащее целевой хост, на который будут перенаправлены запросы.

      • URI бэкенда, на который будут перенаправлены запросы.

      • Список URI для proxy, запросы на которые будут обработаны данным правилом. Поддерживаются Wildcard-символ (*) для замещения любой части URI.

      Нажмите Продолжить.

    3. Настройка плагинов.

      В рамках быстрого старта этот опциональный шаг пропускается.

      Нажмите Создать.

    Созданное правило появится в разделе Правила.

  10. Активируйте правило, нажав на переключатель в разделе Статус.

После публикации правила запросы по указанным HTTP-методам, направленные на адрес шлюза по заданным URI, будут перенаправлены на целевой хост. При необходимости можно создать дополнительные правила для расширения логики работы API шлюза.

Для вызова используйте метод (например, «GET») и URL созданного API, например — https://bc8296eda9dc4f2ba3a301ac411a32d8.apigw.sbercloud.ru/route1.

Запустили Evolution free tier
для Dev & Test
Получить