Spuštění funkce Azure pomocí požadavku HTTP

Dokončeno

Na většina platforem a zařízení je požadavek HTTP běžnou operací. Požadavky HTTP posíláme neustále, ať už je to žádost o vyhledání slova ve slovníku nebo o zjištění místního počasí. Azure Functions umožňuje rychle vytvořit logiku, která se má při přijetí požadavku HTTP spustit.

V této lekci se dozvíte, jak vytvořit a vyvolat funkci pomocí triggeru HTTP. Prozkoumáte také některé možnosti přizpůsobení, které jsou k dispozici pro triggery HTTP.

Co je trigger HTTP?

Trigger HTTP je trigger, který spustí kód při přijetí požadavku HTTP. Triggery HTTP nabízejí řadu možností a přizpůsobení, včetně následujících:

  • Poskytnutí autorizovaného přístupu zadáním klíčů
  • Omezení podporovaných příkazů HTTP
  • Vrácení dat zpět volajícímu
  • Příjem dat prostřednictvím parametrů řetězce dotazu nebo textu požadavku
  • Podpora šablon tras adres URL pro úpravu adresy URL funkce

Při vytváření triggeru HTTP musíte zadat název triggeru a zvolit úroveň autorizace.

Co je úroveň autorizace triggeru HTTP?

Úroveň autorizace triggeru HTTP je příznak, který označuje, jestli příchozí požadavek HTTP potřebuje k autorizaci klíč rozhraní API.

Existují tři úrovně autorizace:

  1. Function
  2. Anonymní
  3. Správa

Úrovně Funkce a Správce jsou založené na klíči. Pokud chcete odeslat požadavek HTTP, musíte zadat klíč pro autorizaci. Existují dva typy klíčů, klíč funkce a klíč hostitele. Rozdíl mezi těmito dvěma klíči je v jejich rozsahu. Klíče funkce jsou specifické pro funkci. Klíče hostitele se vztahují na všechny funkce v rámci celé aplikace funkcí. Pokud je úroveň autorizace nastavená na hodnotu Funkce, můžete použít klíč funkce i klíč hostitele. Pokud je úroveň autorizace nastavená na hodnotu Správce, musíte zadat klíč hostitele.

Důležité

Vzhledem k tomu, že klíče hostitele poskytují zvýšený přístup k vaší aplikaci funkcí, musíte je bezpečně přenést a uložit.

Anonymní úroveň znamená, že autorizace není nutná. V tomto cvičení se používá úroveň anonymní autorizace.

Jak vytvořit trigger HTTP

Stejně jako trigger časovače i trigger HTTP můžete vytvořit prostřednictvím webu Azure Portal. Ve funkci Azure vyberte v seznamu předdefinovaných typů aktivačních událostí trigger http a pak zadejte logiku, kterou chcete provést, a proveďte vlastní nastavení, například omezení použití určitých příkazů HTTP.

Jedním z nastavení, kterým je důležité porozumět, je Název parametru požadavku. Toto nastavení je řetězec odpovídající názvu parametru, který obsahuje informace o příchozím požadavku HTTP. Ve výchozím nastavení je název tohoto parametru req.

Jak vyvolat trigger HTTP

Pokud chcete vyvolat trigger HTTP, odešlete požadavek HTTP na adresu URL pro vaši funkci. Tuto adresu URL získáte, když přejdete na znakovou stránku funkce a vyberte odkaz Získat adresu URL funkce.

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

Když máte adresu URL funkce, můžete odesílat požadavky HTTP. Pokud vaše funkce přijímá data, mějte na paměti, že můžete použít parametry řetězce dotazu nebo zadat data prostřednictvím textu požadavku.

Trigger HTTP se spustí, když přijme požadavek HTTP na adresu URL funkce. Triggery HTTP umožňují přijímat data, spouštět logiku a volitelně vracet data zpět volajícímu.