Bezserwerowe interfejsy API REST korzystające z 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, takie jak przeglądarki, aplikacje mobilne i inne usługi zaplecza. Dzięki natywnej obsłudze tras pojedyncza 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 ułatwić ograniczenie dostępu tylko do określonych klientów. Aby uzyskać więcej informacji, zobacz Azure Functions wyzwalacz HTTP
W niektórych scenariuszach może być potrzebny interfejs API do obsługi bardziej złożonego zestawu 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 pozwala zarabiać 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 oferowanych przez usługę Azure API Management. API Management używa modelu opartego na zasadach, aby kontrolować routing, zabezpieczenia i integrację z interfejsem 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
Azure Functions serwery proxy to starsza funkcja dla wersji 1.x do 3.x środowiska uruchomieniowego 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 API Management integracja.
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 używania API Management należy zintegrować aplikację funkcji z wystąpieniem API Management, a następnie skonfigurować wystąpienie 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 API Management z Azure Functions.
Jeśli masz wyzwania związane z przechodzeniem z serwerów proxy lub jeśli usługa Azure API Management nie dotyczy konkretnych scenariuszy, opublikuj żądanie na forum API Management opinii.
integracja API Management
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óry można modyfikować i zarządzać. Po zaimportowaniu można również użyć API Management, aby wygenerować plik definicji interfejsu OpenAPI dla interfejsów API. Podczas importowania wszystkie punkty końcowe z adminpoziomem autoryzacji są ignorowane. Aby uzyskać więcej informacji na temat używania API Management z usługą Functions, zobacz następujące artykuły:
| Artykuł | Opis |
|---|---|
| Uwidaczniaj bezserwerowe interfejsy API z punktów końcowych HTTP przy użyciu usługi Azure API Management | Pokazuje, jak utworzyć nowe wystąpienie API Management na podstawie istniejącej aplikacji funkcji w Azure Portal. Obsługuje wszystkie języki. |
| Tworzenie bezserwerowych interfejsów API w programie Visual Studio przy użyciu integracji Azure Functions i API Management | Pokazuje, jak używać programu Visual Studio do tworzenia projektu C#, który używa rozszerzenia OpenAPI. Rozszerzenie OpenAPI umożliwia definiowanie 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 Azure Portal | Utwórz nowe wystąpienie API Management w portalu. Po utworzeniu wystąpienia API Management można 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 API Management następujące artykuły zawierają ogólne informacje na temat zarządzania interfejsami API opartymi na funkcjach w wystąpieniu API Management.
| Artykuł | Opis |
|---|---|
| Edytowanie interfejsu API | Pokazuje, jak pracować z istniejącym interfejsem API hostowanym w API Management. |
| Zasady w usłudze Azure API Management | W API Management wydawcy mogą zmieniać zachowanie interfejsu API za pomocą konfiguracji przy użyciu zasad. Zasady to zbiór instrukcji uruchamianych sekwencyjnie na żądanie lub odpowiedź interfejsu API. |
| API Management policy reference | Zapoznaj się z informacjami o wszystkich obsługiwanych zasadach API Management. |
| Przykłady zasad usługi API Management | Przydatna kolekcja przykładów korzystających z zasad 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
Azure Functions serwery proxy to starsza funkcja dla wersji 1.x do 3.x środowiska uruchomieniowego 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 API Management integracja.
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 API Management zostały dodane do artykułu Serwery proxy usługi Functions. Obecnie nie mamy dokumentacji ani narzędzi, które ułatwiają migrowanie istniejącej implementacji serwerów proxy usługi Functions do API Management.