Azure Digital Twins에서 이벤트 경로 및 필터 만들기

이벤트 경로를 만들려면 Azure Portal에서 Azure Digital Twins 인스턴스에 대한 세부 정보 페이지로 이동합니다. 포털 검색 창에 해당 이름을 입력하여 인스턴스를 찾을 수 있습니다.

인스턴스 메뉴에서 이벤트 경로를 선택합니다. 그런 다음, 이어지는 이벤트 경로 페이지에서 + 이벤트 경로 만들기를 선택합니다.

열리는 이벤트 경로 만들기 페이지에서 최소한 다음을 선택합니다.

• 이름 필드에서 경로 이름
• 경로를 만드는 데 사용할 엔드포인트

경로를 사용하려면 적어도 true인 이벤트 경로 필터도 추가해야 합니다. (기본값 false를 그대로 두면 경로는 생성되나 이벤트를 해당 경로로 보내지 않습니다.) 이렇게 하려면 고급 편집기에 대한 스위치를 전환하여 사용하도록 설정하고 필터 상자에 true를 기입합니다.

완료되면 저장 단추를 선택하여 이벤트 경로를 만듭니다.

Azure Digital Twins CLI에 대한 az dt route 명령을 사용하여 경로를 관리할 수 있습니다.

CLI 사용 및 사용 가능한 명령에 대한 자세한 내용은 Azure Digital Twins 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 코드

다음 샘플 메서드는 C# 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>"
}