All Products
Search
Document Center

Microservices Engine:Manage routes

Last Updated:Mar 11, 2026

After you create routes on an MSE Cloud-native Gateway, you can view route details, edit routing rules, and control traffic by publishing, unpublishing, or deleting routes.

Route lifecycle

A route has two states that control whether it handles traffic:

StatusDescription
PublishedThe route is active and handles incoming traffic based on its routing rules.
UnpublishedThe route configuration is saved but does not handle traffic.

The following operations change a route's lifecycle state:

OperationEffectConstraint
PublishActivates the route to handle traffic. Status changes to Published.Only unpublished routes can be published.
Save And PublishSaves edits and activates the route in one step.Available when editing a route.
UnpublishRemoves the route from active traffic handling. Status changes to Unpublished.Only published routes can be unpublished.
DeletePermanently removes the route configuration.Only unpublished routes can be deleted. Unpublish first if the route is published.

Prerequisites

Before you begin, ensure that you have:

  • An MSE Cloud-native Gateway instance

  • One or more routes created on the gateway

Open the routes page

All route management operations start from the Routes page:

  1. Log on to the MSE console.

  2. In the top navigation bar, select a region.

  3. In the left-side navigation pane, choose Cloud-native Gateway > Gateways.

  4. On the Gateways page, click the target gateway ID.

  5. In the left-side navigation pane, click Routes, then click the Routes tab.

View route details

On the Routes page, click a route name to view the following information:

  • basic information

  • policy settings

  • monitoring data

  • log data

Edit a routing rule

  1. Open the edit page using one of the following methods:

    • On the Routes page, find the target route and click Edit in the Actions column.

    • Click the route name to open the Overview page, then click Edit in the upper-right corner.

  2. Modify the route parameters.

  3. Click Save And Publish.

Publish a route

Publishing activates an unpublished route so it starts handling traffic.

  1. On the Routes page, find the target route and use one of the following methods:

    • In the Actions column, choose More > Publish.

    • Click the route name to open the Overview page, then click Publish in the upper-right corner.

  2. In the confirmation dialog box, click OK.

After publishing, the route status changes to Published.

You cannot publish a route that is already published. To update a published route, edit the routing rule and click Save And Publish.

Unpublish a route

Unpublishing removes a route from active traffic handling without deleting its configuration. Use this to temporarily disable a route.

  1. On the Routes page, find the target route and use one of the following methods:

    • In the Actions column, choose More > Unpublish.

    • Click the route name to open the Overview page, then click Unpublish in the upper-right corner.

  2. In the confirmation dialog box, click OK.

After unpublishing, the route status changes to Unpublished. You do not need to unpublish a route that is already unpublished.

Delete a route

Deleting a route permanently removes its configuration. This action cannot be undone.

  1. If the route status is Published, unpublish it first. See Unpublish a route.

  2. On the Routes page, find the target route and use one of the following methods:

    • In the Actions column, choose More > Delete.

    • Click the route name to open the Overview page, then click Delete in the upper-right corner.

  3. In the confirmation dialog box, click OK.