Delen via

HTTP-uitvoerbindingen van Azure Functions

  • Artikel

Gebruik de HTTP-uitvoerbinding om te reageren op de HTTP-aanvraagzender (HTTP-trigger). Voor deze binding is een HTTP-trigger vereist en met de binding kunt u de reactie aanpassen die aan de aanvraag van de trigger is gekoppeld.

De standaard retourwaarde voor een door HTTP geactiveerde functie is:

  • HTTP 204 No Content met een lege hoofdtekst in Functions 2.x en hoger
  • HTTP 200 OK met een lege hoofdtekst in Functions 1.x

Kenmerk

Een kenmerk voor een retourwaarde is niet vereist bij het gebruik van HttpResponseData. Wanneer u echter een ASP.NET Core-integratie en uitvoerobjecten met meerdere bindingen gebruikt, moet het [HttpResultAttribute] kenmerk worden toegepast op de objecteigenschap. Het kenmerk heeft geen parameters. Zie Gebruik voor meer informatie.

Aantekeningen

Gebruik in de Java Functions Runtime-bibliotheek de httpOutput-aantekening om een andere uitvoervariabele te definiëren dan de standaardvariabele die door de functie wordt geretourneerd. Deze aantekening ondersteunt de volgende instellingen:

Belangrijk

In dit artikel worden tabbladen gebruikt ter ondersteuning van meerdere versies van het Node.js programmeermodel. Het v4-model is algemeen beschikbaar en is ontworpen voor een flexibelere en intuïtievere ervaring voor JavaScript- en TypeScript-ontwikkelaars. Raadpleeg de ontwikkelaarshandleiding voor Azure Functions Node.js voor meer informatie over hoe het v4-model werkt. Raadpleeg de migratiehandleiding voor meer informatie over de verschillen tussen v3 en v4.

Configuratie

Het options object dat aan de output.http() methode wordt doorgegeven, biedt momenteel geen ondersteuning voor eigenschappen voor model v4.

Configuratie

In de volgende tabel worden de bindingsconfiguratie-eigenschappen uitgelegd die u in het function.json-bestand hebt ingesteld.

Eigenschappen Beschrijving
type Moet worden ingesteld op http.
direction Moet worden ingesteld op out.
name De naam van de variabele die wordt gebruikt in functiecode voor het antwoord of $return om de retourwaarde te gebruiken.

Gebruik

Als u een HTTP-antwoord wilt verzenden, gebruikt u de taalstandaard-antwoordpatronen.

In .NET is het antwoordtype afhankelijk van de C#-modus:

De door HTTP geactiveerde functie retourneert een object van een van de volgende typen:

  • IActionResult1 (of Task<IActionResult>)
  • HttpResponse1 (of Task<HttpResponse>)
  • HttpResponseData (of Task<HttpResponseData>)
  • JSON serialiseerbare typen die de antwoordtekst voor een 200 OK antwoord vertegenwoordigen.

1 Dit type is alleen beschikbaar bij het gebruik van ASP.NET Core-integratie.

Wanneer een van deze typen wordt gebruikt als onderdeel van uitvoerobjecten met meerdere bindingen, moet het [HttpResult] kenmerk worden toegepast op de objecteigenschap. Het kenmerk heeft geen parameters.

Gebruik voor Java een HttpResponseMessage.Builder om een antwoord te maken op de HTTP-trigger. Zie HttpRequestMessage en HttpResponseMessage voor meer informatie.

Zie bijvoorbeeld de triggervoorbeelden.

Volgende stappen