Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Usługa Azure Functions zapewnia wbudowaną integrację z usługą Azure Event Grid przy użyciu wyzwalaczy i powiązań. W tym artykule pokazano, jak skonfigurować i lokalnie ocenić wyzwalacz i powiązania usługi Event Grid. Aby uzyskać więcej informacji na temat definicji i przykładów wyzwalacza usługi Event Grid oraz powiązań wyjściowych, zobacz jeden z następujących artykułów referencyjnych:
- Omówienie powiązań usługi Azure Event Grid
- Wyzwalacz usługi Azure Event Grid dla usługi Azure Functions
- Powiązanie wyjściowe usługi Azure Event Grid dla usługi Azure Functions
Tworzenie subskrypcji zdarzeń
Aby rozpocząć odbieranie żądań HTTP usługi Event Grid, potrzebujesz subskrypcji zdarzeń zgłaszanych przez usługę Event Grid. Subskrypcje zdarzeń określają adres URL punktu końcowego, który wywołuje funkcję. Gdy utworzysz subskrypcję zdarzeń na karcie Integracja swojej funkcji w portalu Azure, adres URL zostanie podany automatycznie. Jeśli programowo utworzysz subskrypcję zdarzeń lub podczas tworzenia subskrypcji zdarzeń z usługi Event Grid, musisz podać punkt końcowy. Adres URL punktu końcowego zawiera klucz systemowy, który należy uzyskać z interfejsów API REST administratora usługi Functions.
Pobierz adres URL punktu końcowego webhooka
Poniższy przykład przedstawia wzór URL dla funkcji wyzwalanej przez Event Grid:
https://{functionappname}.azurewebsites.net/runtime/webhooks/eventgrid?functionName={functionname}&code={systemkey}
Uwaga
Istnieje wersja wyzwalacza usługi Blob Storage, która używa również subskrypcji zdarzeń. Adres URL punktu końcowego dla tego typu wyzwalacza Blob Storage ma ścieżkę /runtime/webhooks/blobs, natomiast w przypadku wyzwalacza Event Grid ścieżka to /runtime/webhooks/EventGrid. Porównanie opcji przetwarzania obiektów blob znajduje się w artykule Wyzwalacz dla kontenera obiektów blob.
Uzyskiwanie klucza systemowego
Utworzony punkt końcowy adresu URL zawiera wartość klucza systemowego. Klucz systemowy jest kluczem autoryzacji przypisanym do webhooka usługi Event Grid, który musi być dołączony do żądania wysyłanego pod adres URL punktu końcowego wyzwalacza usługi Event Grid. W poniższej sekcji wyjaśniono, jak uzyskać klucz systemowy.
Klucz główny aplikacji funkcji można również pobrać w portalu w sekcji Functions>Klucze aplikacji.
Uwaga
Klucz główny zapewnia dostęp administratora do aplikacji funkcji. Nie udostępniaj tego klucza innym firmom ani nie rozpowszechniaj go w natywnych aplikacjach klienckich.
Aby uzyskać więcej informacji, zobacz Praca z kluczami dostępu w usłudze Azure Functions.
Klucz systemowy można pobrać ze swojej aplikacji funkcji za pomocą następujących interfejsów API administratora (HTTP GET):
http://{functionappname}.azurewebsites.net/admin/host/systemkeys/eventgrid_extension?code={masterkey}
Ten interfejs API REST jest interfejsem API dla administratora, więc wymaga klucza głównego aplikacji funkcji. Nie należy mylić klucza systemowego (służącego do wywoływania funkcji wyzwalanej przez usługę Event Grid) z kluczem głównym (służącym do wykonywania zadań administracyjnych w aplikacji funkcji). Podczas subskrybowania tematu usługi Event Grid pamiętaj, aby użyć klucza systemowego.
Oto przykład odpowiedzi, która udostępnia klucz systemowy:
{
"name": "eventgridextensionconfig_extension",
"value": "{the system key for the function}",
"links": [
{
"rel": "self",
"href": "{the URL for the function, without the system key}"
}
]
}
Tworzenie subskrypcji
Subskrypcję zdarzeń można utworzyć w witrynie Azure Portal lub przy użyciu interfejsu wiersza polecenia platformy Azure.
W przypadku funkcji tworzonych w witrynie Azure Portal za pomocą wyzwalacza usługi Event Grid wybierz pozycję Integracja , a następnie wybierz pozycję Wyzwalacz usługi Event Grid i wybierz pozycję Utwórz subskrypcję usługi Event Grid.
Po wybraniu tego linku portal otwiera stronę Tworzenie subskrypcji zdarzenia z już zdefiniowanym bieżącym punktem końcowym wyzwalacza.
Aby uzyskać więcej informacji na temat tworzenia subskrypcji przy użyciu witryny Azure Portal, zobacz Tworzenie zdarzeń niestandardowych — Azure Portal w dokumentacji usługi Event Grid.
Aby uzyskać więcej informacji na temat tworzenia subskrypcji, zobacz przewodnik Szybki start dotyczący usługi Blob Storage lub inne przewodniki Szybki start dotyczące usługi Event Grid.
Lokalne testowanie za pomocą aplikacji internetowej przeglądarki
Aby przetestować wyzwalacz usługi Event Grid lokalnie, musisz pobrać żądania HTTP usługi Event Grid dostarczone z ich źródła w chmurze do komputera lokalnego. Jednym ze sposobów na to jest przechwytywanie żądań w trybie online i ręczne ponowne wysyłanie ich na komputerze lokalnym:
- Utwórz aplikację internetową przeglądarki, która przechwytuje komunikaty o zdarzeniach.
- Utwórz subskrypcję usługi Event Grid, która wysyła zdarzenia do aplikacji przeglądarki.
- Wygeneruj żądanie i skopiuj treść żądania z aplikacji przeglądarki.
- Ręcznie wyślij żądanie na adres URL localhost funkcji wyzwalanej przez usługę Event Grid.
Aby wysłać żądanie postu HTTP, potrzebne jest narzędzie do testowania HTTP. Pamiętaj, aby wybrać narzędzie, które zapewnia bezpieczeństwo danych. Aby uzyskać więcej informacji, zobacz Narzędzia do testowania HTTP.
Po zakończeniu testowania możesz użyć tej samej subskrypcji dla środowiska produkcyjnego, aktualizując punkt końcowy. Użyj polecenia az eventgrid event-subscription update Azure CLI.
Utwórz aplikację internetową do wyświetlania
Aby uprościć przechwytywanie komunikatów o zdarzeniach, można wdrożyć wstępnie utworzoną aplikację internetową, która wyświetla komunikaty o zdarzeniach. Wdrożone rozwiązanie zawiera plan usługi App Service, aplikację internetową usługi App Service i kod źródłowy z repozytorium GitHub.
Wybierz pozycję Wdróż na platformę Azure, aby wdrożyć rozwiązanie do swojej subskrypcji. W witrynie Azure Portal podaj wartości parametrów.
Wdrożenie może potrwać kilka minut. Po pomyślnym wdrożeniu należy wyświetlić aplikację sieci Web i upewnić się, że jest uruchomiona. W przeglądarce sieci Web przejdź do: https://<your-site-name>.azurewebsites.net
Widzisz witrynę, ale nie opublikowano w niej jeszcze żadnych wydarzeń.
Tworzenie subskrypcji usługi Event Grid
Utwórz subskrypcję usługi Event Grid typu, który chcesz przetestować, i nadaj mu adres URL z aplikacji internetowej jako punkt końcowy powiadomienia o zdarzeniach. Punkt końcowy dla aplikacji internetowej musi zawierać sufiks /api/updates/. W związku z tym pełny adres URL to https://<your-site-name>.azurewebsites.net/api/updates
Aby uzyskać informacje o sposobie tworzenia subskrypcji przy użyciu witryny Azure Portal, zobacz Tworzenie zdarzeń niestandardowych — Azure Portal w dokumentacji usługi Event Grid.
Generowanie żądania
Wyzwalanie zdarzenia, które spowoduje wygenerowanie ruchu HTTP do punktu końcowego aplikacji internetowej. Na przykład jeśli utworzysz subskrypcję usługi Blob Storage, prześlij lub usuń obiekt blob. Gdy żądanie pojawi się w aplikacji internetowej, skopiuj treść żądania.
Żądanie weryfikacji subskrypcji zostanie odebrane jako pierwsze; ignoruj wszystkie żądania weryfikacji i skopiuj żądanie zdarzenia.
Ręczne publikowanie żądania
Uruchom lokalnie funkcję usługi Event Grid. Nagłówki Content-Type i aeg-event-type należy ustawić ręcznie, natomiast wszystkie pozostałe wartości można pozostawić jako domyślne.
Użyj narzędzia do testowania HTTP, aby utworzyć żądanie HTTP POST:
Ustaw nagłówek
Content-Type: application/json.aeg-event-type: NotificationUstaw nagłówek.Wklej dane RequestBin do treści żądania.
Wyślij żądanie HTTP POST do punktu końcowego, który ręcznie uruchamia wyzwalacz usługi Event Grid.
http://localhost:7071/runtime/webhooks/eventgrid?functionName={FUNCTION_NAME}
Parametr functionName musi być nazwą określoną w atrybucie FunctionName .
Funkcja wyzwalana przez usługę Event Grid uruchamia się i wyświetla dzienniki podobne do przedstawionych w poniższym przykładzie:
Następne kroki
Aby dowiedzieć się więcej o usłudze Event Grid z usługą Functions, zobacz następujące artykuły: