HTTP-Ausgabebindungen in Azure Functions

Verwenden Sie die HTTP-Ausgabebindung, um eine Antwort an den Absender der HTTP-Anforderung (HTTP-Trigger) zu senden. Diese Bindung erfordert einen HTTP-Trigger und ermöglicht es Ihnen, die Antwort anzupassen, die der Anforderung des Triggers zugeordnet ist.

Der Standardrückgabewert für eine HTTP-ausgelöste Funktion ist:

• HTTP 204 No Content bei leerem Hauptteil in Functions 2.x und höher
• HTTP 200 OK bei leerem Hauptteil in Functions 1.x

Attribut

Isoliertes Workermodell

Ein Rückgabewertattribut ist bei Verwendung von HttpResponseData nicht erforderlich. Wenn Sie jedoch eine ASP.NET Core-Integrations - und Multibindungsausgabeobjekte verwenden, sollte das [HttpResultAttribute] Attribut auf die Objekteigenschaft angewendet werden. Das Attribut akzeptiert keine Parameter. Weitere Informationen finden Sie unter Syntax.

In-Process-Modell

Wichtig

Die Unterstützung für das In-Process-Modell endet am 10. November 2026. Es wird dringend empfohlen, Ihre Apps zum isolierten Workermodell zu migrieren, um den vollständigen Support zu ermöglichen.

Für eine Klassenbibliothek ist kein Rückgabewert-Attribut erforderlich. Das C#-Skript verwendet stattdessen eine Konfigurationsdatei function.json, wie im C#-Skript-Handbuch beschrieben. Weitere Informationen finden Sie unter Syntax.

Anmerkungen

Verwenden Sie in der Laufzeitbibliothek für Java-Funktionen die HttpOutput-Anmerkung, um eine andere Ausgabevariable als die von der Funktion zurückgegebene Standardvariable zu definieren. Diese Anmerkung unterstützt die folgenden Einstellungen:

• dataType
• name

Wichtig

In diesem Artikel werden Registerkarten verwendet, um mehrere Versionen des Node.js-Programmiermodells zu unterstützen. Das v4-Modell ist allgemein verfügbar und bietet JavaScript- und TypeScript-Entwicklern eine flexiblere und intuitivere Erfahrung. Weitere Informationen zur Funktionsweise des v4-Modells finden Sie im Azure Functions Node.js-Entwicklerhandbuch. Weitere Informationen zu den Unterschieden zwischen v3 und v4 finden Sie im Migrationshandbuch.

Konfiguration

Modell v4

Das an die output.http()-Methode übergebene options-Objekt unterstützt derzeit keine Eigenschaften für das Modell v4.

Modell v3

Die folgende Tabelle gibt Aufschluss über die Bindungskonfigurationseigenschaften, die Sie in der Datei function.json festlegen.

Eigenschaft	Beschreibung des Dataflows
type	Muss auf http festgelegt sein.
direction	Muss auf out festgelegt sein.
name	Der Variablenname, der im Funktionscode für die Antwort verwendet wird, oder $return für die Verwendung des Rückgabewerts.

Konfiguration

Die folgende Tabelle gibt Aufschluss über die Bindungskonfigurationseigenschaften, die Sie in der Datei function.json festlegen.

Eigenschaft	Beschreibung des Dataflows
type	Muss auf http festgelegt sein.
direction	Muss auf out festgelegt sein.
name	Der Variablenname, der im Funktionscode für die Antwort verwendet wird, oder $return für die Verwendung des Rückgabewerts.

Verwendung

Verwenden Sie zum Senden einer HTTP-Antwort die Antwortmuster des Sprachstandards.

In .NET hängt der Antworttyp vom C#-Modus ab:

Isoliertes Workermodell

Die ausgelöste HTTP-Funktion gibt ein Objekt eines der folgenden Typen zurück:

• IActionResult¹ (oder Task<IActionResult>)
• HttpResponse¹ (oder Task<HttpResponse>)
• HttpResponseData (oder Task<HttpResponseData>)
• JSON serialisierbare Typen, die den Antworttext für eine 200 OK Antwort darstellen.

¹ Dieser Typ ist nur verfügbar, wenn ASP.NET Core-Integration verwendet wird.

Wenn eines dieser Typen als Teil von Multibindungsausgabeobjekten verwendet wird, sollte das [HttpResult] Attribut auf die Objekteigenschaft angewendet werden. Das Attribut akzeptiert keine Parameter.

In-Process-Modell

Die durch HTTP ausgelöste Funktion gibt den Typ IActionResult oder Task<IActionResult>zurück.

Verwenden Sie für Java httpResponseMessage.Builder, um eine Antwort auf den HTTP-Trigger zu erstellen. Weitere Informationen finden Sie unter HttpRequestMessage und HttpResponseMessage.

Beispielantworten finden Sie in den Triggerbeispielen.

Nächste Schritte

• Ausführen einer Funktion aus einer HTTP-Anforderung