Gebruik Azure Event Grid om Blob Storage-gebeurtenissen naar het web-eindpunt te Azure Portal)

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

In dit artikel gebruikt u de 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 waarmee de berichten worden verzameld en weergegeven.

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

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

Resultaten weergeven.

Create a storage account

  1. Meld u aan bij de Azure-portal.

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

  3. Voer in Zoeken het Storage account in en selecteer Storage account in de lijst met resultaten.

    Schermopname van de zoekopdracht naar Storage account op de pagina Een resource maken.

  4. Selecteer op Storage de pagina Account maken om te beginnen met het maken van het opslagaccount. 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 van uw opslagaccount.

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

    5. Bij Redundantie selecteert u Lokaal redundante opslag (LRS) in de vervolgkeuzelijst.

    6. Selecteer Controleren + maken.

      Schermopname van de pagina Een opslagaccount maken.

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

      Notitie

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

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 snelstart gaat u een vooraf gebouwde web-app implementeren waarmee de gebeurtenisberichten worden weergegeven. 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 to Aquent.

  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 voor u eenvoudiger om op te schonen door de resourcegroep te verwijderen wanneer u klaar bent met de zelfstudie.

    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 op de pagina Beoordelen en maken de optie Maken.

  4. De implementatie kan enkele minuten duren. Selecteer Waarschuwingen (belpictogram) in de portal en selecteer vervolgens Naar de resourcegroep gaan.

    Waarschuwing: navigeer naar de resourcegroep.

  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.

    Selecteer website.

  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.

    Navigeer naar de website.

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

    Nieuwe site weergeven.

Event Grid-resourceprovicer inschakelen

Als u Event Grid in uw Azure-abonnement nog niet eerder hebt gebruikt, moet u mogelijk de Event Grid-resourceprovider registreren.

In Azure Portal:

  1. Selecteer Abonnementen in het menu links.
  2. Selecteer het abonnement dat u voor Event Grid gebruikt.
  3. Selecteer onder Instellingen in het menu links de optie Resourceproviders.
  4. Zoek Microsoft.EventGrid.
  5. Als deze niet is geregistreerd, selecteert u Registreren.

Het kan even duren voordat de registratie is voltooid. Selecteer Vernieuwen om de status bij te werken. Wanneer de Status****Geregistreerde is, bent u klaar om verder te gaan.

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. Navigeer in de portal 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.

    Selecteer web hook.

  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.

      Voer namen in voor gebeurtenisabonnement en systeemonderwerp.

    3. Selecteer Webhook voor het Eindpunttype.

      Selecteer het eindpunttype van de web hook.

  5. Klik bij Eindpunt op Een eindpunt selecteren en voer de URL van uw web-app in. Voeg api/updates toe aan de URL van de startpagina (bijvoorbeeld https://spegridsite.azurewebsites.net/api/updates) en selecteer Selectie bevestigen.

    Bevestig de eindpuntselectie.

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

    Selecteer logboeken.

  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.

    Abonnementsgebeurtenis weergeven.

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. In de artikelen wordt ervan uitgegaan dat u een bestand met de naam testfile.txt hebt, maar het bestand kan elke willekeurige naam hebben.

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

  2. Selecteer + Container. Geef de container een naam en gebruik een willekeurig toegangsniveau. Selecteer Maken.

    Voeg container toe.

  3. Selecteer de nieuwe container.

    Selecteer 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.

    Selecteer 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 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.

    Gebeurtenis gemaakt in blob.

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: