Предоставление бессерверных API-интерфейсов из конечных точек HTTP с помощью управления API Azure

  • Статья

Функции Azure интегрируются с Azure API Management на портале, чтобы вы могли предоставлять конечные точки функций триггеров HTTP как REST API. Данные API описаны с использованием определения OpenAPI. Данный файл JSON (или YAML) содержит информацию о том, какие операции доступны в API. Файл включает подробную информацию о том, как должны быть структурированы данные запроса и ответа для API. Интегрируя свое приложение-функцию, вы можете заставить API Management генерировать данные определения OpenAPI.

В данной статье показано, как интегрировать приложение-функцию с API Management. Данная интеграция работает для приложений-функций, разработанных на любом поддерживаемом языке. Вы также можете импортировать приложение-функцию из Azure API Management.

Для функций библиотеки классов C# вы также можете использовать Visual Studio для создания и публикации бессерверного API, интегрированного с API Management.

Создание экземпляра управления API

Для создания экземпляра управления API, связанного с вашим приложением-функцией, выполните следующие действия:

  1. Выберите приложение-функцию, затем щелкните Управление API в меню слева и выберите Создать в разделе Управление API.

    Выбор раздела

  2. В разделе "Управление API" настройте параметры, как указано в следующей таблице:

    Параметр Рекомендуемое значение Описание
    имя; Глобально уникальное имя Имя создается на основе имени приложения-функции.
    Подписка Ваша подписка Подписка, в которой создан ресурс.
    Группа ресурсов myResourceGroup Та же группа, в которую входит ваше приложение-функция. Значение должно быть установлено.
    Расположение Расположение службы Подумайте о том, чтобы выбрать то же место, что и ваше приложение-функция.
    Название организации Contoso Название организации, используемое на портале разработчика и для уведомлений по электронной почте.
    Адрес электронной почты администратора Ваш адрес электронной почты Адрес электронной почты, на которую отправляются системные уведомления от службы "Управление API".
    Ценовая категория Потребление Уровень потребления доступен не во всех регионах. Подробные сведения о ценах на Управление API см. на этой странице.

    Создание службы

  3. Щелкните Экспорт, чтобы создать экземпляр Управления API. Этот процесс может занять несколько минут.

  4. После создания экземпляра Azure открывает на этой странице параметр Включить Application Insights. Выберите данный параметр для отправки журналов в то же место, что и приложение-функция.

Функции импорта

После создания экземпляра управления API вы можете импортировать конечные точки функции, запускаемой HTTP. В данном примере импортируется конечная точка с именем TurbineRepair.

  1. На странице управления API выберите Link API.

  2. Откроется страница Импорт функций Azure с выделенной функцией TurbineRepair. Нажмите кнопку Выбрать, чтобы продолжить.

    Импорт Функций Azure в Управление API

  3. На странице Создание из приложения-функции подтвердите значения по умолчанию и щелкните Создать.

    Создание из приложения-функции

    Azure создаст API для выбранной функции.

Скачивание определения OpenAPI

После того, как ваши функции были импортированы, вы можете загрузить определение OpenAPI из экземпляра управления API.

  1. Выберите Скачать определение OpenAPI в верхней части страницы.

    Скачивание определения OpenAPI

  2. Сохраните скачанный JSON-файл и откройте его в любом редакторе. Изучите определение.

Дальнейшие действия

Теперь вы можете уточнить определение в API Management на портале. См. дополнительные сведения о службе "Управление API".

Изменение определения OpenAPI в службе "Управление API"