Wykonywanie funkcji platformy Azure przy użyciu żądania HTTP
Żądanie HTTP jest typową operacją na większości platform i urządzeń. Niezależnie od tego, czy jest to żądanie wyszukania wyrazu w słowniku, czy pozyskania danych o lokalnej pogodzie, cały czas wysyłamy żądania HTTP. Usługa Azure Functions umożliwia szybkie utworzenie fragmentu logiki do wykonania w momencie odebrania żądania HTTP.
W tej lekcji dowiesz się, jak utworzyć i wywołać funkcję przy użyciu wyzwalacza HTTP. Zapoznasz się również z niektórymi opcjami dostosowywania dostępnymi dla wyzwalaczy HTTP.
Czym jest wyzwalacz HTTP?
Wyzwalacz HTTP to wyzwalacz, który wykonuje kod po odebraniu żądania HTTP. Wyzwalacze HTTP mają wiele możliwości i opcji dostosowania, w tym:
- Zapewnianie autoryzowanego dostępu przez podanie kluczy.
- Ograniczanie obsługiwanych czasowników HTTP.
- Zwracanie danych z powrotem do obiektu wywołującego.
- Odbieranie danych za pośrednictwem parametrów ciągu zapytania lub treści żądania.
- Obsługa szablonów tras adresów URL w celu zmodyfikowania adresu URL funkcji.
Podczas tworzenia wyzwalacza HTTP należy podać nazwę wyzwalacza i wybrać poziom autoryzacji.
Co to jest poziom autoryzacji wyzwalacza HTTP?
Poziom autoryzacji wyzwalacza HTTP to flaga wskazująca, czy przychodzące żądanie HTTP wymaga klucza interfejsu API do autoryzacji.
Istnieją trzy poziomy autoryzacji:
- Function
- Anonimowe
- Administracja
Poziomy Funkcja i Administrator są oparte na „kluczu”. Aby wysłać żądanie HTTP, musisz podać klucz do autoryzacji. Istnieją dwa typy kluczy: funkcja i host. Oba typy kluczy różnią się zakresami. Klucze funkcji są specyficzne dla funkcji. Klucze hosta dotyczą wszystkich funkcji w aplikacji funkcji. Jeśli poziom autoryzacji jest ustawiony na opcję Funkcja, możesz użyć klucza funkcji lub hosta. Jeśli poziom autoryzacji jest ustawiony na opcję Administrator, należy podać klucz hosta.
Ważne
Ponieważ klucze hosta zapewniają podwyższony poziom dostępu do aplikacji funkcji, należy bezpiecznie je transportować i przechowywać.
Poziom Anonimowy oznacza, że autoryzacja nie jest wymagana. W tym ćwiczeniu jest używany poziom autoryzacji anonimowej.
Sposób tworzenia wyzwalacza HTTP
Podobnie jak w przypadku wyzwalacza czasomierza możesz utworzyć wyzwalacz HTTP za pośrednictwem witryny Azure Portal. Wewnątrz funkcji platformy Azure wybierz pozycję Wyzwalacz HTTP z listy wstępnie zdefiniowanych typów wyzwalaczy, a następnie wprowadź logikę, którą chcesz wykonać, i wprowadź wszelkie dostosowania, takie jak ograniczenie użycia określonych czasowników HTTP.
Ustawienie, którego zrozumienie jest ważne, to Nazwa parametru żądania. To ustawienie jest ciągiem reprezentującym nazwę parametru, który zawiera informacje o przychodzącym żądaniu HTTP. Domyślnie nazwa parametru to req.
Sposób wywoływania wyzwalacza HTTP
Aby wywołać wyzwalacz HTTP, należy wysłać żądanie HTTP do adresu URL funkcji. Aby uzyskać ten adres URL, przejdź do strony kodu funkcji i wybierz link Pobierz adres URL funkcji.
Po utworzeniu adresu URL dla funkcji możesz wysłać żądania HTTP. Jeśli funkcja odbiera dane, pamiętaj, że możesz użyć parametrów ciągu zapytania lub podać dane za pośrednictwem treści żądania.
Wyzwalacz HTTP jest wykonywany po odebraniu żądania HTTP do adresu URL funkcji. Wyzwalacze HTTP umożliwiają odbieranie danych, wykonywanie logiki i opcjonalnie zwracanie danych z powrotem do obiektu wywołującego.