HTTP-uitvoerbindingen van Azure Functions

HTTP-getriggerde functies gebruiken HTTP-uitvoer om te reageren op de HTTP-verzoekzender. In de meeste talen wordt deze uitvoer weergegeven als een HTTP-uitvoerbinding. In Go worden HTTP-antwoorden direct geschreven met de http.ResponseWriter passage naar je HTTP-triggerhandler in plaats van met een aparte outputbinding-configuratie.

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

Geïsoleerde werkrolmodel

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.

Model in proces

Belangrijk

De ondersteuning wordt beëindigd voor het in-process model op 10 november 2026. We raden u ten zeerste aan uw apps te migreren naar het geïsoleerde werkrolmodel voor volledige ondersteuning.

Een kenmerk voor een retourwaarde is niet vereist voor een klassebibliotheek. C#-script maakt in plaats daarvan gebruik van een function.json configuratiebestand, zoals beschreven in de handleiding voor C#-scripts. 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:

• Datatype
• name

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

Model v4

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

Model v3

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.

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.

In Go wordt HTTP-uitvoer afgehandeld via de standaard http.ResponseWriter die wordt doorgegeven aan je HTTP-triggerhandler. Je schrijft je antwoord direct met de schrijver. Er is geen aparte outputbindingsconfiguratie nodig.

func hello(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(http.StatusOK)
    fmt.Fprintf(w, `{"message": "Hello from Go!"}`)
}

Gebruik

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

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

Geïsoleerde werkrolmodel

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

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

¹ 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.

Model in proces

De door HTTP geactiveerde functie retourneert een type IActionResult of Task<IActionResult>.

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

• Een functie uitvoeren vanuit een HTTP-aanvraag