在 Azure 数字孪生中创建事件路由和筛选器

若要创建事件路由，请转到 Azure 门户中 Azure 数字孪生实例的详细信息页。 可以通过在门户搜索栏中输入实例的名称来查找该实例。

从实例菜单中选择“事件路由”。 然后，在显示的“事件路由”页选择“+ 创建事件路由”。

在打开的“创建事件路由”页上，至少选择以下项目：

• “名称”字段的路由名称
• 要用于创建路由的终结点

要启用该路由，还必须“添加事件路由筛选器”，其值至少为 。 （保留创建路由的false默认值，但不会向其发送任何事件。为此，请切换高级编辑器的开关以启用它，并在“筛选器”框中写入true。

完成后，选择“保存”按钮创建事件路由。

可以使用 Azure 数字孪生 CLI 的 az dt route 命令来管理路由。

若要详细了解如何使用 CLI 以及哪些命令可用，请参阅 Azure 数字孪生 CLI 命令集。

此部分介绍如何使用 .NET (C#) SDK 创建事件路由。

CreateOrReplaceEventRouteAsync 是用于添加事件路由的 SDK 调用。 下面是它的用法示例：

string eventFilter = "$eventType = 'DigitalTwinTelemetryMessages' or $eventType = 'DigitalTwinLifecycleNotification'";
var er = new DigitalTwinsEventRoute("endpointName", eventFilter);
await client.CreateOrReplaceEventRouteAsync("routeId", er);

事件路由示例 SDK 代码

以下示例方法演示如何使用 .NET SDK 创建、列出和删除事件路由：

public static async Task CreateEventRouteAsync(DigitalTwinsClient client, string routeId, DigitalTwinsEventRoute er)
{
    try
    {
        Console.WriteLine("Create a route: testRoute1");

        // Make a filter that passes everything
        er.Filter = "true";
        await client.CreateOrReplaceEventRouteAsync(routeId, er);
        Console.WriteLine("Create route succeeded.");

        // List routes
        AsyncPageable<DigitalTwinsEventRoute> results = client.GetEventRoutesAsync();
        await foreach (DigitalTwinsEventRoute route in results)
        {
            Console.WriteLine($"Route {route.Id} to endpoint {route.EndpointName} with filter {route.Filter} ");
        }

        // Delete route created earlier
        Console.WriteLine($"Deleting route {routeId}:");
        await client.DeleteEventRouteAsync(routeId);
    }
    catch (RequestFailedException e)
    {
        Console.WriteLine($"*** Error in event route processing ({e.ErrorCode}):\n${e.Message}");
    }
}

若要在创建事件路由时添加事件筛选器，请使用“创建事件路由”页的“添加事件路由筛选器”部分。

可以从一些基本的常用筛选器选项中选择，也可以使用高级筛选器选项编写自己的自定义筛选器。

使用基本筛选器

若要使用基本筛选器，请展开“事件类型”选项，并选择与要发送到终结点的事件对应的复选框。

这样做会自动填充筛选器文本框，其中包含所选筛选器的文本：

使用高级筛选器

也可以使用高级筛选器选项来编写自己的自定义筛选器。

要使用高级筛选器选项创建事件路由，请切换“高级筛选器”的开关将其启用。 然后，则可以在“筛选器”框中编写自己的事件筛选器：

可以使用事件路由数据平面 API 编写自定义筛选器。 若要添加筛选器，可对 https://<Your-Azure-Digital-Twins-host-name>/eventRoutes/<event-route-name>?api-version=2020-10-31 使用 PUT 请求，正文如下：

{
    "endpointName": "<endpoint-name>",
    "filter": "<filter-text>"
}