Bezserwerowe interfejsy API REST korzystające z usługi Azure Functions
Azure Functions to podstawowa usługa obliczeniowa używana do tworzenia bezserwerowych interfejsów API opartych na protokole REST. Wyzwalacze HTTP uwidaczniają punkty końcowe REST, które mogą być wywoływane przez klientów, takich jak przeglądarki, aplikacje mobilne i inne usługi zaplecza. Dzięki natywnej obsłudze tras jedna funkcja wyzwalana przez protokół HTTP może uwidaczniać wysoce funkcjonalny interfejs API REST. Usługa Functions udostępnia również własny podstawowy schemat autoryzacji oparty na kluczach, aby ograniczyć dostęp tylko do określonych klientów. Aby uzyskać więcej informacji, zobacz Wyzwalacz HTTP usługi Azure Functions
W niektórych scenariuszach może być konieczne, aby interfejs API obsługiwał bardziej złożony zestaw zachowań REST. Na przykład może być konieczne połączenie wielu punktów końcowych funkcji HTTP w jeden interfejs API. Możesz również przekazać żądania do co najmniej jednej usługi opartej na protokole REST zaplecza. Na koniec interfejsy API mogą wymagać wyższego poziomu zabezpieczeń, co umożliwia zarabianie na jego użyciu.
Obecnie zalecanym podejściem do tworzenia bardziej złożonych i niezawodnych interfejsów API opartych na funkcjach jest użycie kompleksowych usług interfejsu API udostępnianych przez usługę Azure API Management. Usługa API Management używa modelu opartego na zasadach, aby umożliwić kontrolowanie routingu, zabezpieczeń i integracji interfejsu OpenAPI. Obsługuje również zaawansowane zasady, takie jak ograniczanie liczby monetyzacji. Poprzednie wersje środowiska uruchomieniowego usługi Functions używały starszej funkcji serwerów proxy usługi Functions.
Ważne
Serwery proxy usługi Azure Functions to starsza funkcja dla wersji 1.x do 3.x środowiska uruchomieniowego usługi Azure Functions. Obsługę serwerów proxy można ponownie włączyć w wersji 4.x, aby pomyślnie uaktualnić aplikacje funkcji do najnowszej wersji środowiska uruchomieniowego. Jak najszybciej należy przełączyć się na integrację aplikacji funkcji z usługą Azure API Management. Usługa API Management umożliwia korzystanie z pełniejszego zestawu funkcji do definiowania i zabezpieczania interfejsów API opartych na usłudze Functions oraz zarządzania nimi i zarabiania na nich. Aby uzyskać więcej informacji, zobacz Integracja usługi API Management.
Aby dowiedzieć się, jak ponownie włączyć obsługę serwerów proxy w usłudze Functions w wersji 4.x, zobacz Ponowne włączanie serwerów proxy w usłudze Functions w wersji 4.x.
Przechodzenie z serwerów proxy usługi Functions do usługi API Management
Podczas przechodzenia z serwerów proxy usługi Functions do usługi API Management należy zintegrować aplikację funkcji z wystąpieniem usługi API Management, a następnie skonfigurować wystąpienie usługi API Management tak, aby zachowywało się tak jak poprzedni serwer proxy. Poniższa sekcja zawiera linki do odpowiednich artykułów, które ułatwiają pomyślne korzystanie z usługi API Management z usługą Azure Functions.
Jeśli masz wyzwania związane z przejściem z serwerów proxy lub usługa Azure API Management nie rozwiąże konkretnych scenariuszy, opublikuj żądanie na forum opinii usługi API Management.
Integracja usługi API Management
Usługa API Management umożliwia importowanie istniejącej aplikacji funkcji. Po zaimportowaniu każdy punkt końcowy funkcji wyzwalanej przez protokół HTTP staje się interfejsem API, którym można modyfikować i zarządzać. Po zaimportowaniu można również użyć usługi API Management do wygenerowania pliku definicji interfejsu OpenAPI dla interfejsów API. Podczas importowania wszystkie punkty końcowe z admin poziomem autoryzacji są ignorowane. Aby uzyskać więcej informacji na temat korzystania z usługi API Management z usługą Functions, zobacz następujące artykuły:
| Artykuł | opis |
|---|---|
| Uwidacznianie bezserwerowych interfejsów API z punktów końcowych HTTP przy użyciu usługi Azure API Management | Pokazuje, jak utworzyć nowe wystąpienie usługi API Management na podstawie istniejącej aplikacji funkcji w witrynie Azure Portal. Obsługuje wszystkie języki. |
| Tworzenie bezserwerowych interfejsów API w programie Visual Studio przy użyciu usługi Azure Functions i integracji usługi API Management | Pokazuje, jak za pomocą programu Visual Studio utworzyć projekt w języku C#, który używa rozszerzenia OpenAPI. Rozszerzenie OpenAPI umożliwia zdefiniowanie interfejsów API platformy .NET przez zastosowanie atrybutów bezpośrednio do kodu języka C#. |
| Szybki start: tworzenie nowego wystąpienia usługi Azure API Management przy użyciu witryny Azure Portal | Utwórz nowe wystąpienie usługi API Management w portalu. Po utworzeniu wystąpienia usługi API Management możesz połączyć je z aplikacją funkcji. Obsługiwane są inne metody tworzenia innych niż portal. |
| Importowanie aplikacji funkcji platformy Azure jako interfejsu API w usłudze Azure API Management | Pokazuje, jak zaimportować istniejącą aplikację funkcji w celu uwidocznienia istniejących punktów końcowych wyzwalacza HTTP jako zarządzanego interfejsu API. Ten artykuł obsługuje zarówno tworzenie nowego interfejsu API, jak i dodawanie punktów końcowych do istniejącego zarządzanego interfejsu API. |
Po udostępnieniu punktów końcowych aplikacji funkcji przy użyciu usługi API Management poniższe artykuły zawierają ogólne informacje na temat zarządzania interfejsami API opartymi na funkcjach w wystąpieniu usługi API Management.
| Artykuł | opis |
|---|---|
| Edytowanie interfejsu API | Pokazuje, jak pracować z istniejącym interfejsem API hostowanym w usłudze API Management. |
| Zasady w usłudze Azure API Management | W usłudze API Management wydawcy mogą zmieniać zachowanie interfejsu API za pomocą konfiguracji przy użyciu zasad. Zasady to zbiór instrukcji, które są uruchamiane sekwencyjnie na żądanie lub odpowiedź interfejsu API. |
| API Management policy reference | Zapoznaj się ze szczegółami wszystkich obsługiwanych zasad usługi API Management. |
| Przykłady zasad usługi API Management | Przydatna kolekcja przykładów przy użyciu zasad usługi API Management w kluczowych scenariuszach. |
Starsze serwery proxy usługi Functions
Funkcja starszych serwerów proxy usługi Functions udostępnia również zestaw podstawowych funkcji interfejsu API dla wersji 3.x i starszej wersji środowiska uruchomieniowego usługi Functions.
Ważne
Serwery proxy usługi Azure Functions to starsza funkcja dla wersji 1.x do 3.x środowiska uruchomieniowego usługi Azure Functions. Obsługę serwerów proxy można ponownie włączyć w wersji 4.x, aby pomyślnie uaktualnić aplikacje funkcji do najnowszej wersji środowiska uruchomieniowego. Jak najszybciej należy przełączyć się na integrację aplikacji funkcji z usługą Azure API Management. Usługa API Management umożliwia korzystanie z pełniejszego zestawu funkcji do definiowania i zabezpieczania interfejsów API opartych na usłudze Functions oraz zarządzania nimi i zarabiania na nich. Aby uzyskać więcej informacji, zobacz Integracja usługi API Management.
Aby dowiedzieć się, jak ponownie włączyć obsługę serwerów proxy w usłudze Functions w wersji 4.x, zobacz Ponowne włączanie serwerów proxy w usłudze Functions w wersji 4.x.
Niektóre podstawowe wskazówki dotyczące wykonywania równoważnych zadań przy użyciu usługi API Management zostały dodane do artykułu Usługi Functions Proxyxies. Obecnie nie mamy dokumentacji ani narzędzi, które ułatwiają migrowanie istniejącej implementacji serwerów proxy usługi Functions do usługi API Management.