combined the different version articles of how-to-manage-routes into a single tabbed article

Author: v-gweinstock

.openpublishing.redirection.json

@@ -17264,11 +17264,18 @@
       "redirect_url": "/azure/digital-twins/concepts-ontologies-convert",
       "redirect_document_id": false
     },
+
     {
-      "source_path_from_root": "/articles/digital-twins/how-to-manage-routes.md",
-      "redirect_url": "/azure/digital-twins/how-to-manage-routes-apis-cli",
+      "source_path_from_root": "/articles/digital-twins/how-to-manage-routes-apis-cli.md",
+      "redirect_url": "/azure/digital-twins/how-to-manage-routes",
       "redirect_document_id": true
     },
+    {
+      "source_path_from_root": "/articles/digital-twins/how-to-manage-routes-portal.md",
+      "redirect_url": "/azure/digital-twins/how-to-manage-routes",
+      "redirect_document_id": true
+    },
+
     {
       "source_path_from_root": "/articles/digital-twins/how-to-use-parser.md",
       "redirect_url": "/azure/digital-twins/how-to-parse-models",

articles/digital-twins/TOC.yml

@@ -126,11 +126,7 @@
   - name: Connect output
     items:
     - name: Manage endpoints and routes
-      items:
-      - name: Portal
-        href: how-to-manage-routes-portal.md
-      - name: APIs and CLI
-        href: how-to-manage-routes-apis-cli.md
+      href: how-to-manage-routes.md
     - name: Route events with a managed identity
       href: how-to-route-with-managed-identity.md
     - name: Integrate with Azure Maps

articles/digital-twins/concepts-data-ingress-egress.md

@@ -40,7 +40,7 @@ Azure Digital Twins can send data to connected **endpoints**. Supported endpoint
 * [Event Grid](../event-grid/overview.md)
 * [Service Bus](../service-bus-messaging/service-bus-messaging-overview.md)
 
-Endpoints are attached to Azure Digital Twins using management APIs or the Azure portal. Learn more about how to attach an endpoint to Azure Digital Twins in [How-to: Manage endpoints and routes](how-to-manage-routes-apis-cli.md).
+Endpoints are attached to Azure Digital Twins using management APIs or the Azure portal. Learn more about how to attach an endpoint to Azure Digital Twins in [How-to: Manage endpoints and routes](how-to-manage-routes.md).
 
 There are many other services where you may want to ultimately direct your data, such as [Azure Storage](../storage/common/storage-introduction.md), [Azure Maps](../azure-maps/about-azure-maps.md), [Azure Data Explorer](/azure/data-explorer/data-explorer-overview), or [Time Series Insights](../time-series-insights/overview-what-is-tsi.md). To send your data to services like these, attach the destination service to an endpoint.
 

articles/digital-twins/concepts-route-events.md

@@ -56,7 +56,7 @@ To define an event route, developers first must define endpoints. An **endpoint*
 * Event Hub
 * Service Bus
 
-To create an endpoint, you can use the Azure Digital Twins [REST APIs, CLI commands](how-to-manage-routes-apis-cli.md#create-an-endpoint-for-azure-digital-twins), or the [Azure portal](how-to-manage-routes-portal.md#create-an-endpoint-for-azure-digital-twins).
+To create an endpoint, you can use the Azure Digital Twins [REST APIs, CLI commands, or the Azure portal](how-to-manage-routes.md#create-an-endpoint-for-azure-digital-twins).
 
 When defining an endpoint, you'll need to provide:
 * The endpoint's name
@@ -72,15 +72,15 @@ The endpoint APIs that are available in control plane are:
 
 ## Create an event route
 
-To create an event route, you can use the Azure Digital Twins [REST APIs, CLI commands](how-to-manage-routes-apis-cli.md#create-an-event-route), or the [Azure portal](how-to-manage-routes-portal.md#create-an-event-route).
+To create an event route, you can use the Azure Digital Twins [REST APIs, CLI commands, or the Azure portal](how-to-manage-routes.md#create-an-event-route).
 
 Here is an example of creating an event route within a client application, using the `CreateOrReplaceEventRouteAsync` [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins/client?view=azure-dotnet&preserve-view=true) call: 
 
 :::code language="csharp" source="~/digital-twins-docs-samples/sdks/csharp/eventRoute_operations.cs" id="CreateEventRoute":::
 
 1. First, a `DigitalTwinsEventRoute` object is created, and the constructor takes the name of an endpoint. This `endpointName` field identifies an endpoint such as an Event Hub, Event Grid, or Service Bus. These endpoints must be created in your subscription and attached to Azure Digital Twins using control plane APIs before making this registration call.
 
-2. The event route object also has a [Filter](how-to-manage-routes-apis-cli.md#filter-events) field, which can be used to restrict the types of events that follow this route. A filter of `true` enables the route with no additional filtering (a filter of `false` disables the route). 
+2. The event route object also has a [Filter](how-to-manage-routes.md#filter-events) field, which can be used to restrict the types of events that follow this route. A filter of `true` enables the route with no additional filtering (a filter of `false` disables the route). 
 
 3. This event route object is then passed to `CreateOrReplaceEventRouteAsync`, along with a name for the route.
 
@@ -101,7 +101,7 @@ Before setting the dead-letter location, you must have a storage account with a
 
 To learn more about SAS tokens, see: [Grant limited access to Azure Storage resources using shared access signatures (SAS)](../storage/common/storage-sas-overview.md)
 
-To learn how to set up an endpoint with dead-lettering, see [How-to: Manage endpoints and routes in Azure Digital Twins (APIs and CLI)](how-to-manage-routes-apis-cli.md#create-an-endpoint-with-dead-lettering).
+To learn how to set up an endpoint with dead-lettering, see [How-to: Manage endpoints and routes in Azure Digital Twins](how-to-manage-routes.md#create-an-endpoint-with-dead-lettering).
 
 ### Types of event messages
 
@@ -112,7 +112,7 @@ Different types of events in IoT Hub and Azure Digital Twins produce different t
 ## Next steps
 
 See how to set up and manage an event route:
-* [How-to: Manage endpoints and routes](how-to-manage-routes-apis-cli.md)
+* [How-to: Manage endpoints and routes](how-to-manage-routes.md)
 
 Or, see how to use Azure Functions to route events within Azure Digital Twins:
 * [How-to: Set up an Azure function for processing data](how-to-create-azure-function.md)