Поделиться через

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

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

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

Если функция находится в предварительной версии, это означает, что мы активно запрашиваем отзывы о том, как эта функция работает для вас. Функция в предварительной версии полностью готова, но существенные изменения могут быть сделаны в ответ на отзывы клиентов. Мы не рекомендуем зависеть от функции, которая находится в предварительной версии в рабочей среде.

Как узнать об обновлениях и изменениях управления API?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Рекомендации по архитектуре см. в акселераторе целевой зоны управления API Azure.

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

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

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

Да.

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

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

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

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

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

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

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

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

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

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

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

Можно ли интегрировать управление API напрямую с решениями базы данных Azure?

Да, вы можете интегрировать управление API непосредственно с другими службами Azure без посредника. Например, API Management может интегрироваться непосредственно с REST-API Azure Cosmos DB для операций CRUD, устраняя необходимость в промежуточных службах, таких как Azure Functions.