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

  • Статья

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

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

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

Атрибут

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

Заметки

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

Внимание

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

Настройка

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

Настройка

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

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

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

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

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

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

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

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

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

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

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

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