Associações de saída HTTP do Azure Functions

Use a associação de saída HTTP para responder ao remetente da solicitação HTTP (gatilho HTTP). Essa associação exige um gatilho HTTP e permite que você personalize a resposta associada à solicitação do gatilho.

O valor de retorno padrão para uma função disparada por HTTP é:

• HTTP 204 No Content com um corpo vazio no Functions 2.x e superior
• HTTP 200 OK com um corpo vazio no Functions 1.x

Atributo

Modelo de trabalho isolado

Um atributo de valor retornado não é necessário ao usar HttpResponseData. No entanto, ao usar uma integração ASP.NET Core e objetos de saída de várias ligações, o [HttpResultAttribute] atributo deve ser aplicado à propriedade do objeto. O atributo não usa parâmetros. Para saber mais, confira Uso.

Modelo em processo

Importante

O suporte terminará para o modelo em processo em 10 de novembro de 2026. É altamente recomendável migrar seus aplicativos para o modelo de trabalho isolado para obter suporte completo.

Um atributo de valor retornado não é necessário para uma biblioteca de classes. Em vez disso, o script C# usa um arquivo de configuração function.json, conforme descrito no guia do script C# . Para saber mais, confira Uso.

Anotações

Na biblioteca de runtime de funções Java, use a anotação HttpOutput para definir uma variável de saída diferente da variável padrão retornada pela função. Essa anotação dá suporte às seguintes configurações:

• dataType
• name

Importante

Este artigo usa guias para dar suporte a várias versões do modelo de programação Node.js. O modelo v4 normalmente está disponível e foi projetado para oferecer uma experiência mais flexível e intuitiva para desenvolvedores de JavaScript e TypeScript. Para obter mais detalhes sobre como funciona o modelo v4, consulte o Guia do desenvolvedor do Node.js para o Azure Functions. Para conhecer as diferenças entre a v3 e a v4, veja o guia de migração.

Configuração

Modelo v4

Atualmente, o objeto options transmitido para o método output.http() não dá suporte a nenhuma propriedade do modelo v4.

Modelo v3

A tabela a seguir explica as propriedades de configuração de associação que você define no arquivo function.json.

Propriedade	Descrição
tipo	Deve ser definido como http.
direction	Deve ser definido como out.
name	O nome da variável usada no código de função para a resposta, ou $return para usar o valor de retorno.

Configuração

A tabela a seguir explica as propriedades de configuração de associação que você define no arquivo function.json.

Propriedade	Descrição
tipo	Deve ser definido como http.
direction	Deve ser definido como out.
name	O nome da variável usada no código de função para a resposta, ou $return para usar o valor de retorno.

Uso

Para enviar uma resposta HTTP, use os padrões de resposta padrão do idioma.

No .NET, o tipo de resposta depende do modo C#:

Modelo de trabalho isolado

A função acionada por HTTP retorna um objeto de um dos seguintes tipos:

• IActionResult¹ (ou Task<IActionResult>)
• Resposta Http¹ (ou Task<HttpResponse>)
• HttpResponseData (ou Task<HttpResponseData>)
• Tipos serializáveis JSON que representam o corpo da resposta para uma 200 OK resposta.

1 Esse tipo só está disponível ao usar ASP.NET integração principal.

Quando um desses tipos é usado como parte de objetos de saída de várias associações, o [HttpResult] atributo deve ser aplicado à propriedade do objeto. O atributo não usa parâmetros.

Modelo em processo

A função disparada por HTTP retorna um tipo de IActionResult ou Task<IActionResult>.

Para Java, use um HttpResponseMessage.Builder para criar uma resposta ao gatilho HTTP. Para saber mais, confira HttpRequestMessage e HttpResponseMessage.

Por ver exemplos de respostas, confira o exemplo de gatilho.

Próximas etapas

• Executar uma função de uma solicitação HTTP