Crear y supervisar eventos de Media Services con Event Grid mediante la CLI de Azure

Azure Event Grid es un servicio de eventos para la nube. Este servicio usa las suscripciones a eventos para enrutar los mensajes de eventos a los suscriptores. Los eventos de Media Services contienen toda la información necesaria para responder a cualquier cambio que se produzca en los datos. Puede identificar un evento de Media Services porque la propiedad eventType comienza por "Microsoft.Media". Para más información, consulte el artículo sobre los esquemas de eventos de Media Services.

En este artículo se usa la CLI de Azure para suscribirse a eventos para su cuenta de Azure Media Services. A continuación, deberá desencadenar esos eventos para ver el resultado. Por lo general, se envían eventos a un punto de conexión que procesa los datos del evento y realiza acciones. En este artículo, los eventos se envían a una aplicación web que recopila y muestra los mensajes.

Prerrequisitos

• Una suscripción de Azure activa. Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

• Instale y use la CLI localmente, para este artículo es preciso usar la CLI de Azure versión 2.0 o posterior. Ejecute az --version para encontrar la versión que tiene. Si necesita instalarla o actualizarla, consulte Instalación de la CLI de Azure.

  Actualmente no todos los comandos de la CLI de Media Services v3 funcionan en Azure Cloud Shell. Se recomienda usar la CLI localmente.

• Cree una cuenta de Media Services.

  Asegúrese de recordar los valores que usó para el nombre de la cuenta de Media Services y el nombre del grupo de recursos.

Creación de un punto de conexión de mensaje

Antes de suscribirse a los eventos de la cuenta de Media Services, vamos a crear el punto de conexión para el mensaje del evento. Normalmente, el punto de conexión realiza acciones en función de los datos del evento. En este artículo debe implementar una aplicación web precompilada que muestre los mensajes de los eventos. La solución implementada incluye un plan de App Service, una aplicación web de App Service y el código fuente desde GitHub.

1. Seleccione Deploy to Azure (Implementar en Azure) para implementar la solución en su suscripción. En Azure Portal, proporcione valores para los parámetros.

   

2. La implementación puede tardar unos minutos en completarse. Después de que la implementación se haya realizado correctamente, puede ver la aplicación web para asegurarse de que se está ejecutando. En un explorador web, vaya a: https://<your-site-name>.azurewebsites.net

Si cambia al sitio "Visor de Azure Event Grid", verá que no tiene todavía ningún evento.

Habilitación del proveedor de recursos de Event Grid

Si aún no ha usado anteriormente Event Grid en su suscripción de Azure, puede que tenga que registrar el proveedor de recursos de Event Grid.

En Azure Portal:

1. Seleccione Suscripciones en el menú de la izquierda.
2. Seleccione la suscripción que está usando para Event Grid.
3. En el menú de la izquierda, en Configuración, seleccione Proveedores de recursos.
4. Busque Microsoft.EventGrid.
5. Si no está registrado, seleccione Registrar.

Puede tardar unos instantes en finalizarse el registro. Seleccione Actualizar para actualizar el estado. Cuando el estado es Registrado, ya está listo para continuar.

Establecimiento de la suscripción de Azure

En el siguiente comando, proporcione el identificador de suscripción de Azure que quiere usar para la cuenta de Media Services. Para ver una lista de las suscripciones a las que tiene acceso, vaya a Suscripciones.

az account set --subscription mySubscriptionId

Suscribirse a los eventos de Media Services

Suscríbase a un artículo para indicar a Event Grid los eventos cuyo seguimiento desea realizar. En el ejemplo siguiente se realiza la suscripción a la cuenta de Media Services que creó y se pasa la dirección URL del sitio web que creó como punto de conexión para la notificación de eventos.

Reemplace <event_subscription_name> por un nombre único para la suscripción de eventos. Para <resource_group_name> y <ams_account_name>, use los valores que usó al crear la cuenta de Media Services. En el caso de api/updates, especifique la dirección URL de la aplicación web y agregue <endpoint_URL> a la dirección URL de la página principal. Al especificar el punto de conexión cuando se realiza la suscripción, Event Grid controla el enrutamiento de los eventos a dicho punto de conexión.

1. Obtenga el identificador del recurso

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

   Por ejemplo:

   amsResourceId=$(az ams account show --name amsaccount --resource-group amsResourceGroup --query id --output tsv)
   

2. Suscríbase a los eventos

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

   Por ejemplo:

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

   Sugerencia

   Es posible que reciba una advertencia del protocolo de enlace de validación. Espere unos minutos y el protocolo de enlace debería realizar la validación.

A continuación, desencadenaremos algunos eventos para ver cómo Event Grid distribuye el mensaje al punto de conexión.

Envío de un evento al punto de conexión

Puede desencadenar eventos de la cuenta de Media Services si ejecuta un trabajo de codificación. Puede seguir este inicio rápido para codificar un archivo y empezar a enviar eventos.

Vuelva a la aplicación web y observe que se ha enviado un evento de validación de suscripción. Event Grid envía el evento de validación para que el punto de conexión pueda verificar que desea recibir datos de eventos. El punto de conexión debe establecer validationResponse en validationCode. Para más información, vea Event Grid security and authentication (Seguridad y autenticación de Event Grid). Puede ver el código de la aplicación web para ver cómo valida la suscripción.

Pasos siguientes

Carga, codificación y streaming