Skapa och övervaka Media Services händelser med Event Grid med Azure CLI

media services-logotyp v3


Letar du efter Media Services v2-dokumentation?

Azure Event Grid är en händelsetjänst för molnet. Den här tjänsten använder händelse prenumerationer för att dirigera händelse meddelanden till prenumeranter. Media Services händelser innehåller all information du behöver för att svara på ändringar i dina data. Du kan identifiera en Media Services-händelse eftersom egenskapen eventType börjar med "Microsoft. Media.". Mer information finns i Media Services händelse scheman.

I den här artikeln använder du Azure CLI för att prenumerera på händelser för ditt Azure Media Services-konto. Sedan utlöser du händelser för att visa resultatet. Normalt kan du skicka händelser till en slutpunkt som bearbetar informationen om händelsen och utför åtgärder. I den här artikeln skickar du händelserna till en webbapp som samlar in och visar meddelandena.

Förutsättningar

  • En aktiv Azure-prenumeration. Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

  • Installera och använd CLI lokalt – du måste ha Azure CLI version 2.0 eller senare. Kör az --version för att se vilken version du har. Om du behöver installera eller uppgradera kan du läsa informationen i Installera Azure CLI.

    För närvarande fungerar inte alla Media Services v3 CLI-kommandon i Azure Cloud Shell. Vi rekommenderar att du använder CLI lokalt.

  • Skapa ett Media Services-konto.

    Se till att komma ihåg de värden som du använde för resursgruppens namn och namnet på Media Services-kontot.

Skapa en slutpunkt för meddelanden

Innan du prenumererar på händelser för Media Services kontot ska vi skapa slut punkten för händelse meddelandet. Slutpunkten utför vanligtvis åtgärder baserat på informationen om händelsen. I den här artikeln distribuerar du en fördefinierad webbapp som visar händelse meddelandena. Den distribuerade lösningen innehåller en App Service-plan,en webbapp för App Service och källkod från GitHub.

  1. Välj Deploy to Azure (Distribuera till Azure) för att distribuera lösningen till din prenumeration. Ange parametervärdena i Azure Portal.

    Bild som visar en knapp med etiketten "distribuera till Azure".

  2. Det kan ta några minuter att slutföra distributionen. Efter distributionen har slutförts kan du visa webbappen för att kontrollera att den körs. I en webbläsare navigerar du till: https://<your-site-name>.azurewebsites.net

Om du växlar till webbplatsen "Azure Event Grid Viewer" visas inga händelser än.

Aktivera Event Grid-resursprovider

Om du inte har använt Event Grid förut i din Azure-prenumeration kan du behöva registrera Event Grid-resursprovidern.

I Azure-portalen:

  1. Välj prenumerationer på den vänstra menyn.
  2. Välj den prenumeration som du använder för Event Grid.
  3. Välj resurs leverantörer på den vänstra menyn under Inställningar.
  4. Hitta Microsoft.EventGrid.
  5. Om du inte är registrerad väljer du Registrera.

Det kan ta en stund att slutföra registreringen. Välj Uppdatera för att uppdatera statusen. När Status är Registrerad är du redo att fortsätta.

Ange Azure-prenumeration

Med följande kommando anger du ID för den Azure-prenumeration som du vill använda för Media Services-kontot. Du kan se en lista över prenumerationer som du har åtkomst till under Prenumerationer.

az account set --subscription mySubscriptionId

Prenumerera på Media Services händelser

Du prenumererar på en artikel för att berätta Event Grid vilka händelser du vill spåra. I följande exempel prenumererar Media Services kontot som du skapade och skickar URL: en från den webbplats som du skapade som slut punkt för händelse aviseringen.

Ersätt <event_subscription_name> med ett unikt namn för din händelse prenumeration. För <resource_group_name> och <ams_account_name> använder du de värden som du använde när du skapade Media Services-kontot. För anger du <endpoint_URL> URL: en för din webbapp och lägger till api/updates den på Start sidans URL. Genom att ange slut punkten när du prenumererar Event Grid hanterar routning av händelser till den slut punkten.

  1. Hämta resurs-ID

    amsResourceId=$(az ams account show --name <ams_account_name> --resource-group <resource_group_name> --query id --output tsv)
    

    Exempel:

    amsResourceId=$(az ams account show --name amsaccount --resource-group amsResourceGroup --query id --output tsv)
    
  2. Prenumerera på händelserna

    az eventgrid event-subscription create \
    --source-resource-id $amsResourceId \
    --name <event_subscription_name> \
    --endpoint <endpoint_URL>
    

    Exempel:

    az eventgrid event-subscription create --source-resource-id $amsResourceId --name amsTestEventSubscription --endpoint https://amstesteventgrid.azurewebsites.net/api/updates/
    

    Tips

    Du kan få varning om validering av hand skakning. Vänta några minuter så bör hand skakningen verifieras.

Nu ska vi utlösa händelser för att se hur Event Grid distribuerar meddelandet till din slut punkt.

Skicka en händelse till din slutpunkt

Du kan utlösa händelser för Media Services kontot genom att köra ett kodnings jobb. Du kan följa den här snabb starten för att koda en fil och börja skicka händelser.

Visa ditt webbprogram igen och observera att en händelse för verifieringen av prenumerationen har skickats till den. Händelserutnätet skickar valideringshändelsen så att slutpunkten kan bekräfta att den vill ta emot händelsedata. Slut punkten måste anges validationResponse till validationCode . Mer information finns i Event Grid säkerhet och autentisering. Du kan visa webb program koden för att se hur den validerar prenumerationen.

Tips

Välj ögonikonen för att utöka informationen om händelsen. Uppdatera inte sidan om du vill visa alla händelser.

Visa prenumerationshändelse

Nästa steg

Ladda upp, koda och strömma