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

Развертывание и вызов пользовательских API из рабочих процессов в Azure Logic Apps

  • Статья

Область применения: Azure Logic Apps (потребление)

После создания собственных API для использования в рабочих процессах приложения логики необходимо развернуть эти API, прежде чем их можно будет вызывать. API-интерфейсы можно развернуть в качестве веб-приложений, но лучше их развернуть в качестве приложений API, что облегчит создание, размещение и использование API-интерфейсов как в облаке, так и в локальной среде. Не нужно изменять код в API-интерфейсах, просто разверните свой код в приложении API. API-интерфейсы можно разместить в службе приложений Azure. Это служба PaaS (платформа как услуга), предоставляющая удобное размещение API с высоким уровнем масштабирования.

Хотя из рабочего процесса приложения логики можно вызвать любой API, для получения наилучших результатов добавьте метаданные Swagger, которые описывают операции и параметры вашего API. Данный документ Swagger позволяет упростить интеграцию API и улучшить его работу с рабочими процессами приложений логики.

Развертывание API в качестве веб-приложения или приложения API

Прежде чем вызвать настраиваемый API из рабочего процесса приложения логики, разверните его в качестве веб-приложения или приложения API в Службе приложений Azure. Задайте свойства определения API и включите общий доступ к ресурсам независимо от источника (CORS) для веб-приложения или приложения API, чтобы рабочий процесс мог считать документ Swagger.

  1. На портале Azure выберите веб-приложение или приложение API.

  2. В открывшемся меню приложения в разделе API выберите Определение API. Задайте в качестве значения параметра Расположение определения API URL-адрес файла swagger.json.

    Как правило, URL-адрес отображается в таком формате: https://{name}.azurewebsites.net/swagger/docs/v1)

    Снимок экрана: портал Azure с открытой областью

  3. В разделе API выберите CORS. Задайте для параметра Разрешенные источники политики CORS значение "*" (разрешить все).

    Этот параметр разрешает запросы от конструктора рабочих процессов.

    Снимок экрана: область CORS веб-приложения с параметром

Дополнительные сведения см. в статье Размещение API-интерфейсов RESTful с поддержкой CORS в Службе приложений Azure.

Вызов настраиваемого API из рабочих процессов приложения логики

После настройки CORS и свойств определения API триггеры и действия в пользовательском API должны быть доступны, чтобы вы могли включить их в рабочий процесс приложения логики.

  • Чтобы просмотреть веб-сайты с URL-адресами OpenAPI, просмотрите веб-сайты, относящиеся к вашей подписке, в конструкторе рабочего процесса.

  • Чтобы просмотреть доступные действия и входные данные, указав документ Swagger, используйте действие HTTP и Swagger.

  • Чтобы вызвать любой API, даже тот, который не имеет документа Swagger или не предоставляет его, всегда можно создать запрос с помощью действия HTTP.

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