Todos os produtos
Search
Central de documentação

Microservices Engine:Criar uma rota

Última atualização: Jun 28, 2026

Ao receber solicitações de acesso, o gateway nativo da nuvem as compara com as rotas individualmente, seguindo a prioridade das regras de roteamento em ordem decrescente. Se uma solicitação corresponder a uma rota, o sistema a encaminhará ao serviço de destino. Caso contrário, retornará o código de erro 404.

Prioridades de correspondência de rotas

Se houver múltiplas regras de roteamento, as prioridades seguirão a seguinte ordem decrescente: associated domain name > path > request header > request parameters > creation time.

  1. Defina a prioridade da rota pelo seu domain name. Quanto maior o comprimento da string do nome de domínio, maior a prioridade da rota.

  2. Defina a prioridade com base no path da rota nos seguintes cenários:

    • Se as path matching rules de várias rotas forem diferentes, a classificação de prioridade obedecerá à seguinte ordem decrescente: Equal To > Prefix > Regular Expression Match.

    • Se as path matching rules forem idênticas, a rota com a string de path mais longa terá maior prioridade.

  3. Defina a prioridade da rota pelo número total de pares chave-valor no request header. Uma quantidade maior de pares chave-valor no cabeçalho da solicitação resultará em prioridade mais alta.

  4. Defina a prioridade da rota pelo número total de pares chave-valor nos request parameters. Rotas com mais parâmetros de solicitação terão maior prioridade.

  5. Defina a prioridade da rota pelo creation time. Rotas criadas anteriormente têm precedência sobre as mais recentes.

Procedimento

Nota

As configurações de rota suportam protocolos HTTP, incluindo HTTP 1.0, HTTP 1.1, HTTP 2.0, gPRC e WebSocket.

  1. Faça login no MSE console. Na barra de navegação superior, selecione uma região.

  2. No painel de navegação à esquerda, escolha Cloud-native Gateway > Gateways. Na página Gateways, clique em ID do gateway.

  3. No painel de navegação à esquerda, clique em guia Routes. Na guia Routes, clique em Add Route.

  4. Na página Add Route, configure os parâmetros e clique em Save.

    Nota
    • Uma rota corresponde apenas quando todas as condições da regra de roteamento são atendidas. Quanto mais condições você especificar, menor será o volume de solicitações correspondentes.

    • A correspondência das solicitações com as rotas segue a ordem de exibição na página Routes.

    Parâmetro

    Descrição

    Route Name

    Nome da rota a ser criada. Clique em Add Description e insira uma descrição no campo Route Description.

    Domain name

    Selecione um ou mais nomes de domínio para correspondência nesta rota.

    Para criar um novo domínio, clique em Add Domain Name abaixo da lista suspensa Domain name e configure os parâmetros no painel Add Domain Name.

    Match Rule

    Path

    Parâmetro Path nas solicitações HTTP a serem encaminhadas por esta rota.

    • Se as regras de correspondência de caminho de várias rotas forem iguais, a rota com o valor de Path mais longo terá maior prioridade.

    • Se as regras de correspondência diferirem, a prioridade seguirá a ordem decrescente: Equal To > Prefix > Regular Expression Match.

      • Equal To: Usa um caminho completo para correspondência. Por exemplo, defina o parâmetro Path como /user.

      • Prefix: Usa um prefixo de caminho para identificar solicitações. Por exemplo, especifique o prefixo como /user.

      • Regular Expression Match: Usa uma expressão regular para corresponder às solicitações.

    Method

    Parâmetro Method usado para corresponder a solicitações HTTP. Especifique múltiplos valores para abranger mais solicitações. O valor padrão é ANY.

    Header

    Parâmetro Header usado para corresponder a solicitações HTTP. Se várias rotas compartilharem as mesmas condições de correspondência, exceto pela quantidade de cabeçalhos definidos, aquela com o maior número de parâmetros Header na regra terá maior prioridade.

    Query Parameters

    Parâmetro Query usado para corresponder a solicitações HTTP. Se várias rotas compartilharem as mesmas condições de correspondência, exceto pela quantidade de parâmetros Query definidos, aquela com o maior número de parâmetros Query na regra terá maior prioridade.

    Scenario

    Selecione o tipo de serviço de destino para a rota.

    • Cenário Básico: Single Service

    • Cenário de Canary Release: Multiple Services e Tag-based Routing

    • Outros Cenários: Mock e Redirect

    Para obter mais informações sobre os tipos de serviços de destino, consulte Modos de roteamento.

    Nota

    A soma das porcentagens de tráfego dos serviços de destino configurados com peso deve ser igual a 100%.

    Backend Service

    Selecione o serviço de backend associado e a porta.

    Nota
    • Selecione Associate Service na lista suspensa Service Name e escolha uma source e um serviço no painel Associate Service.

    • O número de sources que podem ser adicionadas varia conforme o tipo de source.

      • Se Source Type for Container Service, o limite máximo é de cinco sources.

      • Se Source Type for MSE Nacos ou MSE Zookeeper, apenas uma source pode ser adicionada.

      • Se Source Type for EDAS Built-in Registry ou SAE Built-in Registry, não há limite para a quantidade de sources.

    Fallback

    Especifique um serviço de fallback conforme necessário. Se nenhum nó estiver disponível no serviço de backend apontado pela rota, a solicitação original acessará o serviço de fallback especificado.

    Nota

    Somente a capacidade de fallback entre serviços HTTP é suportada.

    Timeout Period (s)

    Insira o tempo limite. O valor padrão é 60. Definir esse valor como 0 desativa o tempo limite.

    Number of Retries (times)

    Insira o número de novas tentativas. O valor padrão é 2. Definir esse valor como 0 desativa as novas tentativas.

    Retry Condition

    Selecione uma condição para nova tentativa.

    Retry Status Code

    Adicione um ou mais códigos de status para nova tentativa.

Referências

Modifique as regras de roteamento a qualquer momento conforme as necessidades do seu negócio. Para obter mais informações, consulte Modificar uma regra de roteamento.