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

Use a ligação de saída HTTP para responder ao remetente da solicitação HTTP (gatilho HTTP). Esse enlace requer um acionador HTTP e permite-lhe personalizar a resposta associada ao pedido do acionador.

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

• HTTP 204 No Content com um corpo vazio em Funções 2.x e superiores
• HTTP 200 OK com um corpo vazio no Functions 1.x

Atributo

As bibliotecas C# de processo de trabalho em processo e isoladas não exigem um atributo. Em vez disso, o script C# usa um arquivo de configuração function.json, conforme descrito no guia de script C#.

Modelo de trabalhador isolado

Um atributo de valor de retorno não é necessário. Para saber mais, consulte Uso.

Modelo em processo

Importante

O suporte para o modelo em processo terminará em 10 de novembro de 2026. É altamente recomendável que você migre seus aplicativos para o modelo de trabalho isolado para obter suporte total.

Um atributo de valor de retorno não é necessário. Para saber mais, consulte Uso.

Anotações

Na biblioteca de tempo de execução 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. Esta anotação suporta as seguintes configurações:

• Tipo de dados
• Designação

Importante

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

Configuração

Modelo v4

O options objeto passado para o método atualmente não suporta nenhuma propriedade para o output.http() modelo v4.

Modelo v3

A tabela a seguir explica as propriedades de configuração de associação definidas no arquivo function.json .

Property	Descrição
type	Deve ser definido como http.
direção	Deve ser definido como out.
Designação	O nome da variável usado 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 definidas no arquivo function.json .

Property	Descrição
type	Deve ser definido como http.
direção	Deve ser definido como out.
Designação	O nome da variável usado no código de função para a resposta ou $return para usar o valor de retorno.

Utilização

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

O tipo de resposta depende do modo C#:

Modelo de trabalhador isolado

A função acionada HTTP retorna um objeto HttpResponseData ou um Task<HttpResponseData>arquivo . Se o aplicativo usa a integração do ASP.NET Core no .NET Isolado, ele também pode usar IActionResult, Task<IActionResult>, HttpResponse ou Task<HttpResponse>.

Modelo em processo

A função acionada 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, consulte HttpRequestMessage e HttpResponseMessage.

Para exemplos de respostas, consulte os exemplos de gatilho.

Próximos passos

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