Erstellen und Überwachen von Media Services-Ereignissen mit Event Grid über das Azure-Portal

Media Services-Logo v3


Warnung

Azure Media Services wird am 30. Juni 2024 eingestellt. Weitere Informationen finden Sie im Leitfaden zur Einstellung von AMS.

Azure Event Grid ist ein Ereignisdienst für die Cloud. Dieser Dienst verwendet Ereignisabonnements zum Weiterleiten von Ereignisnachrichten an Abonnenten. Media Services-Ereignisse enthalten alle Informationen, die Sie zur Reaktion auf Änderungen in Ihren Daten benötigen. Sie können ein Media Services-Ereignis daran erkennen, dass die Eigenschaft „eventType“ mit „Microsoft.Media“ beginnt.

In diesem Artikel verwenden Sie das Azure-Portal, um Ereignisse für Ihr Azure Media Services-Konto zu abonnieren. Anschließend lösen Sie Ereignisse aus, um das Ergebnis anzuzeigen. Üblicherweise senden Sie Ereignisse an einen Endpunkt, der die Ereignisdaten verarbeitet und entsprechende Aktionen ausführt. In diesem Artikel senden wir Ereignisse an eine Web-App, die die Nachrichten sammelt und anzeigt.

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

Voraussetzungen

Erstellen eines Nachrichtenendpunkts

Vor dem Abonnieren der Ereignisse für das Media Services-Konto erstellen wir zunächst den Endpunkt für die Ereignisnachricht. Der Endpunkt führt in der Regel Aktionen auf der Grundlage der Ereignisdaten aus. In diesem Artikel stellen Sie eine vorgefertigte Web-App bereit, die die Ereignismeldungen anzeigt. Die bereitgestellte Lösung umfasst einen App Service-Plan, eine App Service-Web-App und Quellcode von GitHub.

  1. Wählen Sie unten den Link In Azure bereitstellen aus, um die Lösung für Ihr Abonnement bereitzustellen. Geben Sie im Azure-Portal Werte für die Parameter an.

    Bereitstellen in Azure

  2. Die Bereitstellung kann einige Minuten dauern. Nach erfolgreichem Abschluss der Bereitstellung können Sie Ihre Web-App anzeigen und sich vergewissern, dass sie ausgeführt wird. Navigieren Sie hierzu in einem Webbrowser zu https://<your-site-name>.azurewebsites.net.

Wenn Sie zur Seite „Azure Event Grid Viewer“ wechseln, werden Sie erkennen, dass sie noch nicht über Ereignisse verfügt.

Abonnieren von Media Services-Ereignissen

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

  1. Wählen Sie im Portal Ihr Media Services-Konto und dann Ereignisse aus.

  2. Verwenden Sie zum Senden von Ereignissen an Ihre Viewer-App einen Webhook für den Endpunkt.

  3. Das Ereignisabonnement wird mit den Werten für Ihr Media Services-Konto aufgefüllt.

  4. Wählen Sie als Endpunkttyp die Option „Webhook“ aus.

  5. Unter diesem Thema lassen wir das Kontrollkästchen Alle Ereignistypen abonnieren aktiviert. Sie können es jedoch deaktivieren und nach bestimmten Ereignistypen filtern.

  6. Wählen Sie den Link Endpunkt auswählen aus. Geben Sie für den Webhookendpunkt die URL Ihrer Web-App an, und fügen Sie api/updates der URL der Startseite hinzu.

  7. Klicken Sie auf Auswahl bestätigen.

  8. Klicken Sie auf Erstellen.

  9. Geben Sie Ihrem Abonnement einen Namen.

  10. Zeigen Sie wieder Ihre Web-App an. Wie Sie sehen, wurde ein Abonnementüberprüfungsereignis an sie gesendet.

    Event Grid sendet das Überprüfungsereignis, damit der Endpunkt bestätigen kann, dass er Ereignisdaten empfangen möchte. Der Endpunkt muss validationResponse auf validationCode festlegen. Weitere Informationen finden Sie unter Event Grid – Sicherheit und Authentifizierung. Sie können den Web-App-Code anzeigen, um zu sehen, wie das Abonnement überprüft wird.

Anschließend werden Ereignisse ausgelöst, um zu sehen, wie Event Grid die Nachricht an Ihren Endpunkt weiterleitet.

Senden eines Ereignisses an Ihren Endpunkt

Sie können Ereignisse für das Media Services-Konto auslösen, indem Sie einen Codierungsauftrag ausführen. Erstellen Sie eine Transformation und einen Auftrag im Portal, um Ereignisse auszulösen.

Media Services-Schema

Weitere Informationen zu allen für Media Services verfügbaren Metriken finden Sie unter Media Services-Ereignisschemas.