Azure Event Grid gebruiken om Blob Storage-gebeurtenissen te routeren naar een webeindpunt (Azure Portal)

Event Grid is een volledig beheerde service waarmee u eenvoudig gebeurtenissen in veel verschillende Azure-services en -toepassingen kunt beheren. Het vereenvoudigt het bouwen van gebeurtenisgestuurde en serverloze toepassingen. Zie Event Grid-overzicht voor een overzicht van de service.

In dit artikel gebruikt u Azure Portal om de volgende taken uit te voeren:

  1. Maak een Blob Storage-account.
  2. Abonneer u op gebeurtenissen voor die blobopslag.
  3. Activeer een gebeurtenis door een bestand te uploaden naar de blobopslag.
  4. Bekijk het resultaat in een handler-web-app. Normaal gesproken verzendt u gebeurtenissen naar een eindpunt dat de gebeurtenisgegevens verwerkt en vervolgens in actie komt. Om het eenvoudig te houden, verzendt u gebeurtenissen naar een web-app die de berichten verzamelt en weergeeft.

Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account maken voordat u begint.

Wanneer u klaar bent, ziet u dat de gebeurtenisgegevens naar de web-app zijn verzonden.

Screenshot that shows the sample Azure Event Grid Viewer app with an event.

Een opslagaccount maken

  1. Meld u aan bij de Azure-portal.

  2. Selecteer Een resource maken als u een Blob-opslag wilt maken.

  3. Voer in de zoekfunctie opslagaccount in en selecteer Opslagaccount in de lijst met resultaten.

    Screenshot showing the search for Storage account on the Create a resource page.

  4. Selecteer Op de pagina Opslagaccount maken de optie Maken om het opslagaccount te maken. Voor het abonneren op gebeurtenissen moet u een algemeen v2-opslagaccount of een Blob-opslagaccount maken.

  5. Voer op de pagina Opslagaccount maken de volgende stappen uit:

    1. Selecteer uw Azure-abonnement.

    2. Geef voor Resourcegroep een nieuwe resourcegroep op of selecteer een bestaande.

    3. Voer de naam van uw opslagaccount in.

    4. Selecteer de regio waarin u het opslagaccount wilt maken.

    5. Selecteer voor redundantie lokaal redundante opslag (LRS) in de vervolgkeuzelijst.

    6. Selecteer Controleren onder aan de pagina.

      Screenshot showing the Create a storage account page.

    7. Controleer de instellingen op de pagina Controleren en selecteer Maken.

      Notitie

      Alleen opslagaccounts van het type StorageV2 (algemeen gebruik v2) en integratie van BlobStorage- ondersteuningsgebeurtenissen. Opslag (algemeen gebruik v1) biedt geen ondersteuning voor integratie met Event Grid.

  6. Het duurt enkele minuten om de implementatie te voltooien. Selecteer Naar de resource gaan op de pagina Implementatie.

    Screenshot showing the deployment succeeded page with a link to go to the resource.

  7. Selecteer op de pagina Opslagaccount de optie Gebeurtenissen in het linkermenu.

    Screenshot showing the Events page for an Azure storage account.

  8. Houd deze pagina geopend in de webbrowser.

Het eindpunt van een bericht maken

Voordat u zich kunt abonneren op gebeurtenissen voor de Blob-opslag, moet u het eindpunt voor het gebeurtenisbericht maken. Het eindpunt onderneemt normaal gesproken actie op basis van de gebeurtenisgegevens. Ter vereenvoudiging van deze quickstart implementeert u een vooraf gemaakte web-app die de gebeurtenisberichten weergeeft. De geïmplementeerde oplossing omvat een App Service-plan, een App Service-web-app en broncode van GitHub.

  1. Selecteer Implementeren in Azure om de oplossing voor uw abonnement te implementeren.

    Button to deploy the Resource Manager template to Azure.

  2. Voer op de pagina Aangepaste implementatie de volgende stappen uit:

    1. Selecteer voor Resourcegroep de resourcegroep die u hebt gemaakt toen u het opslagaccount maakte. Het is eenvoudiger om op te schonen nadat u klaar bent met de zelfstudie door de resourcegroep te verwijderen.

    2. Voer in het vak Sitenaam een naam in voor de web-app.

    3. Voer voor Naam van hostingplan een naam in voor het App Service-plan dat u wilt gebruiken voor het hosten van de web-app.

    4. Selecteer Controleren + maken.

      Screenshot showing the Custom deployment page.

  3. Selecteer Maken op de pagina Beoordelen en maken.

  4. Het duurt enkele minuten om de implementatie te voltooien. Selecteer Op de pagina Implementatie de optie Ga naar de resourcegroep.

    Screenshot showing the deployment succeeded page with a link to go to the resource group.

  5. Selecteer in de lijst met resources op de pagina Resourcegroep de web-app die u hebt gemaakt. U ziet ook het App Service-plan en het opslagaccount in deze lijst.

    Screenshot that shows the selection of web app in the resource group.

  6. Selecteer op de pagina App Service voor uw web-app de URL om naar de website te gaan. De URL moet de volgende indeling hebben: https://<your-site-name>.azurewebsites.net.

    Screenshot that shows the selection of link to navigate to web app.

  7. Controleer of de site wordt weergegeven en dat er zijn nog geen gebeurtenissen naar zijn gepost.

    View new site.

    Belangrijk

    Houd het venster Azure Event Grid Viewer geopend, zodat u gebeurtenissen kunt zien terwijl ze worden gepost.

De Event Grid-resourceprovider registreren

Tenzij u Event Grid eerder hebt gebruikt, moet u de Event Grid-resourceprovider registreren. Als u Event Grid eerder hebt gebruikt, gaat u verder met de volgende sectie.

Voer in Azure Portal de volgende stappen uit:

  1. Selecteer Abonnementen in het linkermenu.

  2. Selecteer het abonnement dat u wilt gebruiken voor Event Grid in de lijst met abonnementen.

  3. Selecteer op de pagina Abonnement resourceproviders onder Instellingen in het linkermenu.

  4. Zoek naar Microsoft.EventGrid en controleer of de status niet is geregistreerd.

  5. Selecteer Microsoft.EventGrid in de lijst met providers.

  6. Selecteer Registreren op de opdrachtbalk.

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

  7. Vernieuwen om ervoor te zorgen dat de status van Microsoft.EventGrid wordt gewijzigd in Geregistreerd.

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

Abonneren op de Blob-opslag

U abonneert u op een onderwerp om Event Grid te laten weten welke gebeurtenissen u wilt traceren en waar de gebeurtenissen naartoe moeten worden gestuurd.

  1. Als u de pagina Opslagaccount hebt gesloten, gaat u naar uw Azure Storage-account dat u eerder hebt gemaakt. Selecteer in het menu aan de linkerkant Alle resources en selecteer uw opslagaccount.

  2. Selecteer op de pagina Opslagaccount de optie Gebeurtenissen in het linkermenu.

  3. Selecteer Meer opties en Webhook. U verzendt gebeurtenissen naar uw viewer-app met behulp van een webhook voor het eindpunt.

    Screenshot showing the selection of Web Hook on the Events page.

  4. Voer op de pagina Gebeurtenisabonnement maken de volgende stappen uit:

    1. Voer een naam in voor het gebeurtenisabonnement.

    2. Voer een naam in voor het systeemonderwerp. Zie Overzicht van systeemonderwerpen voor meer informatie over systeemonderwerpen.

      Screenshot showing the Create Event Subscription page with a name for the system topic.

    3. Selecteer Webhook voor het Eindpunttype.

      Screenshot showing the Create Event Subscription page with Web Hook selected as an endpoint.

  5. Voor Eindpunt kiest u Een eindpunt selecteren en voert u de URL van uw web-app in en voegt u deze toe api/updates aan de URL van de startpagina (bijvoorbeeld: https://spegridsite.azurewebsites.net/api/updates) en selecteert u Vervolgens Selectie bevestigen.

    Screenshot showing the Select Web Hook page.

  6. Selecteer nu op de pagina Gebeurtenisabonnement maken de optie Maken om het gebeurtenisabonnement te maken.

    Screenshot showing the Create Event Subscription page with all fields selected.

  7. Bekijk opnieuw uw web-app en u zult zien dat er een validatiegebeurtenis voor een abonnement naartoe is verzonden. Selecteer het oogpictogram om de gebeurtenisgegevens uit te breiden. Via Event Grid wordt de validatiegebeurtenis verzonden zodat het eindpunt kan controleren of de gebeurtenisgegevens in aanmerking komen om ontvangen te worden. De web-app bevat code waarmee het abonnement kan worden gevalideerd.

    Screenshot showing the Event Grid Viewer with the subscription validation event.

Nu gaan we een gebeurtenis activeren om te zien hoe het bericht via Event Grid naar het eindpunt wordt gedistribueerd.

Een gebeurtenis verzenden naar het eindpunt

U activeert een gebeurtenis voor de Blob-opslag door een bestand te uploaden. Het bestand heeft geen specifieke inhoud nodig.

  1. Navigeer in Azure Portal naar uw Blob Storage-account en selecteer Containers in het menu Let.

  2. Selecteer + Container. Geef uw container een naam en gebruik elk toegangsniveau en selecteer Maken.

    Screenshot showing the New container page.

  3. Selecteer de nieuwe container.

    Screenshot showing the selection of the container.

  4. Als u een bestand wilt uploaden, selecteert u Uploaden. Blader op de pagina Blob uploaden naar het bestand dat u wilt uploaden om te testen en selecteer Uploaden.

    Screenshot showing Upload blob page.

  5. Blader naar het testbestand en upload het.

  6. U hebt de gebeurtenis geactiveerd en Event Grid heeft het bericht verzonden naar het eindpunt dat u hebt geconfigureerd toen u zich abonneerde. Het bericht heeft de JSON-indeling en bevat een matrix met een of meer gebeurtenissen. In het volgende voorbeeld bevat het JSON-bericht een matrix met één gebeurtenis. Wanneer u uw web-app bekijkt, ziet u dat er een blob-gebeurtenis is ontvangen.

    Screenshot showing the Event Grid Viewer page with the Blob Created event.

Resources opschonen

Als u verder wilt werken met deze gebeurtenis, schoon dan de resources die u in dit artikel hebt gemaakt, niet op. Verwijder anders de resources die u in dit artikel hebt gemaakt.

Selecteer de resourcegroep en klik op Resourcegroep verwijderen.

Volgende stappen

U weet nu hoe u aangepaste onderwerpen maakt en hoe u zich abonneert op een gebeurtenis. Kijk waar Event Grid u nog meer bij kan helpen: