Zveřejnění bezserverových rozhraní API z koncových bodů HTTP pomocí Azure API Management

  • Článek

Azure Functions se integruje s Azure API Management na portálu, abyste mohli zveřejnit koncové body funkce triggeru HTTP jako rozhraní REST API. Tato rozhraní API jsou popsaná pomocí definice OpenAPI. Tento soubor JSON (nebo YAML) obsahuje informace o tom, jaké operace jsou k dispozici v rozhraní API. Obsahuje podrobnosti o tom, jak by měla být strukturovaná data požadavků a odpovědí pro rozhraní API. Integrací aplikace funkcí můžete mít API Management vygenerovat tyto definice OpenAPI.

V tomto článku se dozvíte, jak integrovat aplikaci funkcí s API Management. Tato integrace funguje pro aplikace funkcí vyvinuté v libovolném podporovaném jazyce. Aplikaci funkcí můžete také importovat z Azure API Management.

U funkcí knihovny tříd jazyka C# můžete také pomocí sady Visual Studio vytvořit a publikovat bezserverové rozhraní API, které se integruje s API Management.

Vytvoření instance API Management

Vytvoření API Management instance propojené s vaší aplikací funkcí:

  1. Vyberte aplikaci funkcí, v nabídce vlevo zvolte API Management a v části API Management vyberte Vytvořit novou.

    Zvolte API Management

  2. Použijte nastavení API Management, jak je uvedeno v následující tabulce:

    Nastavení Navrhovaná hodnota Popis
    Název Globálně jedinečný název Název se vygeneruje na základě názvu vaší aplikace funkcí.
    Předplatné Vaše předplatné Předplatné, ve kterém se tento nový prostředek vytvoří.
    Skupina prostředků myResourceGroup Stejný prostředek jako vaše aplikace funkcí, který by měl být nastavený pro vás.
    Umístění Umístění služby Zvažte výběr stejného umístění jako vaše aplikace funkcí.
    Název organizace Contoso Název organizace používané na portálu pro vývojáře a pro e-mailová oznámení.
    E-mail správce váš e-mail Email, která přijímala systémová oznámení z API Management.
    Cenová úroveň Využití Úroveň Consumption není dostupná ve všech oblastech. Úplné podrobnosti o cenách najdete na stránce s cenami API Management.

    Vytvoření nové služby API Management

  3. Zvolte Exportovat a vytvořte instanci API Management, což může trvat několik minut.

  4. Jakmile Azure instanci vytvoří, povolí na stránce možnost Povolit Application Insights . Vyberte ho, aby se protokoly odesílaly na stejné místo jako aplikace funkcí.

Funkce importu

Po vytvoření instance API Management můžete importovat koncové body funkce aktivované protokolem HTTP. Tento příklad importuje koncový bod s názvem TurbineRepair.

  1. Na stránce API Management vyberte Propojit rozhraní API.

  2. Otevře se Azure Functions Import se zvýrazněnou funkcí TurbineRepair. Pokračujte volbou možnosti Vybrat.

    Import Azure Functions do API Management

  3. Na stránce Vytvořit z aplikace funkcí přijměte výchozí hodnoty a pak vyberte Vytvořit.

    Vytvoření z aplikace funkcí

    Azure pro funkci vytvoří rozhraní API.

Stažení definice OpenAPI

Po importu funkcí si můžete stáhnout definici OpenAPI z instance API Management.

  1. V horní části stránky vyberte Stáhnout definici OpenAPI .

    Stažení definice OpenAPI

  2. Uložte stažený soubor JSON a otevřete ho. Zkontrolujte definici.

Další kroky

Teď můžete definici upřesnit v API Management na portálu. Můžete si také přečíst další informace o API Management.

Úprava definice OpenAPI v API Management