Výstupní vazby HTTP služby Azure Functions

Pomocí výstupní vazby HTTP můžete odpovědět odesílateli požadavku HTTP (trigger HTTP). Tato vazba vyžaduje aktivační událost protokolu HTTP a umožňuje přizpůsobit odpověď přidruženou k požadavku aktivační události.

Výchozí návratová hodnota funkce aktivované protokolem HTTP je:

• HTTP 204 No Content s prázdným tělem ve funkcích 2.x a vyšších
• HTTP 200 OK s prázdným tělem ve funkcích 1.x

Atribut

Izolovaný model pracovního procesu

Při použití httpResponseData není vyžadován atribut návratové hodnoty. Pokud však používáte integraci ASP.NET Core a výstupní objekty s více vazbami, [HttpResultAttribute] měl by se atribut použít na vlastnost objektu. Atribut nepřijímá žádné parametry. Další informace najdete v tématu Využití.

Model v procesu

Důležité

Podpora modelu v procesu skončí 10. listopadu 2026. Důrazně doporučujeme migrovat aplikace do izolovaného modelu pracovního procesu pro plnou podporu.

Atribut návratové hodnoty není vyžadován pro knihovnu tříd. Skript jazyka C# místo toho používá konfigurační soubor function.json, jak je popsáno v průvodci skriptováním jazyka C#. Další informace najdete v tématu Využití.

Poznámky

V knihovně modulu runtime funkcí Java definujte výstupní proměnnou jinou než výchozí proměnnou vrácenou funkcí pomocí poznámky HttpOutput. Tato poznámka podporuje následující nastavení:

• Datatype
• Jméno

Důležité

Tento článek používá karty pro podporu více verzí programovacího modelu Node.js. Model v4 je obecně dostupný a je navržený tak, aby měl flexibilnější a intuitivnější prostředí pro vývojáře v JavaScriptu a TypeScriptu. Další podrobnosti o tom, jak model v4 funguje, najdete v příručce pro vývojáře služby Azure Functions Node.js. Další informace o rozdílech mezi v3 a v4 najdete v průvodci migrací.

Konfigurace

Model v4

Objekt options předaný output.http() metodě v současné době nepodporuje žádné vlastnosti modelu v4.

Model v3

Následující tabulka vysvětluje vlastnosti konfigurace vazby, které jste nastavili v souboru function.json .

Vlastnost	Popis
type	Musí být nastavena na httphodnotu .
direction	Musí být nastavena na outhodnotu .
Jméno	Název proměnné použité v kódu funkce pro odpověď nebo $return použití návratové hodnoty.

Konfigurace

Následující tabulka vysvětluje vlastnosti konfigurace vazby, které jste nastavili v souboru function.json .

Vlastnost	Popis
type	Musí být nastavena na httphodnotu .
direction	Musí být nastavena na outhodnotu .
Jméno	Název proměnné použité v kódu funkce pro odpověď nebo $return použití návratové hodnoty.

Využití

Pokud chcete odeslat odpověď HTTP, použijte vzory odpovědí standardního jazyka.

V .NET typ odpovědi závisí na režimu C#:

Izolovaný model pracovního procesu

Funkce aktivovaná protokolem HTTP vrátí objekt jednoho z následujících typů:

• IActionResult¹ (nebo Task<IActionResult>)
• HttpResponse¹ (nebo Task<HttpResponse>)
• HttpResponseData (nebo Task<HttpResponseData>)
• Serializovatelné typy JSON představující text odpovědi pro 200 OK odpověď

¹ Tento typ je k dispozici pouze při použití integrace ASP.NET Core.

Pokud se jeden z těchto typů používá jako součást výstupních objektů s více vazbami, [HttpResult] atribut by se měl použít na vlastnost objektu. Atribut nepřijímá žádné parametry.

Model v procesu

Funkce aktivovaná protokolem HTTP vrátí typ IActionResult nebo Task<IActionResult>.

Pro Javu použijte HttpResponseMessage.Builder k vytvoření odpovědi na trigger HTTP. Další informace najdete v tématu HttpRequestMessage a HttpResponseMessage.

Příklady triggerů najdete například v odpovědích.

Další kroky

• Spuštění funkce z požadavku HTTP