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

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

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

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

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

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

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

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

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

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

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

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

Можно ли переместить экземпляр службы управления 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, включая функции, Logic Apps, контейнерные приложения и веб-приложения.

Существуют ли ограничения на импорт 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 будет принимать либо resourceresource/. Однако различие может иметь значение для внутреннего узла. Некоторые веб-серверы автоматически перенаправляют URL-адрес, не заканчивающийся косой чертой, на тот же URL-адрес, заканчивающийся косой чертой. Поскольку управление API является клиентом серверной части (сервер), автоматическое перенаправление не всегда желательно. При необходимости создайте политику переопределения URL-адресов , чтобы гарантировать, что косая черта всегда добавляется в исходящий внутренний вызов.

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

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

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

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

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