Azure-függvény végrehajtása HTTP-kéréssel

  • 10 perc

A HTTP-kérések gyakori műveletek a legtöbb platformon és eszközön. Akár egy szót akarunk kikerestetni egy szótárból, akár a helyi időjárást akarjuk megtudni, állandóan küldünk HTTP-kéréseket. Az Azure Functions segítségével gyorsan létrehozható egy logikai elem, amely a HTTP-kérések fogadásakor lesz végrehajtva.

Ebben a leckében megtanulhatja, hogyan hozhat létre és hívhat meg függvényeket EGY HTTP-eseményindító használatával. A HTTP-eseményindítókhoz elérhető testreszabási lehetőségek némelyikét is megismerheti.

What is an HTTP trigger?

A HTTP-eseményindítók olyan eseményindítók, amelyek HTTP-kérés fogadásakor kódot hajtanak végre. HTTP triggers have many capabilities and customizations, including:

  • Engedélyezett hozzáférés biztosítása kulcsok megadásával.
  • Annak korlátozása, hogy mely HTTP-parancsok támogatottak.
  • Adatok visszaadása a hívónak.
  • Adatok fogadása lekérdezési sztringparamétereken vagy a kérelem törzsén keresztül.
  • A függvény URL-címének módosításához támogató URL-útvonalsablonok.

HTTP-eseményindító létrehozásakor meg kell adnia az eseményindító nevét, és ki kell választania egy engedélyezési szintet.

Mi a HTTP-eseményindítók hitelesítési szintje?

A HTTP-eseményindító engedélyezési szintje egy jelző, amely jelzi, hogy egy bejövő HTTP-kérésnek szüksége van-e API-kulcsra az engedélyezéshez.

There are three Authorization levels:

  1. Function
  2. Névtelen
  3. Admin

A Függvény és a Rendszergazda szint „kulcs” használatán alapul. HTTP-kérés küldéséhez meg kell adnia egy kulcsot az engedélyezéshez. Kétféle kulcs van: függvény- és gazdakulcs. A két kulcs a hatókörükben különbözik. A függvénykulcsok egyetlen függvényre vonatkoznak. A gazdakulcsok a függvényalkalmazás összes függvényére vonatkoznak. Ha a hitelesítési szint beállítása Függvény, akkor függvény- és gazdakulcsok is használhatók. Ha a hitelesítési szint Rendszergazda, akkor gazdakulcsot kell megadnia.

Fontos

Mivel a gazdagépkulcsok emelt szintű hozzáférést biztosítanak a függvényalkalmazáshoz, biztonságosan kell őket szállítani és tárolni.

A névtelen szint azt jelenti, hogy nincs szükség engedélyezésre. Ez a gyakorlat a névtelen engedélyezési szintet használja.

HTTP-eseményindító létrehozása

Az időzítő eseményindítókhoz hasonlóan a HTTP-eseményindítók is az Azure Portalon keresztül hozhatók létre. Az Azure-függvényben válassza ki a HTTP-eseményindítót az előre definiált triggertípusok listájából, majd adja meg a végrehajtani kívánt logikát, és végezze el a testreszabásokat, például korlátozza bizonyos HTTP-parancsok használatát.

Az egyik beállítás, amellyel fontos tisztában lennie, a kérelemparaméter neve. Ez a beállítás egy sztring, amely a bejövő HTTP-kérésről információkat tartalmazó paraméter nevét jelenti. A paraméter alapértelmezés szerinti neve req.

HTTP-eseményindító meghívása

HTTP-eseményindító meghívásához HTTP-kérést kell küldenie a függvény URL-címére. Ezt az URL-címet a függvény kódlapján a Függvény URL-címének lekérése hivatkozást követve állapíthatja meg.

Screenshot of the Azure portal showing a Functions App pane with the app's Get function URL button highlighted.

A függvény URL-címének ismeretében már küldhet HTTP-kéréseket. Ha a függvény adatokat fogad, ne feledje, hogy lekérdezési sztringparamétereket használhat, vagy a kérelem törzsén keresztül szolgáltathatja az adatokat.

A HTTP-eseményindítók akkor futnak, amikor HTTP-kérést kap a függvény URL-címére. A HTTP-eseményindítók lehetővé teszik az adatok fogadását, a logika végrehajtását, és opcionálisan visszaadhatja az adatokat a hívónak.