Azure Functions HTTP-utdatabindningar

HTTP-utlösta funktioner använder HTTP-utgång för att svara på HTTP-förfrågan som sänds. I de flesta språk representeras denna utdata som en HTTP-utdatabindning. I Go skrivs HTTP-svar direkt med det skickade http.ResponseWriter till din HTTP-triggerhanterare istället för med en separat utdatabindningskonfiguration.

Standardreturvärdet för en HTTP-utlöst funktion är:

  • HTTP 204 No Content med en tom brödtext i Functions 2.x och senare
  • HTTP 200 OK med en tom brödtext i Functions 1.x

Attribut

Ett returvärdeattribut krävs inte när du använder HttpResponseData. Men när du använder en ASP.NET Core-integrering och utdataobjekt[HttpResultAttribute] med flera bindningar bör attributet tillämpas på objektegenskapen. Attributet tar inga parametrar. Mer information finns i Användning.

Kommentarer

I Java Functions-körningsbiblioteket använder du HttpOutput-kommentaren för att definiera en annan utdatavariabel än den standardvariabel som returneras av funktionen. Den här kommentaren stöder följande inställningar:

Viktigt!

Den här artikeln använder flikar för att stödja flera versioner av Node.js programmeringsmodellen. V4-modellen är allmänt tillgänglig och är utformad för att ha en mer flexibel och intuitiv upplevelse för JavaScript- och TypeScript-utvecklare. Mer information om hur v4-modellen fungerar finns i utvecklarguiden för Azure Functions Node.js. Mer information om skillnaderna mellan v3 och v4 finns i migreringsguiden.

Konfiguration

Objektet options som skickas till output.http() metoden stöder för närvarande inte några egenskaper för modell v4.

Konfiguration

I följande tabell förklaras de bindningskonfigurationsegenskaper som du anger i filen function.json .

Property Beskrivning
typ Måste anges till http.
riktning Måste anges till out.
Namn Variabelnamnet som används i funktionskoden för svaret eller $return för att använda returvärdet.

I Go hanteras HTTP-utdata via standarden http.ResponseWriter som skickas till din HTTP-triggerhanterare. Du skriver ditt svar direkt med hjälp av skribenten. Ingen separat utdatabindningskonfiguration behövs.

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!"}`)
}

Förbrukning

Om du vill skicka ett HTTP-svar använder du svarsmönstren language-standard.

I .NET beror svarstypen på C#-läget:

Den HTTP-utlösta funktionen returnerar ett objekt av någon av följande typer:

  • IActionResult1 (eller Task<IActionResult>)
  • HttpResponse1 (eller Task<HttpResponse>)
  • HttpResponseData (eller Task<HttpResponseData>)
  • JSON-serialiserbara typer som representerar svarstexten för ett 200 OK svar.

1 Den här typen är endast tillgänglig när du använder ASP.NET Core-integrering.

När en av dessa typer används som en del av utdataobjekt[HttpResult] med flera bindningar ska attributet tillämpas på objektegenskapen. Attributet tar inga parametrar.

För Java använder du en HttpResponseMessage.Builder för att skapa ett svar på HTTP-utlösaren. Mer information finns i HttpRequestMessage och HttpResponseMessage.

Exempel på svar finns i utlösarexemplen.

Nästa steg

  • Last updated on