使用 Azure CLI 创建并通过事件网格监视 Azure 媒体服务事件

媒体服务徽标 v3


Azure 事件网格是针对云的事件处理服务。 此服务使用事件订阅将事件消息路由到订阅方。 媒体服务事件包含响应数据中的更改所需的所有信息。 可以识别媒体服务事件,因为 eventType 属性以“Microsoft.Media”开头。 有关详细信息,请参阅媒体服务事件架构

本文将使用 Azure CLI 订阅 Azure 媒体服务帐户的事件。 然后,触发事件以查看结果。 通常,你会将事件发送到处理事件数据并执行操作的终结点。 在本文中,将事件发送到收集并显示消息的 Web 应用。

先决条件

  • 一个有效的 Azure 订阅。 如果没有 Azure 订阅,可在开始前创建一个试用帐户

  • 在本地安装并使用 CLI,本文要求使用 Azure CLI 2.0 或更高版本。 运行 az --version 即可确定你拥有的版本。 如需进行安装或升级,请参阅安装 Azure CLI

  • 创建媒体服务帐户

    请务必记住用于资源组名称和媒体服务帐户名称的值。

创建消息终结点

在订阅媒体服务帐户的事件之前,先创建事件消息的终结点。 通常情况下,终结点基于事件数据执行操作。 在本文中,将部署用于显示事件消息的预建 Web 应用。 所部署的解决方案包括应用服务计划、应用服务 Web 应用和 GitHub 中的源代码。

  1. 选择“部署到 Azure”将解决方案部署到你的订阅。 在 Azure 门户中,为参数提供值。

    图像显示标记为“部署到 Azure”的按钮。

  2. 部署可能需要几分钟才能完成。 部署成功后,请查看 Web 应用以确保它正在运行。 在 Web 浏览器中导航到 https://<your-site-name>.chinacloudsites.cn

如果切换到“Azure 事件网格查看器”站点,将看到其中尚不具有任何事件。

启用事件网格资源提供程序

如果以前未在 Azure 订阅中使用过事件网格,则可能需要注册事件网格资源提供程序。

在 Azure 门户中:

  1. 选择 订阅
  2. 选择要用于事件网格的订阅。
  3. 在“设置”下,选择“资源提供程序”。
  4. 找到 Microsoft.EventGrid
  5. 如果尚未注册,请选择“注册”。

完成注册可能需要一些时间。 选择“刷新”可更新状态。 当“状态”为“已注册”后,即可继续。

设置 Azure 订阅

在以下命令中,为媒体服务帐户提供想要使用的 Azure 订阅 ID。 导航到订阅即可查看有权访问的订阅列表。

az account set --subscription mySubscriptionId

订阅媒体服务事件

订阅文章是为了告知事件网格要跟踪哪些事件。以下示例订阅所创建的媒体服务帐户,并将所创建网站中的 URL 作为事件通知的终结点进行传递。

<event_subscription_name> 替换为事件订阅的唯一名称。 对于 <resource_group_name><ams_account_name>,使用在创建媒体服务帐户时使用的值。 对于 <endpoint_URL>,请提供你的 Web 应用的 URL,并将 api/updates 添加到主页 URL。 在订阅时指定终结点,然后事件网格就会负责将事件路由到该终结点。

  1. 获取资源 ID

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

    例如:

    amsResourceId=$(az ams account show --name amsaccount --resource-group amsResourceGroup --query id --output tsv)
    
  2. 订阅事件

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

    例如:

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

    提示

    可能会收到验证握手警告。 等待几分钟后握手验证应会完成。

现在,让我们触发事件,看事件网格如何将消息分发到终结点。

向终结点发送事件

可通过运行编码作业来触发媒体服务帐户的事件。 可遵照本快速入门来对文件进行编码并开始发送事件。

再次查看 Web 应用,并注意现已向该应用发送了订阅验证事件。 事件网格发送验证事件,以便终结点可以验证它是否想要接收事件数据。 终结点必须将 validationResponse 设置为 validationCode。 有关详细信息,请参阅事件网格安全性和身份验证。 可以查看 Web 应用代码以了解它如何验证订阅。

提示

选择眼睛图标以展开事件数据。 如果要查看所有事件,请勿刷新页面。

查看订阅事件

后续步骤

上传、编码和流式处理