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

Modelo de trabalhador isolado

Um atributo return value não é necessário ao usar HttpResponseData. No entanto, ao usar uma integração do ASP.NET Core e objetos de saída de multiligação, o [HttpResultAttribute] atributo deve ser aplicado à propriedade do objeto. O atributo não usa parâmetros. 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 uma biblioteca de classes. Em vez disso, o script C# usa um arquivo de configuração function.json, conforme descrito no guia de script C#. 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.

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

Modelo de trabalhador isolado

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

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

1 Este tipo só está disponível quando se utiliza a integração ASP.NET Core.

Quando um desses tipos é usado como parte de objetos de saída de ligação múltipla, o [HttpResult] atributo deve ser aplicado à propriedade object. O atributo não usa parâmetros.

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