Выполнение функции Azure с помощью HTTP-запроса
HTTP-запрос — это распространенная операция, выполняемая на большинстве платформ и устройств. Будь это запрос на поиск слова в словаре или запрос на отображение погодных условий, — мы всегда отправляем HTTP-запросы. Функции Azure позволяют быстро создавать часть логики, выполняемую при получении HTTP-запроса.
В этом уроке вы узнаете, как создать и вызвать функцию с помощью триггера HTTP. Вы также изучите некоторые доступные для триггеров HTTP параметры настройки.
Что такое триггер HTTP?
Триггер HTTP — это триггер, который выполняет код при получении HTTP-запроса. Триггеры HTTP поддерживают много возможностей и настроек, включая следующие:
- Предоставление авторизованного доступа путем предоставления ключей.
- Ограничение поддерживаемых HTTP-команд.
- Возврат данных обратно вызывающей стороне.
- Получение данных с помощью параметров строки запроса или по тексту запроса.
- Поддержка шаблонов маршрутов URL-адресов для изменения URL-адреса функции.
При создании триггера HTTP необходимо указать имя триггера и выбрать уровень авторизации.
Что такое уровень авторизации триггера HTTP?
Уровень авторизации триггера HTTP — это флаг, указывающий, требуется ли входящий HTTP-запрос ключ API для авторизации.
Существует три уровня авторизации:
- Function
- Анонимные
- Административный
Уровни Функция и Администратор работают на основе ключей. Чтобы отправить HTTP-запрос, необходимо указать ключ для авторизации. Существует два типа ключей: ключи функции и ключи узла. Эти ключи имеют различные области действия. Ключи функции применяются к конкретным функциям. Ключи узла применяются ко всем функциям в приложении-функции. Если задан уровень авторизации Функция, можно использовать либо ключ функции, либо ключ узла. Если задан уровень авторизации Администратор, необходимо указать ключ узла.
Внимание
Так как ключи узла обеспечивают повышенный доступ к приложению-функции, необходимо безопасно передавать и хранить их.
Анонимный уровень означает, что авторизация не требуется. В этом упражнении используется анонимный уровень авторизации.
Создание триггера HTTP
Как и триггер таймера, триггер HTTP можно создать на портале Azure. В функции Azure выберите триггер HTTP из списка предопределенных типов триггеров, затем введите логику, которую требуется выполнить, и внесите любые необходимые изменения, например, ограничьте использование определенных HTTP-команд.
Важно понимать один параметр — Имя параметра запроса. Этот параметр является строкой, представляющей имя параметра, который содержит сведения о входящем HTTP-запросе. Имя параметра по умолчанию — req.
Вызов триггера HTTP
Чтобы вызвать триггер HTTP, отправьте HTTP-запрос на URL-адрес функции. Чтобы получить этот URL-адрес, перейдите на страницу кода для функции и щелкните ссылку Получить URL-адрес функции.
Получив URL-адрес для функции, вы можете отправлять HTTP-запросы. Если функция получает данные, помните, что можно использовать параметры строки запроса или предоставлять данные через текст запроса.
Триггер HTTP выполняется при получении HTTP-запроса к URL-адресу функции. Триггеры HTTP позволяют получать данные, выполнять логику и при необходимости возвращать данные обратно вызывающему объекту.