Freigeben über

Schnellstart: Verwenden von Azure Event Grid zum Senden von Blob Storage-Ereignissen an einen Webendpunkt (Azure-Portal)

  • Artikel

Event Grid ist ein vollständig verwalteter Dienst, mit dem Sie Ereignisse problemlos über viele verschiedene Azure-Dienste und -Anwendungen hinweg verwalten können. Er vereinfacht das Erstellen ereignisgesteuerter und serverloser Anwendungen. Eine Übersicht über den Dienst finden Sie unter Übersicht über Event Grid.

Sollten Sie über kein Azure-Abonnement verfügen, können Sie zunächst ein kostenloses Azure-Konto erstellen.

Am Ende sehen Sie, dass die Ereignisdaten an die Web-App gesendet werden.

Screenshot: Beispiel für Azure Event Grid-Viewer-App mit einem Ereignis

Speicherkonto erstellen

  1. Melden Sie sich beim Azure-Portalan.

  2. Wählen Sie zum Erstellen eines Blobspeichers die Option Ressource erstellen.

  3. Geben Sie unter Suchen den Begriff Speicherkonto ein, und wählen Sie in der Ergebnisliste Speicherkonto aus.

    Screenshot der Suche nach „Speicherkonto“ auf der Seite „Ressource erstellen“

  4. Wählen Sie auf der Seite Speicherkonto die Option Erstellen aus, um mit der Erstellung des Speicherkontos zu beginnen. Um Ereignisse zu abonnieren, erstellen Sie entweder ein Speicherkonto vom Typ „general-purpose v2“ oder ein Blobspeicherkonto.

  5. Führen Sie auf der Seite Speicherkonto erstellen die folgenden Schritte aus:

    1. Wählen Sie Ihr Azure-Abonnement.

    2. Erstellen Sie unter Ressourcengruppe eine neue Ressourcengruppe, oder wählen Sie eine vorhandene aus.

    3. Geben Sie den Namen für Ihr Speicherkonto ein.

    4. Wählen Sie die Region aus, in der das Speicherkonto erstellt werden sollen.

    5. Wählen Sie für Primärer Dienst die Option Azure Blob Storage oder Azure Data Lake Storage Gen 2 aus.

    6. Wählen Sie unter Redundanz in der Dropdownliste die Option Lokal redundanter Speicher (LRS) aus.

    7. Wählen Sie am unteren Rand der Seite die Option Bewerten + erstellen aus.

      Screenshot der Seite „Speicherkonto erstellen“

    8. Überprüfen Sie die Einstellungen auf der Registerkarte Überprüfen und erstellen, und wählen Sie Erstellen aus.

      Hinweis

      Nur Speicherkonten vom Typ StorageV2 (universell, Version 2) und BlobStorage unterstützen die Ereignisintegration. Storage (Universell V1) unterstützt nicht die Integration in Event Grid.

  6. Die Bereitstellung dauert einige Minuten. Wählen Sie auf der Seite Bereitstellung die Option Zu Ressource wechseln aus.

    Screenshot: Seite „Bereitstellung erfolgreich“ mit einem Link zur Ressource.

  7. Wählen Sie auf der Seite Speicherkonto im linken Menü die Option Ereignisse aus.

    Screenshot: Seite „Ereignisse“ für ein Azure-Speicherkonto.

  8. Lassen Sie diese Seite im Webbrowser geöffnet.

Erstellen eines Nachrichtenendpunkts

Vor dem Abonnieren der Ereignisse für den Blobspeicher erstellen wir zunächst den Endpunkt für die Ereignisnachricht. Der Endpunkt führt in der Regel Aktionen auf der Grundlage der Ereignisdaten aus. Um diesen Schnellstart zu vereinfachen stellen Sie eine vorab erstellte Web-App bereit, welche die Ereignisnachrichten anzeigt. Die bereitgestellte Lösung umfasst einen App Service-Plan, eine App Service-Web-App und Quellcode von GitHub.

  1. Wählen Sie Deploy to Azure (In Azure bereitstellen), um die Lösung für Ihr Abonnement bereitzustellen.

    Schaltfläche zum Bereitstellen der Resource Manager-Vorlage in Azure.

  2. Gehen Sie auf der Seite Benutzerdefinierte Bereitstellung wie folgt vor:

    1. Wählen Sie unter Ressourcengruppe die Ressourcengruppe aus, die Sie beim Erstellen des Speicherkontos erstellt haben. Dadurch muss zur Bereinigung nach Abschluss des Tutorials einfach nur die Ressourcengruppe gelöscht werden.

    2. Geben Sie unter Websitename einen Namen für die Web-App ein.

    3. Geben Sie unter Name des Hostingplans einen Namen für den App Service-Plan zum Hosten der Web-App ein.

    4. Klicken Sie auf Überprüfen + erstellen.

      Screenshot der Seite „Benutzerdefinierte Bereitstellung“

  3. Wählen Sie auf der Seite Überprüfen + erstellen die Option Erstellen aus.

  4. Die Bereitstellung dauert einige Minuten. Wählen Sie auf der Seite Bereitstellung die Option Zu Ressourcengruppe wechseln aus.

    Screenshot: Seite „Bereitstellung erfolgreich“ mit einem Link zur Ressourcengruppe.

  5. Wählen Sie auf der Seite Ressourcengruppe in der Ressourcenliste die von Ihnen erstellte Web-App aus. In dieser Liste werden auch der App Service-Plan und das Speicherkonto angezeigt.

    Screenshot: Auswahl der Web-App in der Ressourcengruppe.

  6. Wählen Sie auf der Seite App Service für Ihre Web-App die URL aus, um zur entsprechenden Website zu navigieren. Die URL muss folgendes Format haben: https://<your-site-name>.azurewebsites.net.

    Screenshot: Auswahl des Links zum Navigieren zur Web-App.

  7. Vergewissern Sie sich, dass die Website angezeigt wird, aber noch keine Ereignisse veröffentlicht wurden.

    Anzeigen der neuen Website.

    Wichtig

    Lassen Sie das Fenster „Azure Event Grid-Viewer“ geöffnet, sodass Sie Ereignisse anzeigen können, wenn diese veröffentlicht werden.

Abonnieren des Blobspeichers

Sie abonnieren ein Thema, um Event Grid mitzuteilen, welche Ereignisse Sie nachverfolgen möchten und wohin diese gesendet werden sollen.

  1. Wenn Sie die Seite Speicherkonto geschlossen haben, navigieren Sie zu Ihrem Azure Storage-Konto, das Sie zuvor erstellt haben. Wählen Sie im linken Menü die Option Alle Ressourcen und anschließend Ihr Speicherkonto aus.

  2. Wählen Sie auf der Seite Speicherkonto im linken Menü die Option Ereignisse aus.

  3. Wählen Sie Weitere Optionen und dann Webhook. Sie verwenden einen Webhook für den Endpunkt, um Ereignisse an Ihre Viewer-App zu senden.

    Screenshot: Auswahl der Seite „Webhook“ auf der Seite „Ereignisse“.

  4. Führen Sie auf der Seite Ereignisabonnement erstellen die folgenden Schritte aus:

    1. Geben Sie unter Name einen Namen für das Ereignisabonnement an.

    2. Geben Sie unter Name einen Namen für das Systemthema ein. Informationen zu Systemthemen finden Sie unter Übersicht über Systemthemen.

    3. Vergewissern Sie sich, dass Endpunkttyp auf Webhook festgelegt ist.

      Screenshot: Seite „Ereignisabonnement erstellen“ mit einem Namen für das Systemthema.

  5. Wählen Sie unter Endpunkt die Option Endpunkt konfigurieren aus, geben Sie die URL Ihrer Web-App ein, fügen Sie api/updates zur URL der Startseite hinzu (Beispiel: https://spegridsite.azurewebsites.net/api/updates), und wählen Sie anschließend Auswahl bestätigen aus.

    Screenshot: Auswahl der Seite „Webhook auswählen“.

  6. Wählen Sie als Nächstes auf der Seite Ereignisabonnement erstellen die Option Erstellen aus, um das Ereignisabonnement zu erstellen.

    Screenshot: Seite „Ereignisabonnement erstellen“ mit Auswahl aller Felder.

  7. Zeigen Sie wieder Ihre Web-App an. Wie Sie sehen, wurde ein Abonnementüberprüfungsereignis an sie gesendet. Klicken Sie auf das Augensymbol, um die Ereignisdaten zu erweitern. Event Grid sendet das Überprüfungsereignis, damit der Endpunkt bestätigen kann, dass er Ereignisdaten empfangen möchte. Die Web-App enthält Code zur Überprüfung des Abonnements.

    Screenshot: Event Grid Viewer mit dem Abonnementüberprüfungsereignis.

Als Nächstes lösen wir ein Ereignis aus, um zu sehen, wie Event Grid die Nachricht an Ihren Endpunkt weiterleitet.

Senden eines Ereignisses an Ihren Endpunkt

Sie lösen ein Ereignis für den Blobspeicher aus, indem Sie eine Datei hochladen. Für die Datei ist kein spezifischer Inhalt erforderlich.

  1. Navigieren Sie im Azure-Portal zu Ihrem Blob Storage-Konto, und wählen Sie im Menü links die Option Container aus.

  2. Wählen Sie + Container aus. Geben Sie Ihrem Container einen Namen, verwenden Sie eine beliebige Zugriffsebene, und wählen Sie dann Erstellen aus.

    Screenshot: Seite „Neuer Container“.

  3. Wählen Sie Ihren neuen Container aus.

    Screenshot: Auswahl des Containers.

  4. Wählen Sie die Option Hochladen, um eine Datei hochzuladen. Navigieren Sie auf der Seite Blob hochladen zu einer Datei, die Sie zu Testzwecken hochladen möchten, wählen Sie sie aus, und wählen Sie auf dieser Seite anschließend Hochladen aus.

    Screenshot: Seite „Blob hochladen“, um ein Beispielbild hochzuladen

  5. Navigieren Sie zu Ihrer Testdatei, und laden Sie sie hoch.

  6. Sie haben das Ereignis ausgelöst, und Event Grid hat die Nachricht an den Endpunkt gesendet, den Sie beim Abonnieren konfiguriert haben. Die Nachricht weist das JSON-Format auf und enthält ein Array mit mindestens einem Ereignis. Im folgenden Beispiel enthält die JSON-Nachricht ein Array mit einem Ereignis. Zeigen Sie Ihre Web-App an. Wie Sie sehen, wurde ein Ereignis vom Typ Blob erstellt empfangen.

    Screenshot: Seite „Event Grid Viewer“ mit dem Ereignis „Blob erstellt“.

Bereinigen von Ressourcen

Wenn Sie dieses Ereignis weiterverwenden möchten, können Sie die Bereinigung der in diesem Artikel erstellten Ressourcen überspringen. Löschen Sie andernfalls die Ressourcen, die Sie in diesem Artikel erstellt haben.

Wählen Sie die Ressourcengruppe aus, und klicken Sie auf Ressourcengruppe löschen.

Zugehöriger Inhalt

Sie haben gelernt, wie Sie benutzerdefinierte Themen und Ereignisabonnements erstellen. Nun können Sie sich ausführlicher darüber informieren, welche Möglichkeiten Event Grid bietet: