HTTP-Ausgabebindungen in Azure Functions

  • Artikel

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

In-Process-C#-Bibliotheken und C#-Bibliotheken für isolierte Workerprozesse erfordern kein Attribut. Das C#-Skript verwendet stattdessen eine Konfigurationsdatei function.json, wie im C#-Skript-Handbuch beschrieben.

Ein Attribut des Rückgabewerts ist nicht erforderlich. 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:

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

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

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.

Der Antworttyp hängt vom C#-Modus ab:

Die durch HTTP ausgelöste Funktion gibt ein HttpResponseData- oder ein Task<HttpResponseData>-Objekt zurück. Wenn die App ASP.NET Core Integration in .NET Isolated verwendet, kann sie auch IActionResult, Task<IActionResult>, HttpResponse oder Task<HttpResponse> verwenden.

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