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:

  1. Instale ou atualize para a versão mais recente da Google Cloud CLI.
  2. 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:

  1. No Trusted Cloud console, acesse a página Cloud Router.

    Acessar o Cloud Router

  2. Na página Cloud Router, clique na guia Sessões do BGP.

  3. 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 Router

  • ADDRESS_FAMILY: a família de endereços IP para mostrar rotas para:

    • IPV4: para endereços BGP baseados em IPv4
    • IPV6: para endereços BGP baseados em IPv6
  • PEER_NAME: o nome do app semelhante do BGP

  • REGION: a região em que o Cloud Router está localizado

  • ROUTE_DIRECTION: a direção para mostrar rotas para:

    • INBOUND: rotas aprendidas do peering do BGP
    • OUTBOUND: 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 Router

  • REGION: a região em que o Cloud Router está localizado

  • ROUTER_NAME: o nome do seu Cloud Router

  • ADDRESS_FAMILY: a família de endereços IP para mostrar rotas para:

    • IPV4: para endereços BGP baseados em IPv4
    • IPV6: para endereços BGP baseados em IPv6
  • PEER_NAME: o nome do app semelhante do BGP

  • ROUTE_TYPE: o tipo de rota a ser exibido:

    • LEARNED: rota aprendida do peering do BGP
    • ADVERTISED: 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

  1. No Trusted Cloud console, acesse a página Cloud Router.

    Acessar o Cloud Router

  2. Na página Cloud Router, clique na guia Sessões do BGP.

  3. 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 IPv4
    • IPV6: para endereços BGP baseados em IPv6
  • PEER_NAME: o nome do app semelhante do BGP

  • ROUTE_DIRECTION: a direção para mostrar rotas para:

    • INBOUND: rotas aprendidas do peering do BGP
    • OUTBOUND: 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 Router

  • REGION: a região em que o Cloud Router está localizado

  • ROUTER_NAME: o nome do seu Cloud Router

  • ADDRESS_FAMILY: a família de endereços IP para mostrar rotas para:

    • IPV4: para endereços BGP baseados em IPv4
    • IPV6: para endereços BGP baseados em IPv6
  • PEER_NAME: o nome do app semelhante do BGP

  • ROUTE_TYPE: o tipo de rota a ser exibido:

    • LEARNED: rota aprendida do peering do BGP
    • ADVERTISED: 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 Router

  • NETWORK_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 Router

  • REGION: a região em que o Cloud Router está localizado

  • ROUTER_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 Router

  • REGION: a região em que o Cloud Router está localizado

  • ROUTER_NAME: o nome do seu Cloud Router

  • TUNNEL_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:

  1. No Trusted Cloud console, acesse a página Rotas.

    Acessar a página Rotas

  2. Na guia Rotas efetivas, selecione a rede para a qual você quer listar as rotas.

  3. Na lista Região, selecione a região em que você quer listar as rotas e clique em Visualizar.