Výstupní vazby HTTP služby Azure Functions

  • Článek

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

Knihovny C# v procesu i izolovaného pracovního procesu nevyžadují atribut. 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#.

Atribut návratové hodnoty není povinný. 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í:

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

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

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.

Typ odpovědi závisí na režimu jazyka C#:

Funkce aktivovaná protokolem HTTP vrátí objekt HttpResponseData nebo objekt Task<HttpResponseData>. Pokud aplikace používá integraci ASP.NET Core v izolovaném prostředí .NET, může také použít IActionResult, Task<IActionResult>HttpResponse nebo Task<HttpResponse>.

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