Listar rotas BGP
Esta página descreve como listar rotas anunciadas e aprendidas em sessões individuais do protocolo de gateway de borda (BGP), que podem ajudar a resolver problemas com as rotas do Cloud Router. É possível listar rotas antes ou depois que as políticas de rota do BGP sejam aplicadas a uma rota. Para resolver problemas com rotas anunciadas e aprendidas, recomendamos que você conclua as seções a seguir em ordem.
Antes de começar
gcloud
Para usar os exemplos de linha de comando deste guia:
- Instale ou atualize para a versão mais recente da Google Cloud CLI.
- Defina uma região e uma zona padrão.
API
Para usar os exemplos da API deste guia, configure o acesso a ela.
Listar rotas do BGP antes que as políticas sejam aplicadas
Console
Faça o seguinte:
No Trusted Cloud console, acesse a página Cloud Router.
Na página Cloud Router, clique na guia Sessões do BGP.
Selecione o peer de sessão do BGP que você quer listar. A página de detalhes da sessão do BGP é exibida. As rotas divulgadas estão listadas na seção Rotas divulgadas.
gcloud
Use o comando gcloud compute routers list-bgp-routes
:
gcloud compute routers list-bgp-routes ROUTER_NAME \
--address-family=ADDRESS_FAMILY \
--no-policy-applied \
--peer=PEER_NAME \
--region=REGION \
--route-direction=ROUTE_DIRECTION
Substitua:
ROUTER_NAME
: o nome do seu Cloud RouterADDRESS_FAMILY
: a família de endereços IP para mostrar rotas para:IPV4
: para endereços BGP baseados em IPv4IPV6
: para endereços BGP baseados em IPv6
PEER_NAME
: o nome do app semelhante do BGPREGION
: a região em que o Cloud Router está localizadoROUTE_DIRECTION
: a direção para mostrar rotas para:INBOUND
: rotas aprendidas do peering do BGPOUTBOUND
: rotas anunciadas para o par do BGP
O resultado será assim:
---
asPaths:
- asns:
- 64515
type: AS_PATH_TYPE_SEQUENCE
destination:
prefix: 192.168.1.0/24
med: 100
origin: BGP_ORIGIN_INCOMPLETE
---
asPaths:
- asns:
- 64515
type: AS_PATH_TYPE_SEQUENCE
destination:
prefix: 192.168.2.0/24
med: 333
origin: BGP_ORIGIN_INCOMPLETE
API
Use o
método routers.listBgpRoutes
.
GET https://compute.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/listBgpRoutes
{
"addressFamily": "ADDRESS_FAMILY",
"peer": "PEER_NAME",
"policyApplied": FALSE,
"routeType": "ROUTE_TYPE"
}
Substitua:
PROJECT_ID
: o projeto que contém o Cloud RouterREGION
: a região em que o Cloud Router está localizadoROUTER_NAME
: o nome do seu Cloud RouterADDRESS_FAMILY
: a família de endereços IP para mostrar rotas para:IPV4
: para endereços BGP baseados em IPv4IPV6
: para endereços BGP baseados em IPv6
PEER_NAME
: o nome do app semelhante do BGPROUTE_TYPE
: o tipo de rota a ser exibido:LEARNED
: rota aprendida do peering do BGPADVERTISED
: rota anunciada para o peer do BGP
O resultado será assim:
{
"kind": "compute#routersListBgpRoutes",
"result": [
{
"destination": {
"prefix": "10.0.1.0/24"
},
"med": 100
},
{
"destination": {
"prefix": "10.0.2.0/24"
},
"med": 338
}
]
}
Listar rotas BGP depois que as políticas forem aplicadas
Console
No Trusted Cloud console, acesse a página Cloud Router.
Na página Cloud Router, clique na guia Sessões do BGP.
Selecione o peer de sessão do BGP que você quer listar. A página de detalhes da sessão do BGP é exibida. As rotas divulgadas estão listadas na seção Rotas divulgadas.
gcloud
Use o comando gcloud compute routers list-bgp-routes
:
gcloud compute routers list-bgp-routes ROUTER_NAME \
--address-family=ADDRESS_FAMILY \
--policy-applied \
--peer=PEER_NAME \
--region=REGION \
--route-direction=ROUTE_DIRECTION
Substitua:
ADDRESS_FAMILY
: a família de endereços IP para mostrar rotas para:IPV4
: para endereços BGP baseados em IPv4IPV6
: para endereços BGP baseados em IPv6
PEER_NAME
: o nome do app semelhante do BGPROUTE_DIRECTION
: a direção para mostrar rotas para:INBOUND
: rotas aprendidas do peering do BGPOUTBOUND
: rotas anunciadas para o par do BGP
O resultado será assim:
--- asPaths: - asns: - 64515 type: AS_PATH_TYPE_SEQUENCE communities: - 65535:65281 destination: prefix: 192.168.1.0/24 med: 100 origin: BGP_ORIGIN_INCOMPLETE --- asPaths: - asns: - 64515 type: AS_PATH_TYPE_SEQUENCE communities: - 65535:65281 destination: prefix: 192.168.2.0/24 med: 333 origin: BGP_ORIGIN_INCOMPLETE
API
Use o
método routers.listBgpRoutes
.
GET https://compute.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/listBgpRoutes { "addressFamily": "ADDRESS_FAMILY", "peer": "PEER_NAME", "policyApplied": TRUE, "routeType": "ROUTE_TYPE" }
Substitua:
PROJECT_ID
: o projeto que contém o Cloud RouterREGION
: a região em que o Cloud Router está localizadoROUTER_NAME
: o nome do seu Cloud RouterADDRESS_FAMILY
: a família de endereços IP para mostrar rotas para:IPV4
: para endereços BGP baseados em IPv4IPV6
: para endereços BGP baseados em IPv6
PEER_NAME
: o nome do app semelhante do BGPROUTE_TYPE
: o tipo de rota a ser exibido:LEARNED
: rota aprendida do peering do BGPADVERTISED
: rota anunciada para o peer do BGP
O resultado será assim:
{
"kind": "compute#routersListBgpRoutes",
"result": [
{
"destination": {
"prefix": "10.0.1.0/24"
},
"asPaths": [
{
"type": "AS_PATH_TYPE_SEQUENCE",
"asns": [
64514
]
}
],
"origin": "BGP_ORIGIN_INCOMPLETE",
"med": 100
},
{
"destination": {
"prefix": "10.0.2.0/24"
},
"asPaths": [
{
"type": "AS_PATH_TYPE_SEQUENCE",
"asns": [
64514
]
}
],
"origin": "BGP_ORIGIN_INCOMPLETE",
"med": 338
}
]
}
Confira as melhores rotas dinâmicas
Confira as melhores rotas dinâmicas por Cloud Router e por região por VPC:
gcloud
Use o comando gcloud compute routers get-status
:
gcloud compute routers get-status ROUTER_NAME \
--region=REGION
A saída inclui as seguintes informações:
bestRoutesForRouter
: representa as melhores rotas para um Cloud Router específico.bestRoutes
: representa as melhores rotas por região de um Cloud Router dessa VPC.
O resultado será parecido com este para bestRoutesForRouter
:
bestRoutesForRouter:
- asPaths:
- asLists:
- 65002
pathSegmentType: AS_SEQUENCE
creationTimestamp: '2024-09-26T18:28:54.346-07:00'
destRange: 192.168.1.0/24
kind: compute#route
network: https://www.googleapis.com/compute/projects/PROJECT_ID/global/networks/NETWORK_NAME
nextHopIp: 169.254.0.2
nextHopOrigin: INCOMPLETE
nextHopVpnTunnel: https://www.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/vpnTunnels/vpc-demo-tunnel0
priority: 100
routeStatus: ACTIVE
routeType: BGP
- asPaths:
- asLists:
- 65002
pathSegmentType: AS_SEQUENCE
creationTimestamp: '2024-09-27T12:44:56.575-07:00'
destRange: 192.168.1.0/24
kind: compute#route
network: https://www.googleapis.com/compute/projects/PROJECT_ID/global/networks/NETWORK_NAME
nextHopIp: 169.254.1.2
nextHopOrigin: INCOMPLETE
nextHopVpnTunnel: https://www.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/vpnTunnels/vpc-demo-tunnel1
priority: 100
routeStatus: ACTIVE
routeType: BGP
O resultado será parecido com este para bestRoutes
:
bestRoutes:
- asPaths:
- asLists:
- 65002
pathSegmentType: AS_SEQUENCE
creationTimestamp: '2024-09-26T18:33:50.505-07:00'
destRange: 192.168.1.0/24
kind: compute#route
network: https://www.googleapis.com/compute/projects/PROJECT_ID/global/networks/NETWORK_NAME
nextHopIp: 169.254.0.2
nextHopOrigin: INCOMPLETE
nextHopVpnTunnel: https://www.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/vpnTunnels/vpc-demo-tunnel0
priority: 100
routeType: BGP
- asPaths:
- asLists:
- 65002
pathSegmentType: AS_SEQUENCE
creationTimestamp: '2024-09-27T12:46:49.028-07:00'
destRange: 192.168.1.0/24
kind: compute#route
network: https://www.googleapis.com/compute/projects/PROJECT_ID/global/networks/NETWORK_NAME
nextHopIp: 169.254.1.2
nextHopOrigin: INCOMPLETE
nextHopVpnTunnel: https://www.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/vpnTunnels/vpc-demo-tunnel1
priority: 100
routeType: BGP
A saída inclui os seguintes valores:
PROJECT_ID
: o projeto que contém o Cloud RouterNETWORK_NAME
: o nome da rede VPC.REGION
: o nome da região.
API
Use o
método routers.getRouterStatus
.
GET https://compute.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/getRouterStatus
Substitua:
PROJECT_ID
: o projeto que contém o Cloud RouterREGION
: a região em que o Cloud Router está localizadoROUTER_NAME
: o nome do seu Cloud Router
A saída inclui as seguintes informações:
bestRoutes
: representa as melhores rotas por região de um Cloud Router dessa VPC.bestRoutesForRouter
: representa as melhores rotas para um Cloud Router específico.
O resultado será parecido com este para bestRoutes
:
"bestRoutes": [
{
"kind": "compute#route",
"creationTimestamp": "2025-03-05T11:20:40.323-08:00",
"network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME",
"destRange": "200.0.0.0/24",
"priority": 100,
"nextHopIp": "169.254.0.1",
"nextHopVpnTunnel": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/vpnTunnels/TUNNEL_NAME",
"routeType": "BGP",
"asPaths": [
{
"pathSegmentType": "AS_SEQUENCE",
"asLists": [
65001
]
}
],
"nextHopOrigin": "INCOMPLETE"
},
O resultado será parecido com este para bestRoutesForRouter
:
"bestRoutesForRouter": [
{
"kind": "compute#route",
"creationTimestamp": "2025-03-05T11:20:50.240-08:00",
"network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME",
"destRange": "10.2.1.0/24",
"priority": 100,
"nextHopIp": "169.254.0.1",
"nextHopVpnTunnel": "https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/regions/REGION/vpnTunnels/TUNNEL_NAME",
"routeType": "BGP",
"asPaths": [
{
"pathSegmentType": "AS_SEQUENCE",
"asLists": [
65001
]
}
],
"routeStatus": "ACTIVE",
"nextHopOrigin": "INCOMPLETE"
},
{
"kind": "compute#route",
"creationTimestamp": "2025-03-05T01:50:01.725-08:00",
"network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/on-prem",
"destRange": "200.0.0.0/24",
"priority": 100,
"nextHopIp": "169.254.0.1",
"nextHopVpnTunnel": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/vpnTunnels/TUNNEL_NAME",
"routeType": "BGP",
"asPaths": [
{
"pathSegmentType": "AS_SEQUENCE",
"asLists": [
65001
]
}
],
"routeStatus": "ACTIVE",
"nextHopOrigin": "INCOMPLETE"
},
{
"kind": "compute#route",
"creationTimestamp": "2025-03-06T05:30:06.277-08:00",
"network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/on-prem",
"destRange": "10.2.1.0/24",
"priority": 100,
"nextHopIp": "169.254.1.1",
"nextHopVpnTunnel": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/vpnTunnels/TUNNEL_NAME",
"routeType": "BGP",
"asPaths": [
{
"pathSegmentType": "AS_SEQUENCE",
"asLists": [
65001
]
}
],
"routeStatus": "ACTIVE",
"nextHopOrigin": "INCOMPLETE"
}
],
A saída inclui os seguintes valores:
PROJECT_ID
: o projeto que contém o Cloud RouterREGION
: a região em que o Cloud Router está localizadoROUTER_NAME
: o nome do seu Cloud RouterTUNNEL_NAME
: se aplicável, o nome do túnel da VPN
Conferir a tabela de rotas do plano de encaminhamento da VPC
Faça o seguinte:
No Trusted Cloud console, acesse a página Rotas.
Na guia Rotas efetivas, selecione a rede para a qual você quer listar as rotas.
Na lista Região, selecione a região em que você quer listar as rotas e clique em Visualizar.