Часто задаваемые вопросы о службе управления API Azure

  • Вопросы и ответы

Получите ответы на распространенные вопросы о Azure Управление API.

Что означает, если функция пребывает в предварительной версии?

Это значит, что мы активно изучаем отзывы пользователей о работе функции. Функция в предварительной версии фактически завершена, но, возможно, мы внесем важные изменения в ответ на отзывы клиентов. Мы рекомендуем не закладывать в основу рабочей среды функции в предварительной версии.

Разделы справки узнать об обновлениях и изменениях Управление API?

Подпишитесь на объявления об обновлении, опубликованные в следующих расположениях:

Как защитить подключение между шлюзом Управление API и внутренними службами?

Существует несколько вариантов защиты подключения между шлюзом Управление API и внутренними службами, в том числе:

Как скопировать экземпляр службы управления API в новый экземпляр?

Доступно несколько вариантов, включая следующие:

  • Используйте функцию резервного копирования и восстановления в Управлении API.
  • Создайте собственную функцию резервного копирования и восстановления с помощью REST API Управления API, чтобы сохранять и восстанавливать нужные объекты из экземпляра службы.
  • Скачайте файл конфигурации службы с помощью Git и отправьте его в новый экземпляр.

Можно ли переместить экземпляр Управление API из одной подписки в другую?

Да. Чтобы узнать, как это сделать, см. статью Перемещение ресурсов в новую группу ресурсов или подписку.

Можно ли управлять экземпляром службы "Управление API" программно?

Да, вы можете управлять Управление API программным способом с помощью различных средств, в том числе:

Как добавить пользователя в группу администраторов?

Группа Администратор istrators — это неизменяемая системная группа, которая включает администраторов подписок Azure. Вы не сможете добавить пользователя в эту группу. Дополнительные сведения см. в статье Как создавать и использовать группы для управления учетными записями разработчика в службе управления Azure API.

Почему политика, которую я хочу добавить, недоступна в редакторе политик?

Если политика, которую вы хотите добавить, отображается серой или затеняется в редакторе политик, убедитесь, что вы находитесь в правильной область для политики. Каждая инструкция политики предназначена для использования в определенных область и разделах политики. Чтобы просмотреть разделы политики и область для политики, см. раздел "Использование политики" в справочнике по политике.

Как настроить несколько сред в одном API?

Чтобы настроить несколько сред, например тестовую и рабочую, в одном API, используйте один из двух способов. Вы можете:

  • Размещение разных API-интерфейсов в одном экземпляре Управление API.
  • Размещение одних и тех же API в разных экземплярах.

Поддерживает ли Управление API только серверные серверы REST API?

Управление API поддерживает ИНТЕРФЕЙСы REST API, а также сквозное руководство.API SOAP, WebSocket и GraphQL. Управление API также поддерживает искусственные API GraphQL.

Управление API также интегрируется с предложениями вычислений Azure, которые часто используются для создания и размещения API в Azure, включая Функции, Logic Apps, контейнерные приложения и веб-приложения.

Существуют ли ограничения на импорт API?

См . ограничения импорта API и известные проблемы для форматов OpenAPI (Swagger), WSDL и WADL.

Можно ли использовать CI/CD для разработки API?

Да. Дополнительные сведения см. в статье Об использовании DevOps и CI/CD для публикации API.

Инструкции по архитектуре см. в статье azure Управление API акселератор целевой зоны.

Какой метод маршрутизации использует служба управления API при развертывании в нескольких географических расположениях?

Управление API использует метод маршрутизации трафика производительности (наименьшая задержка) в развертываниях в нескольких географических расположениях. Дополнительные сведения см. в статье "Развертывание экземпляра Azure Управление API в нескольких регионах Azure".

Работает ли управление API с Azure ExpressRoute?

Да.

Какой минимальный размер подсети необходим при развертывании Управление API в виртуальной сети?

Минимальный размер подсети, необходимый для развертывания Управление API, — /29. Дополнительные сведения об использовании Управление API в виртуальных сетях.

Предоставляет ли Управление API брандмауэр веб-приложения (WAF)?

Хотя Управление API не включает компонент WAF, рекомендуется развернуть вышестоящий WAF (перед экземпляром Управление API). Например, используйте Шлюз приложений Azure или Azure Front Door.

Каковы различия между управляемым шлюзом и локальным шлюзом?

Дополнительные сведения см. в Управление API шлюзе API и обзоре локального шлюза.

Как Управление API обрабатывает конечные косые черты при вызове внутренних служб?

Исторически и по соглашению URL-адрес, заканчивающийся конечным косой чертой, рассматривается как каталог, например https://contoso.com/sample/ тот же URL-адрес без конечной косой черты https://contoso.com/sample указывает файл. Это не обязательно; некоторые системы считают эти два уникальных URL-адреса, другие считают их одинаковыми. Управление API не имеет различия, поэтому одна операция resource будет принимать либоresource.resource/ Однако различие может иметь значение для внутреннего узла. Некоторые веб-серверы автоматически перенаправляют URL-адрес, не заканчивающийся косой чертой, на тот же URL-адрес, заканчивающийся косой чертой. Так как Управление API является клиентом серверной части (сервер), автоматическое перенаправление не всегда желательно. При необходимости создайте политику переопределения URL-адресов, чтобы гарантировать, что косая черта всегда добавляется в исходящий внутренний вызов.

Можно ли изменить имя API Управление API?

Нет, вы не можете изменить имя (или идентификатор) API в Azure Управление API после его создания. Однако отображаемое имя можно изменить.

При клонировании API новый экземпляр создается с системным значением для имени, которое невозможно изменить. Чтобы указать имя API, вручную создайте новый API и импортируйте определение API. Дополнительные сведения см. в разделе "Импорт API".