Delen via


Quickstart: 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.

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 worden verzonden.

Schermopname van de voorbeeld-app Azure Event Grid Viewer met een gebeurtenis.

Een opslagaccount maken

  1. Meld u aan bij het 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.

    Schermopname van de zoekopdracht naar opslagaccount op de pagina Een resource maken.

  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 in voor uw opslagaccount.

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

    5. Voor de primaire service selecteert u Azure Blob Storage of Azure Data Lake Storage Gen 2.

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

    7. Selecteer Controleren en maken onderaan de pagina.

      Schermopname van de pagina Een opslagaccount maken.

    8. Controleer op het tabblad Controleren en maken de instellingen 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.

    Schermopname van de pagina geslaagde implementatie met een koppeling om naar de resource te gaan.

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

    Schermopname van de pagina Gebeurtenissen voor een Azure-opslagaccount.

  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.

    Knop voor het implementeren van de Resource Manager-sjabloon in 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.

      Schermopname van de pagina Aangepaste implementatie.

  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.

    Schermopname van de pagina geslaagde implementatie met een koppeling om naar de resourcegroep te gaan.

  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.

    Schermopname van de selectie van web-app in de resourcegroep.

  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.

    Schermopname van de selectie van de koppeling om naar de web-app te navigeren.

  7. Controleer of u de site ziet, maar dat er nog geen gebeurtenissen op de site zijn geplaatst.

    Nieuwe site weergeven.

    Belangrijk

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

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.

    Schermopname van de selectie van Webhook op de pagina Gebeurtenissen.

  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.

    3. Controleer of het eindpunttype is ingesteld op Webhook.

      Schermopname van de pagina Gebeurtenisabonnement maken met een naam voor het systeemonderwerp.

  5. Voor Eindpunt selecteert u Een eindpunt configureren 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.

    Schermopname van de pagina Webhook selecteren.

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

    Schermopname van de pagina Gebeurtenisabonnement maken met alle velden geselecteerd.

  7. Bekijk uw web-app opnieuw en u ziet dat er een validatie-gebeurtenis voor het abonnement naar de app wordt 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.

    Schermopname van de Event Grid Viewer met de gebeurtenis voor abonnementsvalidatie.

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.

    Schermopname van de pagina Nieuwe container.

  3. Selecteer de nieuwe container.

    Schermopname van de selectie van de 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.

    Schermopname van de pagina Blob uploaden om een voorbeeldafbeelding te uploaden.

  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 bij het abonneren. 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.

    Schermopname van de pagina Event Grid Viewer met de gebeurtenis Blob Created.

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.

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: