Udostępnij za pośrednictwem

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

Usługa 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 na temat struktury danych żądania i odpowiedzi dla interfejsu API. Integrując aplikację funkcji, możesz wygenerować te definicje interfejsu OpenAPI za pomocą usługi API Management.

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

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

Tworzenie wystąpienia usługi API Management

Aby utworzyć instancję usługi API Management powiązaną z aplikacją funkcji w chmurze:

  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.

  2. Użyj ustawień usługi API Management, jak określono w poniższej tabeli:

    Ustawienia Sugerowana wartość Opis
    Subskrypcja Twoja subskrypcja Subskrypcja, w ramach której jest tworzony ten nowy zasób.
    Grupa zasobów: GrupaZasobówMoja Ten sam zasób, co aplikacja funkcyjna, który powinien być skonfigurowany dla Ciebie.
    Region Lokalizacja usługi Rozważ wybranie tej samej lokalizacji co aplikacja funkcji.
    Nazwa zasobu Nazwa unikatowa w skali globalnej Nazwa jest generowana na podstawie nazwy aplikacji funkcji.
    Nazwa organizacji Contoso Nazwa organizacji używanej w portalu dla deweloperów i powiadomienia e-mail.
    Adres e-mail administratora Twój adres e-mail Wiadomość e-mail, która otrzymała powiadomienia systemowe z usługi API Management.
    Poziom cenowy Konsumpcja Poziom zużycia nie jest dostępny we wszystkich regionach. Aby uzyskać szczegółowe informacje o cenach, zobacz stronę cennika usługi API Management

  3. Wybierz pozycję Przejrzyj + utwórz, a następnie Utwórz, aby utworzyć wystąpienie usługi API Management, co może potrwać kilka minut.

Importowanie funkcji

Po utworzeniu wystąpienia usługi 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 API.

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

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

Pobieranie definicji interfejsu OpenAPI

Po zaimportowaniu funkcji, możesz pobrać definicję OpenAPI z wystąpienia usługi API Management.

  1. Wybierz Pobierz definicję interfejsu OpenAPI na górze strony.

    Pobieranie definicji interfejsu OpenAPI

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

Dalsze kroki

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

Edytowanie definicji interfejsu OpenAPI w usłudze API Management