Выполнение функции Azure с помощью HTTP-запроса

  • 10 мин

HTTP-запрос — это распространенная операция, выполняемая на большинстве платформ и устройств. Будь это запрос на поиск слова в словаре или запрос на отображение погодных условий, — мы всегда отправляем HTTP-запросы. Функции Azure позволяют быстро создавать часть логики, выполняемую при получении HTTP-запроса.

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

Что такое триггер HTTP?

Триггер HTTP — это триггер, который выполняет код при получении HTTP-запроса. Триггеры HTTP поддерживают много возможностей и настроек, включая следующие:

  • Предоставление авторизованного доступа путем предоставления ключей.
  • Ограничение поддерживаемых HTTP-команд.
  • Возврат данных обратно вызывающей стороне.
  • Получение данных с помощью параметров строки запроса или по тексту запроса.
  • Поддержка шаблонов маршрутов URL-адресов для изменения URL-адреса функции.

При создании триггера HTTP необходимо указать имя триггера и выбрать уровень авторизации.

Что такое уровень авторизации триггера HTTP?

Уровень авторизации триггера HTTP — это флаг, указывающий, требуется ли входящий HTTP-запрос ключ API для авторизации.

Существует три уровня авторизации:

  1. Функция
  2. Анонимные
  3. Администрирование

Уровни Функция и Администратор работают на основе ключей. Чтобы отправить HTTP-запрос, необходимо указать ключ для авторизации. Существует два типа ключей: ключи функции и ключи узла. Эти ключи имеют различные области действия. Ключи функции применяются к конкретным функциям. Ключи узла применяются ко всем функциям в приложении-функции. Если задан уровень авторизации Функция, можно использовать либо ключ функции, либо ключ узла. Если задан уровень авторизации Администратор, необходимо указать ключ узла.

Важно!

Так как ключи узла обеспечивают повышенный доступ к приложению-функции, необходимо безопасно передавать и хранить их.

Анонимный уровень означает, что авторизация не требуется. В этом упражнении используется анонимный уровень авторизации.

Создание триггера HTTP

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

Важно понимать один параметр — Имя параметра запроса. Этот параметр является строкой, представляющей имя параметра, который содержит сведения о входящем HTTP-запросе. Имя параметра по умолчанию — req.

Вызов триггера HTTP

Чтобы вызвать триггер HTTP, отправьте HTTP-запрос на URL-адрес функции. Чтобы получить этот URL-адрес, перейдите на страницу кода для функции и щелкните ссылку Получить URL-адрес функции.

Screenshot of the Azure portal showing a Functions App pane with the app's Get function URL button highlighted.

Получив URL-адрес для функции, вы можете отправлять HTTP-запросы. Если функция получает данные, помните, что можно использовать параметры строки запроса или предоставлять данные через текст запроса.

Триггер HTTP выполняется при получении HTTP-запроса к URL-адресу функции. Триггеры HTTP позволяют получать данные, выполнять логику и при необходимости возвращать данные обратно вызывающему объекту.