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.

   

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

   

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ć.

   

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ę interfejsu OpenAPI z wystąpienia API Management.

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

   

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.

Edytowanie definicji interfejsu OpenAPI w API Management