このページの情報の一部またはすべては、S3NS の Trusted Cloud には適用されない場合があります。

BGP ルートの一覧を取得する

このページでは、個々の Border Gateway Protocol（BGP）セッションでアドバタイズされたルートと学習したルートの一覧を取得する方法について説明します。これは、Cloud Router ルートのトラブルシューティングに役立ちます。ルートに BGP ルートポリシーが適用される前または後にルートの一覧を取得できます。アドバタイズされたルートと学習したルートのトラブルシューティングを行うには、次のセクションを順番に完了することをおすすめします。

始める前に

gcloud

このガイドのコマンドラインの例を使用する場合は、次の操作を行います。

Google Cloud CLI の最新バージョンをインストールするか、最新バージョンに更新します。
デフォルトのリージョンとゾーンを設定します。

API

このガイドの API の例を使用する場合は、API アクセスを設定します。

ポリシーが適用される前に BGP ルートの一覧を取得する

コンソール

手順は次のとおりです。

Trusted Cloud コンソールで、[Cloud Router] ページに移動します。

Cloud Router に移動
[Cloud Router] ページで、[BGP セッション] タブをクリックします。
一覧を取得する BGP セッションピアを選択します。BGP セッションの詳細ページが表示されます。アドバタイズされたルートは [アドバタイズされたルート] セクションに表示されます。

gcloud

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

次のように置き換えます。

ROUTER_NAME: Cloud Router の名前
ADDRESS_FAMILY: ルートを表示する IP アドレスファミリー。
- IPV4: IPv4 ベースの BGP アドレスの場合
- IPV6: IPv6 ベースの BGP アドレスの場合
PEER_NAME: BGP ピアの名前
REGION: Cloud Router が配置されているリージョン
ROUTE_DIRECTION: 表示するルートの方向:
- INBOUND: BGP ピアから学習したルート
- OUTBOUND: BGP ピアにアドバタイズされたルート

出力は次のようになります。

---
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

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"
}

次のように置き換えます。

PROJECT_ID: Cloud Router を含むプロジェクト
REGION: Cloud Router が配置されているリージョン
ROUTER_NAME: Cloud Router の名前
ADDRESS_FAMILY: ルートを表示する IP アドレスファミリー。
- IPV4: IPv4 ベースの BGP アドレスの場合
- IPV6: IPv6 ベースの BGP アドレスの場合
PEER_NAME: BGP ピアの名前
ROUTE_TYPE: 表示するルートのタイプ:
- LEARNED: BGP ピアから学習したルート
- ADVERTISED: BGP ピアにアドバタイズされるルート

出力は次のようになります。

{
  "kind": "compute#routersListBgpRoutes",
  "result": [
    {
      "destination": {
        "prefix": "10.0.1.0/24"
      },
      "med": 100
    },
    {
      "destination": {
        "prefix": "10.0.2.0/24"
      },
      "med": 338
    }
  ]
}

ポリシーの適用後に BGP ルートの一覧を取得する

コンソール

Trusted Cloud コンソールで、[Cloud Router] ページに移動します。

Cloud Router に移動
[Cloud Router] ページで、[BGP セッション] タブをクリックします。
一覧を取得する BGP セッションピアを選択します。BGP セッションの詳細ページが表示されます。アドバタイズされたルートは [アドバタイズされたルート] セクションに表示されます。

gcloud

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

次のように置き換えます。

ADDRESS_FAMILY: ルートを表示する IP アドレスファミリー。
- IPV4: IPv4 ベースの BGP アドレスの場合
- IPV6: IPv6 ベースの BGP アドレスの場合
PEER_NAME: BGP ピアの名前
ROUTE_DIRECTION: 表示するルートの方向:
- INBOUND: BGP ピアから学習したルート
- OUTBOUND: BGP ピアにアドバタイズされたルート

出力は次のようになります。

---
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

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"
}

次のように置き換えます。

PROJECT_ID: Cloud Router を含むプロジェクト
REGION: Cloud Router が配置されているリージョン
ROUTER_NAME: Cloud Router の名前
ADDRESS_FAMILY: ルートを表示する IP アドレスファミリー。
- IPV4: IPv4 ベースの BGP アドレスの場合
- IPV6: IPv6 ベースの BGP アドレスの場合
PEER_NAME: BGP ピアの名前
ROUTE_TYPE: 表示するルートのタイプ:
- LEARNED: BGP ピアから学習したルート
- ADVERTISED: BGP ピアにアドバタイズされるルート

出力は次のようになります。

{
  "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
    }
  ]
}

最適な動的ルートを確認する

Cloud Router、リージョン、VPC ごとに最適な動的ルートを確認します。

gcloud

gcloud compute routers get-status コマンドを使用します。

gcloud compute routers get-status ROUTER_NAME \
    --region=REGION

出力には次の情報が含まれます。

bestRoutesForRouter: 特定の Cloud Router に最適なルートを表します。
bestRoutes: その VPC の Cloud Router のリージョンごとに最適なルートを表します。

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

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

出力には次の値が含まれます。

PROJECT_ID: Cloud Router を含むプロジェクト
NETWORK_NAME: VPC ネットワークの名前
REGION: リージョンの名前

API

routers.getRouterStatus メソッドを使用します。

GET https://compute.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/getRouterStatus

次のように置き換えます。

PROJECT_ID: Cloud Router を含むプロジェクト
REGION: Cloud Router が配置されているリージョン
ROUTER_NAME: Cloud Router の名前

出力には次の情報が含まれます。

bestRoutes: その VPC の Cloud Router のリージョンごとに最適なルートを表します。
bestRoutesForRouter: 特定の Cloud Router に最適なルートを表します。

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"
      },

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"
      }
    ],

出力には次の値が含まれます。

PROJECT_ID: Cloud Router を含むプロジェクト
REGION: Cloud Router が配置されているリージョン
ROUTER_NAME: Cloud Router の名前
TUNNEL_NAME: VPN トンネルの名前（該当する場合）

VPC 転送プレーンのルートテーブルを表示する

手順は次のとおりです。

Trusted Cloud コンソールで、[ルート] ページに移動します。

[ルート] に移動
[適用されているルート] タブで、ルートを一覧表示するネットワークを選択します。
[リージョン] リストで、ルートを一覧表示するリージョンを選択し、[表示] をクリックします。