HTTP-uitvoerbindingen van Azure Functions

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

C #-bibliotheken voor zowel in-process - als geïsoleerde werkprocessen hebben geen kenmerk nodig. C#-script maakt in plaats daarvan gebruik van een function.json configuratiebestand, zoals beschreven in de handleiding voor C#-scripts.

Er is geen kenmerk voor een retourwaarde vereist. 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.

Het antwoordtype is afhankelijk van de C#-modus:

De door HTTP geactiveerde functie retourneert een HttpResponseData-object of een Task<HttpResponseData>. Als de app gebruikmaakt van ASP.NET Core-integratie in .NET Isolated, kan deze ook IActionResult, Task<IActionResult>HttpResponse of Task<HttpResponse>.

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