nav-img
Advanced

Миграция Shared Gateway на Dedicated Gateway

30 августа 2025 года общие шлюзы, тип Shared, станут недоступны, а их API-ресурсы удалятся. Если вы используете общие шлюзы, необходимо подать заявку на перенос ресурсов на выделенные шлюзы, тип Dedicated, и переключить трафик.

Шаг 1. Проверьте общий шлюз

Узнайте возможна ли миграция и определите какая спецификация выделенного шлюза потребуется.

  • Проверьте авторизованные приложения:

    1. В списке сервисов выберите Dedicated API Gateway.

    2. В правом верхнем углу нажмите Access Shared Gateway.

    3. В консоли управления API Gateway, на панели слева выберите API Publishing → APIs.

    4. Нажмите на название нужного API в списке.

    5. Перейдите на вкладку Authorization и убедитесь, что в списке только ваши приложения.

      Если в списке есть сторонние приложения, укажите это в заявке на миграцию.

  • Проверьте тип канала VPC:

    1. Вернитесь в консоль управления API Gateway, нажав на APIs в левом верхнем углу.

    2. На панели слева выберите API Publishing → VPC Channels.

      Если в списке есть каналы VPC, для которых в столбце Type указан тип ELB channel, укажите это в заявке на миграцию.

  • Проверьте группы API, созданные сервисом DataArts Studio.

    На панели слева выберите API Publishing → API Groups.

    Если в списке есть группы, название которых начинается с dlm_default_, а описание содержит default api group created by dlm, то такие ресурсы нужно мигрировать через сервис DataArts Studio (en).

  • Определите необходимую спецификацию выделенного шлюза исходя из метрик.

    1. На панели слева выберите API Publishing → APIs.

    2. Нажмите на название нужного API в списке.

    3. На вкладке Dashboard найдите метрику Requests (count) и определите максимальное количество запросов к API в секунду.

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

Шаг 2. Создайте выделенный шлюз

  1. В списке сервисов выберите Dedicated API Gateway.

  2. В правом верхнем углу нажмите Buy Dedicated Gateway.

  3. Укажите параметры выделенного шлюза (en).

  4. Нажмите Next, проверьте конфигурацию и нажмите Pay Now.

Шаг 3. Подайте заявку на миграцию

Создайте заявку в техническую поддержку на миграцию ресурсов из общего шлюза в выделенный. В заявке укажите:

Шаг 4. Переадресуйте трафик

После завершения миграции проверьте работоспособность ресурсов и переключите трафик на новый шлюз.

  1. Выполните отладку API (en) на выделенном шлюзе и/или отправьте API-запрос (en).

  2. Переключите трафик независимого домена на новый шлюз:

    • Для доступа через публичную сеть или приватную сеть в том же VPC, в записи CNAME кастомного доменного имени укажите домен выделенного шлюза {id}.apicapis.ru-moscow-1.hc.sbercloud.ru.

    • Для доступа через приватную сеть между VPC, установите сетевое соединение между VPC (en) и в записи CNAME кастомного доменного имени укажите доменное имя VPC-эндпоинта, который вы создали.

На что может повлиять миграция

  • Публичный входящий и исходящий доступ

    Выделенные шлюзы имеют разные публичные IP-адреса для входящего и исходящего трафика, и они отличаются от адресов общего шлюза. Если у вас настроены политики безопасности для сервера и клиента, в них необходимо разрешить доступ к новым IP-адресам.

  • Приватный входящий и исходящий доступ

    Каждый выделенный шлюз имеет входящий приватный IP-адрес и несколько исходящих приватных IP-адресов в пределах VPC. Поэтому для подключения серверов и клиентов необходимо внести изменения в политики сетевой безопасности.

  • Домен для отладки

    Доменное имя группы для отладки {group-id}.apig.ru-moscow-1.hc.sbercloud.ru после миграции меняется на {group-id}.apicapis.ru-moscow-1.hc.sbercloud.ru. Если на этот домен отправляются API-запросы, их потребуется изменить.