Todos os produtos
Search
Central de documentação

Global Accelerator:Gerenciar grupos de endpoints para listeners de roteamento personalizado

Última atualização: Sep 17, 2026

Cada listener usa grupos de endpoints para distribuir tráfego. Em um listener de roteamento personalizado, o tráfego é direcionado a endpoints específicos nesses grupos.

Pré-requisitos

  • Uma instância GA padrão criada.

  • Para instâncias do GA com pagamento por assinatura, você deve ter adquirido e associado um plano de largura de banda básico.

  • Aplicações implantadas como serviços de backend para o Global Accelerator. Para listeners de roteamento personalizado, o tipo de serviço de backend deve ser vSwitch. Para mais informações, consulte Endpoints.

  • Permissão para usar listeners de roteamento personalizado. Este recurso está em visualização por convite. Para usá-lo, entre em contato com seu gerente de conta. Após a aprovação da solicitação, selecione o roteamento personalizado como tipo de roteamento dos listeners.

  • Para garantir a conectividade adequada entre a instância do GA e os serviços de backend, as políticas de controle de acesso desses serviços, como regras de grupo de segurança, devem permitir tráfego do bloco CIDR do vSwitch. Verifique também se o vSwitch tem pelo menos oito endereços IP privados disponíveis.

Informações básicas

Ao configurar um listener de roteamento personalizado, a instância do Global Accelerator cria uma tabela de mapeamento baseada no intervalo de portas do listener, no mapeamento de portas do grupo de endpoints de destino e nas informações de sub-rede do endpoint. O GA usa essa tabela para rotear o tráfego deterministicamente para todos os endereços IP no vSwitch especificado ou para endereços IP e portas de destino específicos.

Listeners de roteamento personalizado suportam apenas os protocolos TCP e UDP. Cada listener aceita no máximo 10 grupos de endpoints. Essa cota não pode ser aumentada.

Adicionar um grupo de endpoints

  1. Faça login no console do Global Accelerator.

  2. Na página Instances, localize a instância do GA que deseja gerenciar e clique em Configure Listener na coluna Actions.

  3. Na aba Listeners, clique em Add Listener.

    Ignore esta etapa se estiver adicionando o primeiro listener ou se a instância do Global Accelerator não tiver listeners.
  4. Na página Configure Listener & Protocol, selecione Custom Routing como tipo de roteamento, configure o listener e clique em Next.

  5. Na página Configure Endpoint Group, configure o grupo de endpoints e seus respectivos endpoints.

    Um grupo de endpoints define o mapeamento entre o intervalo de portas do listener e o intervalo de portas e protocolo do serviço de backend. Um endpoint especifica a sub-rede de destino do backend e sua política de tratamento de tráfego.

    1. Configure o grupo de endpoints.

      Na página Configure Endpoint Group, configure o grupo de endpoints conforme as informações a seguir.

      Parâmetro

      Descrição

      Endpoint Group Name

      Insira um nome para o grupo de endpoints.

      Region

      Selecione a região da Alibaba Cloud onde o grupo de endpoints está implantado.

      Port Mapping Range and Protocol

      Selecione um modo de entrada para definir os mapeamentos de porta e protocolo do listener para os serviços de backend no grupo de endpoints.

      • List Mode: Insira o Port Range e o Protocol. Para Protocol, selecione TCP, UDP ou ambos.

        Clique em Add para inserir vários mapeamentos.

        Use este modo para adicionar até 20 mapeamentos por vez.

      • Batch Mode: Insira os intervalos de portas e protocolos seguindo as instruções de formatação, ou baixe o modelo, preencha-o e envie o arquivo.

        Use este modo para adicionar até 100 mapeamentos por vez.

      O número total de portas no grupo de endpoints multiplicado pelo número total de endereços IP em todos os endpoints de vSwitch deve ser menor ou igual ao número total de portas especificadas para o listener. A fórmula é: (Total number of ports in the endpoint group) × (Total number of IP addresses in all vSwitch endpoints) ≤ (Number of listener ports).
    2. Configure os endpoints.

      Na seção Endpoint, clique em Add Endpoint. Na caixa de diálogo Add Endpoint, configure o endpoint conforme as informações a seguir e clique em OK.

      Parâmetro

      Descrição

      Backend Service Type

      Somente vSwitch é suportado.

      Backend Service

      Selecione o vSwitch para o qual deseja encaminhar o tráfego.

      Subnet Traffic

      Selecione uma política de acesso de tráfego de sub-rede.

      • Allow All Traffic: Todo o tráfego de entrada é encaminhado para o serviço de backend especificado por meio do Global Accelerator.

      • Deny All Traffic (Padrão): Nenhum tráfego de entrada é encaminhado para o serviço de backend especificado por meio do Global Accelerator.

      • Allow traffic for specific vSwitch IP addresses and ports: Especifique a Access Policy que pode receber tráfego. Os destinos do tráfego são os endereços IP e portas das instâncias ECS.

        Selecione um modo de entrada para a Access Policy:

        • List Mode: Insira um IP Address e uma Port. Também é possível selecionar a opção All Ports.

          Clique em +Add para inserir vários mapeamentos.

          Use este modo para adicionar até 20 mapeamentos por vez.

        • Batch Mode: Insira os intervalos de endereços IP e mapeamentos de portas seguindo as instruções de formatação, ou baixe o modelo, preencha-o e envie o arquivo.

          Use este modo para adicionar até 100 mapeamentos por vez.

    3. Opcional: Clique em + Add Endpoint Group para configurar outro grupo de endpoints.

    4. Na seção Cross-border Acceleration Settings, leia os Compliance Commitments Regarding Cross-border Data Transfers e selecione Agree to the Preceding Compliance Agreement.

      Esta etapa é necessária apenas se a aceleração transfronteiriça não estiver ativada para sua instância do GA e sua configuração de serviço envolver aceleração transfronteiriça entre a China continental e outras regiões.

    5. Clique em Next.

  6. Revise a configuração.

    Na página do assistente Configuration Review, verifique as configurações do listener e dos endpoints e clique em Submit.

    Para modificar configurações, clique em Edit na seção correspondente para retornar à página anterior.

    Um novo listener leva cerca de 3 minutos para ficar ativo. Alterações de configuração levam aproximadamente 1 minuto para serem aplicadas.

Mais operações

Ações

Descrição

Modificar um grupo de endpoints

  1. Na aba Listeners, localize o listener desejado e clique no ID do listener.

  2. Na página de detalhes do listener, clique na aba Endpoint Group.

  3. Na aba Endpoint Group, localize o grupo de endpoints desejado e execute as operações abaixo conforme necessário para modificar seu nome ou informações de mapeamento de portas.

    • Modificar o nome do grupo de endpoints: Na coluna Endpoint Group ID/Name, passe o mouse sobre o nome e clique no ícone 编辑.

    • Modificar o intervalo de mapeamento de portas e protocolo: Clique no número na coluna Port Mapping Range and Protocol. No painel Port Mapping Range and Protocol, execute as seguintes operações:

      • Para modificar um mapeamento existente, clique em Edit na coluna Actions. Na caixa de diálogo Modify Port Mapping Range and Protocol, modifique o mapeamento.

      • Para adicionar um novo mapeamento, clique em Add. Na caixa de diálogo Add, adicione um mapeamento.

      • Para excluir mapeamentos, localize o mapeamento que deseja excluir e clique em Delete na coluna Actions, ou selecione vários mapeamentos e clique em Batch Delete. Na caixa de diálogo Delete, clique em OK.

      Para mais informações sobre os limites dos intervalos de mapeamento de portas, consulte Listener ports for custom routing listeners.

Adicionar um endpoint

  1. Na aba Listeners, localize o listener desejado e clique no ID do listener.

  2. Na página de detalhes do listener, clique na aba Endpoint Group.

  3. Na aba Endpoint Group, localize o grupo de endpoints desejado e clique em Add Endpoint na coluna Actions.

  4. Na caixa de diálogo Add Endpoint, selecione o Backend Service e uma política para Subnet Traffic, e clique em OK.

    Para mais informações, consulte Configure endpoints.

Modificar um endpoint

  1. Na aba Listeners, localize o listener desejado e clique no ID do listener.

  2. Na página de detalhes do listener, clique na aba Endpoint Group.

  3. Na aba Endpoint Group, localize o grupo de endpoints desejado e clique no número na coluna Endpoint.

  4. Na página de detalhes do Endpoint, localize o endpoint desejado na seção Endpoint e modifique a política de tratamento de tráfego da sub-rede ou adicione um destino de tráfego ao endpoint.

    • Modificar o método de tratamento de tráfego para a sub-rede: Clique em Edit na coluna Actions. Na caixa de diálogo Edit Endpoint, selecione uma nova política para Subnet Traffic.

    • Adicionar um destino de tráfego: Clique em Add Access Policy na coluna Actions. Na caixa de diálogo Add Access Policy, selecione um modo de entrada para a Access Policy e insira as informações necessárias.

    • Editar um destino de tráfego: Clique no número na coluna Access Policy. No painel Access Policy, execute as seguintes operações:

      • Para modificar um destino de tráfego existente, clique em Edit na coluna Actions. Na caixa de diálogo Modify Access Policy, modifique o destino de tráfego.

      • Para adicionar um novo destino de tráfego, clique em Add. Na caixa de diálogo Add Access Policy, adicione um novo destino de tráfego.

      • Para excluir destinos de tráfego, localize o destino que deseja excluir e clique em Delete na coluna Actions, ou selecione vários destinos de tráfego e clique em Batch Delete. Na caixa de diálogo Delete, clique em OK.

    Para mais informações, consulte Configure endpoints.

Excluir um endpoint

  1. Na aba Listeners, localize o listener desejado e clique no ID do listener.

  2. Na página de detalhes do listener, clique na aba Endpoint Group.

  3. Na aba Endpoint Group, localize o grupo de endpoints desejado e clique no número na coluna Endpoint.

  4. Na página de detalhes do grupo de endpoints, localize o endpoint desejado na seção Endpoint e clique em Delete na coluna Actions.

  5. Na caixa de diálogo Delete, clique em OK.

Excluir um grupo de endpoints

  1. Na aba Listeners, localize o listener desejado e clique no ID do listener.

  2. Na página de detalhes do listener, clique na aba Endpoint Group.

  3. Na aba Endpoint Group, localize o grupo de endpoints desejado e clique em Delete na coluna Actions.

  4. Na caixa de diálogo Delete Endpoint Group, clique em OK.

Referência da API