Привязки для вывода HTTP в Функциях Azure

Привязка для вывода HTTP используется для ответа отправителю запроса HTTP (триггеру HTTP). Эта привязка требует наличия триггера HTTP и позволяет настроить ответ на запрос этого триггера.

Возвращаемое по умолчанию значение для функции, активируемой по HTTP:

• HTTP 204 No Content с пустым телом в Функциях 2.x и более поздних версий;
• HTTP 200 OK с пустым телом в Функциях 1.x.

Атрибут

Изолированная рабочая модель

Атрибут возвращаемого значения не требуется при использовании HttpResponseData. Однако при использовании интеграции ASP.NET Core и выходных объектов[HttpResultAttribute] с несколькими привязками атрибут должен применяться к свойству объекта. Атрибут не принимает параметров. Дополнительные сведения см. в статье Использование.

Модель внутрипроцессного процесса

Внимание

Поддержка будет завершена для модели в процессе 10 ноября 2026 г. Настоятельно рекомендуется перенести приложения в изолированную рабочую модель для полной поддержки.

Атрибут возвращаемого значения не требуется для библиотеки классов. Вместо этого скрипт C# использует файл конфигурации function.json, как описано в руководстве по скриптам C#. Дополнительные сведения см. в статье Использование.

Заметки

В библиотеке среды выполнения функций Java используйте заметку HttpOutput для определения выходной переменной, отличной от переменной по умолчанию, возвращаемой функцией. Эта заметка поддерживает следующие параметры:

• dataType
• name

Внимание

В этой статье используются вкладки для поддержки нескольких версий модели программирования Node.js. Модель версии 4 общедоступна и предназначена для более гибкого и интуитивно понятного интерфейса для разработчиков JavaScript и TypeScript. Дополнительные сведения о том, как работает модель версии 4, см. в руководстве разработчика по Функции Azure Node.js. Дополнительные сведения о различиях между версиями 3 и 4 см. в руководстве по миграции.

Настройка

Модель версии 4

Объект, options переданный методу в output.http() настоящее время, не поддерживает какие-либо свойства для модели версии 4.

Модель версии 3

В следующей таблице описываются свойства конфигурации привязки, которые задаются в файле function.json.

Свойство	Описание
type	Должен иметь значениеhttp.
direction	Должен иметь значениеout.
name	Имя переменной, используемое в коде функции для ответа, или $return для использования возвращаемого значения.

Настройка

В следующей таблице описываются свойства конфигурации привязки, которые задаются в файле function.json.

Свойство	Описание
type	Должен иметь значениеhttp.
direction	Должен иметь значениеout.
name	Имя переменной, используемое в коде функции для ответа, или $return для использования возвращаемого значения.

Использование

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

В .NET тип ответа зависит от режима C#:

Изолированная рабочая модель

Функция с триггером HTTP возвращает объект одного из следующих типов:

• IActionResult¹ (или Task<IActionResult>)
• HttpResponse¹ (или Task<HttpResponse>)
• HttpResponseData (или Task<HttpResponseData>)
• Сериализуемые типы JSON, представляющие текст ответа для 200 OK ответа.

¹ Этот тип доступен только при использовании интеграции ASP.NET Core.

Если один из этих типов используется в составе выходных объектов с несколькими привязками, [HttpResult] атрибут должен применяться к свойству объекта. Атрибут не принимает параметров.

Модель внутрипроцессного процесса

Функция, запускаемая HTTP, возвращает тип IActionResult или Task<IActionResult>.

Для Java используйте httpResponseMessage.Builder для создания ответа триггеру HTTP. Дополнительные сведения см. в описании HttpRequestMessage и HttpResponseMessage.

Примеры ответов см. в разделе Примеры триггера.

Следующие шаги

• Выполнение функции из HTTP-запроса