Azure Functions HTTP kimeneti kötések

A HTTP-kimeneti kötéssel válaszolhat a HTTP-kérés feladójának (HTTP-eseményindító). A kötéshez HTTP-triggerre van szükség. Lehetővé teszi a trigger kéréséhez társított válasz testreszabását.

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.

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 IActionResult vagy Task<IActionResult>a .

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