Azure Functions HTTP kimeneti kötések

A HTTP-aktivált függvények HTTP kimenetet használnak a HTTP kérés küldőjének válaszára. A legtöbb nyelvben ez a kimenet HTTP kimeneti kötelékként jelenik meg. A Go módban a HTTP válaszokat közvetlenül http.ResponseWriter az HTTP triggerkezelőhöz továbbítva írják, nem pedig külön kimeneti kötési konfigurációval.

A HTTP által aktivált függvény alapértelmezett visszatérési értéke a következő:

• HTTP 204 No Content üres törzstel a Functions 2.x és újabb verzióiban
• HTTP 200 OK üres törzstel a Functions 1.x-ben

Attribútum

Izolált feldolgozói modell

A HttpResponseData használatakor nincs szükség visszatérési érték attribútumra. Ha azonban ASP.NET Core-integrációt és többkötésű kimeneti objektumot használ, az [HttpResultAttribute] attribútumot az objektumtulajdonságra kell alkalmazni. Az attribútum nem vesz fel paramétereket. További információ: Használat.

Folyamaton belüli modell

Fontos

A folyamaton belüli modell támogatása 2026. november 10-én megszűnik. Erősen javasoljuk, hogy az alkalmazásokat az elkülönített feldolgozói modellbe migrálja a teljes támogatás érdekében.

Az osztálytárakhoz nincs szükség visszatérési érték attribútumra. A C#-szkript ehelyett egy function.json konfigurációs fájlt használ a C#-szkriptelési útmutatóban leírtak szerint. További információ: Használat.

Jegyzetek

A Java-függvények futtatókörnyezeti kódtárában a HttpOutput-széljegyzettel a függvény által visszaadott alapértelmezett változótól eltérő kimeneti változót definiálhat. Ez a széljegyzet a következő beállításokat támogatja:

• Adattípus
• név

Fontos

Ez a cikk lapokat használ a Node.js programozási modell több verziójának támogatásához. A v4-modell általánosan elérhető, és úgy lett kialakítva, hogy rugalmasabb és intuitívabb felhasználói élményt nyújtson JavaScript- és TypeScript-fejlesztők számára. A v4-modell működésével kapcsolatos további információkért tekintse meg az Azure Functions Node.js fejlesztői útmutatóját. A v3 és a v4 közötti különbségekről a migrálási útmutatóban olvashat bővebben.

Konfiguráció

Modell v4

A options metódusnak output.http() átadott objektum jelenleg nem támogatja a 4. modell egyik tulajdonságát sem.

Modell v3

Az alábbi táblázat a function.json fájlban beállított kötéskonfigurációs tulajdonságokat ismerteti.

Tulajdonság	Leírás
type	A beállításnak a httpkövetkezőnek kell lennie: .
direction	A beállításnak a outkövetkezőnek kell lennie: .
név	A válasz függvénykódjában vagy $return a visszatérési érték használatára használt változó neve.

Konfiguráció

Az alábbi táblázat a function.json fájlban beállított kötéskonfigurációs tulajdonságokat ismerteti.

Tulajdonság	Leírás
type	A beállításnak a httpkövetkezőnek kell lennie: .
direction	A beállításnak a outkövetkezőnek kell lennie: .
név	A válasz függvénykódjában vagy $return a visszatérési érték használatára használt változó neve.

A Go esetében a HTTP kimenetet az a szabvány http.ResponseWriter kezeli, amelyet a HTTP triggerkezelőnek továbbítunk. Közvetlenül a válaszodat az íróval írod meg. Nincs szükség külön kimeneti kötési konfigurációra.

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

Használat

HTTP-válasz küldéséhez használja a szabványos nyelvi válaszmintákat.

A .NET-ben a válasz típusa a C# módtól függ:

Izolált feldolgozói modell

A HTTP által aktivált függvény az alábbi típusok egyikének objektumát adja vissza:

• IActionResult¹ (vagy Task<IActionResult>)
• HttpResponse¹ (vagy Task<HttpResponse>)
• HttpResponseData (vagy Task<HttpResponseData>)
• A válasz törzsét 200 OK képviselő JSON szerializálható típusok.

¹ Ez a típus csak a ASP.NET Core-integráció használatakor érhető el.

Ha egy ilyen típust többkötéses kimeneti objektumok részeként használ, az [HttpResult] attribútumot az objektumtulajdonságra kell alkalmazni. Az attribútum nem vesz fel paramétereket.

Folyamaton belüli modell

A HTTP által aktivált függvény az IActionResultTask<IActionResult>.

Java esetén httpResponseMessage.Builder használatával hozzon létre választ a HTTP-eseményindítóra. További információ: HttpRequestMessage és HttpResponseMessage.

Példák a válaszokra, lásd az eseményindító példáit.

Következő lépések

• Függvény futtatása HTTP-kérelemből