Azure CLı kullanarak Event Grid Media Services olaylar oluşturma ve izlemeCreate and monitor Media Services events with Event Grid using the Azure CLI

Azure Event Grid, bulut için bir olay hizmetidir.Azure Event Grid is an eventing service for the cloud. Bu hizmet, olay iletilerini abonelere yönlendirmek için olay abonelikleri kullanır.This service uses event subscriptions to route event messages to subscribers. Media Services olaylar, verilerdeki değişikliklere yanıt vermek için gereken tüm bilgileri içerir.Media Services events contain all the information you need to respond to changes in your data. EventType özelliği "Microsoft. Media." ile başladığı için bir Media Services olayı tanımlayabilirsiniz.You can identify a Media Services event because the eventType property starts with "Microsoft.Media.". Daha fazla bilgi için bkz. Media Services olay şemaları.For more information, see Media Services event schemas.

Bu makalede, Azure CLı kullanarak Azure Media Services hesabınıza yönelik olaylara abone olabilirsiniz.In this article, you use the Azure CLI to subscribe to events for your Azure Media Services account. Ardından, sonucu görüntülemek için olayları tetiklersiniz.Then, you trigger events to view the result. Genellikle olayları, olay verilerini işleyen ve eylemleri geçen bir uç noktaya gönderirsiniz.Typically, you send events to an endpoint that processes the event data and takes actions. Bu makalede, olayları toplayıp görüntüleyen bir Web uygulamasına gönderirsiniz.In this article, you send the events to a web app that collects and displays the messages.

PrerequisitesPrerequisites

  • Etkin bir Azure aboneliği.An active Azure subscription. Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.If you don't have an Azure subscription, create a free account before you begin.

  • CLı 'yi yerel olarak yükleyip kullanın, bu makale için Azure CLı 2,0 veya sonraki bir sürümü gerekir.Install and use the CLI locally, this article requires the Azure CLI version 2.0 or later. Sahip olduğunuz sürümü bulmak için az --version ' yı çalıştırın.Run az --version to find the version you have. Yüklemeniz veya yükseltmeniz gerekirse bkz. Azure CLI 'Yı yüklemek.If you need to install or upgrade, see Install the Azure CLI.

    Şu anda, tüm Media Services v3 CLI komutları Azure Cloud Shell çalışmaz.Currently, not all Media Services v3 CLI commands work in the Azure Cloud Shell. CLı 'nın yerel olarak kullanılması önerilir.It is recommended to use the CLI locally.

  • Media Services hesabı oluşturun.Create a Media Services account.

    Kaynak grubu adı ve Media Services hesap adı için kullandığınız değerleri anımsadığınızdan emin olun.Make sure to remember the values that you used for the resource group name and Media Services account name.

İleti uç noktası oluşturmaCreate a message endpoint

Media Services hesabı için olaylara abone olmadan önce olay iletisi için uç noktayı oluşturalım.Before subscribing to the events for the Media Services account, let's create the endpoint for the event message. Genellikle, uç nokta olay verilerine göre eylemler gerçekleştirir.Typically, the endpoint takes actions based on the event data. Bu makalede, olay iletilerini görüntüleyen önceden oluşturulmuş bir Web uygulaması dağıtırsınız.In this article, you deploy a pre-built web app that displays the event messages. Dağıtılan çözüm, GitHub 'dan bir App Service planı, bir App Service Web uygulaması ve kaynak kodu içerir.The deployed solution includes an App Service plan, an App Service web app, and source code from GitHub.

  1. Çözümü aboneliğinize dağıtmak için Azure 'A dağıt ' ı seçin.Select Deploy to Azure to deploy the solution to your subscription. Azure portal parametreler için değerler sağlayın.In the Azure portal, provide values for the parameters.

  2. Dağıtımın tamamlanması birkaç dakika sürebilir.The deployment may take a few minutes to complete. Dağıtım başarılı olduktan sonra, çalıştığından emin olmak için Web uygulamanızı görüntüleyin.After the deployment has succeeded, view your web app to make sure it's running. Bir Web tarayıcısında şuraya gidin: https://<your-site-name>.azurewebsites.netIn a web browser, navigate to: https://<your-site-name>.azurewebsites.net

"Azure Event Grid Görüntüleyici" sitesine geçerseniz, henüz hiç olayına sahip olduğunu görürsünüz.If you switch to the "Azure Event Grid Viewer" site, you see it has no events yet.

Event Grid kaynak sağlayıcısını etkinleştirmeEnable Event Grid resource provider

Azure aboneliğinizde daha önce Event Grid kullanmadıysanız Event Grid kaynak sağlayıcısına kaydolmanız gerekebilir.If you haven't previously used Event Grid in your Azure subscription, you may need to register the Event Grid resource provider.

Azure portalında:In the Azure portal:

  1. Abonelikler'i seçin.Select Subscriptions.
  2. Event Grid için kullandığınız aboneliği seçin.Select the subscription you're using for Event Grid.
  3. Ayarlar'ın altında Kaynak sağlayıcıları'nı seçin.Under Settings, select Resource providers.
  4. Microsoft.EventGrid öğesini bulun.Find Microsoft.EventGrid.
  5. Kayıtlı değilse Kaydol'u seçin.If not registered, select Register.

Kayıt işleminin tamamlanması biraz sürebilir.It may take a moment for the registration to finish. Durumu güncelleştirmek için Yenile’yi seçin.Select Refresh to update the status. Durum Kayıtlı olduğunda, devam etmeye hazırsınız demektir.When Status is Registered, you're ready to continue.

Azure aboneliğini ayarlamaSet the Azure subscription

Aşağıdaki komutta, Media Services hesabı için kullanmak istediğiniz Azure abonelik KIMLIĞINI sağlayın.In the following command, provide the Azure subscription ID that you want to use for the Media Services account. Aboneliklerdegezinerek erişiminiz olan aboneliklerin bir listesini görebilirsiniz.You can see a list of subscriptions that you have access to by navigating to Subscriptions.

az account set --subscription mySubscriptionId

Media Services olaylarına abone olmaSubscribe to Media Services events

İzlemek istediğiniz olayları Event Grid söylemek için bir makaleye abone olursunuz. Aşağıdaki örnek, oluşturduğunuz Media Services hesabına abone olur ve olay bildirimi için uç nokta olarak oluşturduğunuz Web sitesinden URL 'YI geçirir.You subscribe to an article to tell Event Grid which events you want to track. The following example subscribes to the Media Services account you created, and passes the URL from the website you created as the endpoint for event notification.

@No__t-0 değerini olay aboneliğiniz için benzersiz bir adla değiştirin.Replace <event_subscription_name> with a unique name for your event subscription. @No__t-0 ve <ams_account_name> için Media Services hesabı oluştururken kullandığınız değerleri kullanın.For <resource_group_name> and <ams_account_name>, use the values you used when creating the Media Services account. @No__t-0 için, Web uygulamanızın URL 'sini sağlayın ve giriş sayfası URL 'sine api/updates ekleyin.For the <endpoint_URL>, provide the URL of your web app and add api/updates to the home page URL. Abone olurken bitiş noktasını belirterek, Event Grid olayların bu uç noktaya yönlendirilmesini işler.By specifying the endpoint when subscribing, Event Grid handles the routing of events to that endpoint.

  1. Kaynak kimliğini alGet the resource id

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

    Örneğin:For example:

    amsResourceId=$(az ams account show --name amsaccount --resource-group amsResourceGroup --query id --output tsv)
    
  2. Olaylara abone olmaSubscribe to the events

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

    Örneğin:For example:

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

    İpucu

    Doğrulama el sıkışma uyarısı alabilirsiniz.You might get validation handshake warning. Birkaç dakika bekleyin ve el sıkışma doğrulaması gerekir.Give it a few minutes and the handshake should validate.

Şimdi, Event Grid iletiyi uç noktanıza nasıl dağıttığını görmek için olayları tetikleyelim.Now, let's trigger events to see how Event Grid distributes the message to your endpoint.

Uç noktanıza olay göndermeSend an event to your endpoint

Bir kodlama işi çalıştırarak Media Services hesabı için olayları tetikleyebilirsiniz.You can trigger events for the Media Services account by running an encoding job. Bir dosya kodlamak ve olay göndermeye başlamak için Bu hızlı başlangıcı izleyebilirsiniz.You can follow this quickstart to encode a file and start sending events.

Web uygulamanızı yeniden görüntüleyin ve kendisine bir abonelik doğrulama olayı gönderildiğini unutmayın.View your web app again, and notice that a subscription validation event has been sent to it. Event Grid, bitiş noktasının olay verilerini almak istediğini doğrulayabilmesi için doğrulama olayını gönderir.Event Grid sends the validation event so the endpoint can verify that it wants to receive event data. Uç noktanın validationResponse validationCode olarak ayarlanması gerekebilir.The endpoint has to set validationResponse to validationCode. Daha fazla bilgi için bkz. güvenlik ve kimlik doğrulaması Event Grid.For more information, see Event Grid security and authentication. Aboneliği nasıl doğrulayacağını görmek için Web uygulaması kodunu görüntüleyebilirsiniz.You can view the web app code to see how it validates the subscription.

İpucu

Olay verilerini genişletmek için göz simgesini seçin.Select the eye icon to expand the event data. Tüm olayları görüntülemek istiyorsanız, sayfayı yenilemeyin.Do not refresh the page, if you want to view all the events.

Abonelik olayını görüntüle

Sonraki adımlarNext steps

Karşıya yükleme, kodlama ve akışUpload, encode, and stream