Configura route maps per Server di route Azure

Questo articolo ti mostra come creare route map su Server di route Azure e applicarle alle connessioni. Puoi creare route map e applicarle ai peering BGP usando il portale Azure o Azure PowerShell. Per applicare le mappe di route a gateway e connessioni di rete virtuali, utilizza il portale Azure. Per maggiori informazioni sulle mappe di percorso, vedi Informazioni sulle mappe di percorso per Server di route Azure.

Prerequisites

Consulta Informazioni sulle mappe dei percorsi per conoscere considerazioni e limitazioni prima di procedere.

Flusso di lavoro di configurazione

Segui questi passaggi generali per configurare le mappe dei percorsi:

1. Crea o usa un Server di route Azure esistente.
2. Configura i peer BGP, i gateway o i peering di rete virtuale spoke necessari per il tuo scenario.
3. Registrare le route previste prima di applicare un criterio. Vedi Visualizza le route effettive.
4. Configura una mappa del percorso e regole della mappa del percorso, poi salva. Per maggiori informazioni sulle regole delle mappe dei percorsi, vedi Informazioni sulle mappe dei percorsi.
5. Se il criterio si applica a uno spoke in peering, creare una connessione di rete virtuale dopo che è stata creata la mappa della route. Applica la route-map alla connessione prevista.
6. Confronta le viste Connections Dashboard e Effective Routes con i risultati delle policy attesi. Per le rotte spoke, verifica anche la propagazione presso il peer BGP ricevente.

Crea una mappa del percorso

Crea una connessione di rete virtuale per un spoke

Usa questa procedura quando il Route Server si trova in una rete virtuale hub e devi applicare una mappa delle rotte alle rotte scambiate con uno spoke peered, incluse le rotte pubblicizzate da un NVA in quello spoke. Creare una connessione di rete virtuale per lo spoke come punto di associazione della mappa di route. Per un NVA nella stessa rete virtuale del Route Server, applica la mappa al suo peering BGP esistente.

Per un esempio pratico, vedi Applica le mappe di rotta a un NVA in una rete virtuale a raggi.

1. Configurare prima il peering di reti virtuali tra l'hub e lo spoke. Nel peering da hub a spoke, abilita allowGatewayTransit; nel peering spoke-to-hub, abilita useRemoteGateways. Rivedi le restrizioni della mappa del percorso.
2. Crea almeno una mappa di percorso utilizzando la procedura precedente. La creazione della connessione di rete virtuale prima che esista una route map non riesce.
3. Su Route Server, sotto Connettività, seleziona Connessioni di rete virtuali e poi Aggiungi connessione.
4. Seleziona il gruppo di risorse e la rete virtuale spoke con peering che contiene l'NVA o i prefissi su cui vuoi che i criteri abbiano effetto. Seleziona lo spoke, non l'hub. Puoi selezionare le mappe in Inbound Route Map e Outbound Route Map in questa pagina, oppure lasciarle impostate su None e applicare le mappe successivamente come descritto nella sezione successiva. Successivamente, seleziona Crea.
5. Dopo il completamento della distribuzione, seleziona Aggiorna. Confermare che Stato provisioning della connessione sia Completato e che Stato di peering sia Connesso prima di applicare la mappa di route.

La connessione non crea né sostituisce il peering di rete virtuale o il peering BGP. Risolvi una connessione fallita o un peering disconnesso prima di continuare.

Applicare una mappa del percorso ai peering BGP e alle connessioni gateway

Dopo aver salvato la mappa del percorso, puoi applicarla a peering BGP, connessioni gateway o a una connessione di rete virtuale creata nella sezione precedente. L'inbound si applica poiché il Route Server riceve le rotte attraverso la connessione; l'outbound si applica poiché il Route Server pubblicizza le rotte attraverso di esso.

$routeMap = Get-AzRouteMap -ResourceGroupName "myResourceGroup" -VirtualHubName "myRouteServer" -Name "myRouteMap"
$peer = Get-AzRouteServerPeer -ResourceGroupName "myResourceGroup" -RouteServerName "myRouteServer" -PeerName "myBgpPeer"

$routingConfig = $peer.RoutingConfiguration
$routingConfig.InboundRouteMap = New-Object Microsoft.Azure.Commands.Network.Models.PSResourceId -Property @{ Id = $routeMap.Id }
# To apply the route map in the outbound direction, set $routingConfig.OutboundRouteMap instead.

Update-AzRouteServerPeer -ResourceGroupName "myResourceGroup" -RouteServerName "myRouteServer" `
    -PeerName $peer.Name -PeerIp $peer.PeerIp -PeerAsn $peer.PeerAsn `
    -RoutingConfiguration $routingConfig

(Get-AzRouteServerPeer -ResourceGroupName "myResourceGroup" -RouteServerName "myRouteServer" -PeerName "myBgpPeer").RoutingConfiguration.InboundRouteMap

Verifica l'associazione e il suo effetto nel portale Azure:

1. Verifica l'associazione aprendo nuovamente Applica Route-maps alle connessioni da Route Maps.

2. In Routing, seleziona Mappe di route, poi aprire Dashboard connessioni. Selezionare la direzione della connessione e della mappa della route e confrontare le route con i risultati previsti dei criteri. Usa Effective Routes per ispezionare le rotte risultanti in Route Server. Un'associazione di risorse riuscita da sola non verifica l'efficacia del criterio.

Per verificare una mappa di instradamento in entrata su una connessione di rete virtuale:

1. In Dashboard connessioni, selezionare Reti virtuali, la connessione e Nella direzione in entrata. Conferma che Mappa di instradamento applicata mostri la mappa prevista.
2. Rivedi il numero totale dei prefissi e la lista dei percorsi. Per questa connessione e direzione, mostrano le rotte rimanenti dopo l'elaborazione della route-map in entrata. Conferma che un prefisso abbinato a una regola di Drop sia assente e che rimanga un prefisso di controllo non abbinato.
3. Verificare Route effettive. Un prefisso di spoke eliminato può comunque apparire come In collegamento perché la route locale dello spoke rimane. Solo quella voce non mostra se il prefisso sia stato propagato.
4. Verifica la propagazione presso il peer BGP ricevente. Conferma che il prefisso eliminato sia assente e che siano presenti i prefissi rimanenti attesi. La propagazione delle route non verifica la distribuzione dei pacchetti.

Modifica o rimuovi una mappa del percorso

Update-AzRouteMap -ResourceGroupName "myResourceGroup" -VirtualHubName "myRouteServer" -Name "myRouteMap" -RouteMapRule @($updatedRule)

Remove-AzRouteMap -ResourceGroupName "myResourceGroup" -VirtualHubName "myRouteServer" -Name "myRouteMap"

Rimuovere una mappa di percorso da una connessione

$peer = Get-AzRouteServerPeer -ResourceGroupName "myResourceGroup" -RouteServerName "myRouteServer" -PeerName "myBgpPeer"
$routingConfig = $peer.RoutingConfiguration
$routingConfig.InboundRouteMap = $null

Update-AzRouteServerPeer -ResourceGroupName "myResourceGroup" -RouteServerName "myRouteServer" `
    -PeerName $peer.Name -PeerIp $peer.PeerIp -PeerAsn $peer.PeerAsn `
    -RoutingConfiguration $routingConfig

Restrizioni sulla mappa del percorso

• Le route map non sono supportate per le connessioni VPN VNet-to-VNet.
• È possibile applicare una mappa di route a una connessione di rete virtuale solo se la rete virtuale spoke è sottoposta a peering con la rete virtuale hub. Dal peering hub-to-spoke abilitare allowGatewayTransit. Dal peering hub-to-spoke abilitare useRemoteGateways.
• Le route map non sono supportate su una connessione di rete virtuale tra due hub virtuali quando Server di route Azure è distribuito in entrambi gli hub.

Mappe di percorso per risolvere i problemi

La mappa del percorso è in uno stato fallito

Se non viene fornita una mappa del percorso:

1. Verifica che le regole della mappa del percorso siano configurate correttamente e non contenga valori non validi.
2. Controlla che tu non stia usando ASN riservati o che non stia cercando di rimuovere comunità BGP di Azure. Per altre informazioni, vedere Considerazioni e limitazioni.
3. Elimina la mappa del percorso fallita e creane una nuova.
4. Se il problema persiste, aprire un caso di supporto.

Le rotte non vengono riassunte

Se il riassunto del percorso non funziona come previsto:

1. Verificare che le condizioni di corrispondenza siano configurate per corrispondere ai prefissi corretti.
2. Assicurati che l'azione di modifica del percorso sia impostata su Sostituisci con il prefisso del riepilogo corretto.
3. Controlla la visualizzazione Route effettive nel server di route per verificare le route prima e dopo l'applicazione della route map.

Le modifiche al percorso AS non vengono applicate

Se i cambiamenti di percorso AS non hanno effetto:

1. Verifica di non usare ASN riservati (8074, 8075, 12076, 65515, 65517, 65518, 65519, 65520).
2. Verificare che i criteri di corrispondenza identifichino correttamente i percorsi di destinazione.
3. Controlla la vista Effective Routes per verificare i valori del percorso AS.

I comandi interfaccia della riga di comando di Azure o Azure PowerShell falliscono dopo aver creato una route map

Dopo aver creato una route map su un route server, alcuni comandi interfaccia della riga di comando di Azure e Azure PowerShell falliscono su quel route server, anche se poi elimini la route map:

• az network routeserver peering create fallisce con l'errore ApiVersionDoesNotSupportConnectionsForRouteServer. Per aggiungere un peer BGP, usa il portale Azure o Add-AzRouteServerPeer.

• az network routeserver delete e Remove-AzRouteServer falliscono con l'errore RouteServerHasAssociatedHubIPConfigurationCannotBeDeleted. Per eliminare il route server, invia una richiesta di cancellazione all'API REST di Azure Resource Manager:

  az rest --method delete --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Network/virtualHubs/<route-server-name>?api-version=2026-05-01"
  

  La cancellazione può richiedere fino a 40 minuti. Per verificare i progressi, esegui lo stesso URL con --method get finché la richiesta non restituisce un errore ResourceNotFound.

Le modifiche alla mappa del percorso non stanno entrando in vigore

Se una mappa del percorso appena creata o aggiornata non sembra influenzare il percorso:

1. Se questa route map è la prima route map sul route server, attendi che l'aggiornamento una tantum si completi (fino a 30 minuti). Controlla lo stato di Provisioning nella pagina Route Maps.
2. Verifica che la mappa del percorso sia applicata alla connessione corretta nella direzione corretta (in entrata o in uscita).
3. Controllare Dashboard connessioni per la connessione e la direzione per confermare che la mappa della route stia elaborando le route.
4. Per una mappa di ingresso su una connessione di rete virtuale, confrontare le route rimanenti del dashboard con quelle ricevute dal peering BGP. Un prefisso a raggio che rimane On-link nelle Rotte Effettive non significa da solo che la mappa non lo abbia eliminato.

La mappa dei percorsi corrisponde a più percorsi del previsto

Se una mappa dei percorsi influisce su percorsi che non intendevi modificare:

1. Controlla se la regola della mappa del percorso ha condizioni di corrispondenza configurate. Una regola senza condizioni di corrispondenza corrisponde a tutti i percorsi della connessione a cui è applicata.
2. Verificare che il criterio della condizione di corrispondenza sia corretto. È uguale a corrisponde solo ai prefissi esatti specificati, mentre Contiene corrisponde ai prefissi specificati e a tutti i prefissi più specifici sottostanti.
3. Rivedi l'ordine delle regole. Le regole vengono valutate in ordine sequenziale e un set di regole per terminare interrompe l'elaborazione per le rotte abbinate.

Contenuti correlati

• Configura route map dual-stack utilizzando il portale Azure
• Visualizza le route effettive
• Informazioni sulle route maps per Server di route Azure
• Preponi i percorsi utilizzando mappe dei percorsi
• Etichetta i percorsi con le comunità BGP utilizzando mappe di percorso
• Elimina le rotte in entrata utilizzando mappe di percorso
• Applica le mappe di percorso a un NVA in una rete virtuale a raggi
• Che cos'è il server di route di Azure?
• Configurare e gestire il Server di route Azure
• Domande frequenti sul server di route di Azure