Uwidacznianie bezserwerowych interfejsów API z punktów końcowych HTTP przy użyciu usługi Azure API Management

Azure Functions integruje się z usługą Azure API Management w portalu, aby umożliwić uwidocznienie punktów końcowych funkcji wyzwalacza HTTP jako interfejsów API REST. Te interfejsy API są opisane przy użyciu definicji interfejsu OpenAPI. Ten plik JSON (lub YAML) zawiera informacje o tym, jakie operacje są dostępne w interfejsie API. Zawiera szczegółowe informacje o sposobie strukturalnych danych żądania i odpowiedzi dla interfejsu API. Integrując aplikację funkcji, można API Management wygenerować te definicje interfejsu OpenAPI.

W tym artykule pokazano, jak zintegrować aplikację funkcji z API Management. Ta integracja działa w przypadku aplikacji funkcji opracowanych w dowolnym obsługiwanym języku. Aplikację funkcji można również zaimportować z usługi Azure API Management.

W przypadku funkcji biblioteki klas języka C# można również użyć programu Visual Studio do tworzenia i publikowania bezserwerowego interfejsu API zintegrowanego z API Management.

Tworzenie wystąpienia API Management

Aby utworzyć wystąpienie API Management połączone z aplikacją funkcji:

  1. Wybierz aplikację funkcji, wybierz pozycję API Management z menu po lewej stronie, a następnie wybierz pozycję Utwórz nową w obszarze API Management.

    Wybierz API Management

  2. Użyj ustawień API Management określonych w poniższej tabeli:

    Ustawienie Sugerowana wartość Opis
    Nazwa Nazwa unikatowa w skali globalnej Nazwa jest generowana na podstawie nazwy aplikacji funkcji.
    Subskrypcja Twoja subskrypcja Subskrypcja, w ramach której utworzono ten nowy zasób.
    Grupa zasobów myResourceGroup Ten sam zasób co aplikacja funkcji, który powinien zostać ustawiony dla Ciebie.
    Lokalizacja Lokalizacja usługi Rozważ wybranie tej samej lokalizacji co aplikacja funkcji.
    Nazwa organizacji Contoso Nazwa organizacji używanej w portalu deweloperów i powiadomienia e-mail.
    Adres e-mail administratora Twój adres e-mail Email, które otrzymały powiadomienia systemowe z API Management.
    Warstwa cenowa Zużycie Warstwa Zużycie nie jest dostępna we wszystkich regionach. Aby uzyskać szczegółowe informacje o cenach, zobacz stronę cennika API Management

    Tworzenie nowej usługi API Management

  3. Wybierz pozycję Eksportuj, aby utworzyć wystąpienie API Management, co może potrwać kilka minut.

  4. Po utworzeniu wystąpienia przez platformę Azure zostanie włączona opcja Włącz usługę Application Insights na stronie. Wybierz go, aby wysyłać dzienniki do tego samego miejsca co aplikacja funkcji.

Importowanie funkcji

Po utworzeniu wystąpienia API Management można zaimportować punkty końcowe funkcji wyzwalanej przez protokół HTTP. W tym przykładzie importuje punkt końcowy o nazwie TurbineRepair.

  1. Na stronie API Management wybierz pozycję Połącz interfejs API.

  2. Zostanie otwarty Azure Functions Import z wyróżnioną funkcją TurbineRepair. Wybierz pozycję Wybierz, aby kontynuować.

    Importowanie Azure Functions do API Management

  3. Na stronie Tworzenie z aplikacji funkcji zaakceptuj wartości domyślne, a następnie wybierz pozycję Utwórz.

    Tworzenie na podstawie aplikacji funkcji

    Platforma Azure tworzy interfejs API dla funkcji.

Pobieranie definicji interfejsu OpenAPI

Po zaimportowaniu funkcji możesz pobrać definicję interfejsu OpenAPI z wystąpienia API Management.

  1. Wybierz pozycję Pobierz definicję interfejsu OpenAPI w górnej części strony.

    Pobieranie definicji interfejsu OpenAPI

  2. Zapisz pobrany plik JSON, a następnie otwórz go. Przejrzyj definicję.

Następne kroki

Teraz możesz uściślić definicję w API Management w portalu. Możesz również dowiedzieć się więcej na temat API Management.