カスタム学習ルートの指定と管理

Cloud Router は、Border Gateway Protocol（BGP）ピアから下り（外向き）トラフィックのルートを動的に学習します。ただし、このようなルートを手動で作成して BGP セッションに適用することもできます。手動で作成したルートはカスタム学習ルートと呼ばれます。

BGP セッションの作成と同時にカスタム学習ルートを作成できます。または、既存の BGP セッションを更新して、カスタム学習ルートを追加することもできます。

カスタム学習ルートの概要については、カスタム学習ルートをご覧ください。

動的に学習されるルートなど、Cloud Router による学習ルートの一般的な処理方法については、学習したルートをご覧ください。

始める前に

始める前に、次のセクションを確認してください。

プロジェクトを選択する

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

プロジェクトセレクタに移動

Google Cloud プロジェクトで課金が有効になっていることを確認します。

Google Cloud CLI をインストールします。

gcloud CLI を初期化するには:

gcloud init

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

プロジェクトセレクタに移動

Google Cloud プロジェクトで課金が有効になっていることを確認します。

Google Cloud CLI をインストールします。

gcloud CLI を初期化するには:

gcloud init

Google Cloud CLI を使用している場合は、次のコマンドを実行してプロジェクト ID を設定します。このページの gcloud の説明では、プロジェクト ID がすでに設定されていることを前提としています。
```
gcloud config set project PROJECT_ID
    
```

次のコマンドを実行して、ID が設定されていることを確認します。
```
gcloud config list --format='text(core.project)'
    
```

IPv6 の要件（省略可）

カスタム学習ルートに IPv6 プレフィックスを含めるには、接続リソースが IPv6 の基盤となる条件を満たす必要があります。たとえば、VPN トンネル用にカスタム学習ルートを確立する場合は、Cloud VPN の概要にある IPv6 サポートで説明されている条件を満たしていることを確認してください。

セッションの作成時にカスタム学習ルートを定義する

一部のネットワーク接続プロダクトでは、リソースの作成中にカスタム学習ルートを含めるように BGP ピアを構成できます。他のリソースでは、最初に BGP セッションを作成し、後でカスタム学習ルートを追加します。

セッションの作成時にカスタム学習ルートを追加する方法について詳しくは、以下をご覧ください。

Partner Interconnect の VLAN アタッチメントを作成する場合は、まずアタッチメントを作成してから、BGP ピアを更新してカスタム学習ルートを追加します。

Network Connectivity Center を使用してサードパーティネットワーク仮想アプライアンスをインストールし、カスタム学習ルートを使用する場合は、まずアプライアンスをインストールします。次に、使用するカスタム学習ルートごとに、アプライアンスにログインし、カスタム学習ルートを使用するようにルーターアプライアンスインスタンスを構成します。その後、カスタム学習ルートを使用するように BGP セッションを更新できます。詳細については、Network Connectivity Center のドキュメントのカスタム学習ルートを使用するをご覧ください。

Cloud Router セッションを更新すると、Cloud Router はカスタム学習ルートと VPC サブネット間の重複を確認します。重複がある場合は、VPC サブネットが優先されます。つまり、トラフィックはカスタム学習ルートではなく VPC サブネット経由でルーティングされます。Cloud Router は、VPC サブネット以上に限定された BGP とカスタム学習ルートを無視します。Google Cloud でのルーティングの詳細については、ルートをご覧ください。

BGP ルートとカスタム学習ルートの両方が同じ宛先 IP アドレスと一致する場合、Google Cloud は優先度の低いルートを優先します。値が小さいほど、優先度が高くなります。

BGP セッションの更新中にカスタム学習ルートを追加する方法については、次のセクションをご覧ください。

カスタム学習ルートを使用するように既存のセッションを更新する

カスタム学習ルートが定義されていない既存の BGP セッションがある場合は、必要に応じてカスタム学習ルートを使用するように更新できます。

また、セッションのカスタム学習ルートをすでに構成していて、以前に指定した IP プレフィックスに追加したい場合にも、この方法を使用できます。

コンソール

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

[Cloud Router] に移動
[名前] フィールドで、適切な Cloud Router の名前をクリックします。
[ルーターの詳細] ページで、変更する BGP セッションの名前をクリックします。
[BGP セッションの詳細] ページで、[編集] を選択します。
[アドバタイズされたルート、カスタム学習したルート、Bidirectional Forwarding Detection（BFD）] セクションを開き、[カスタム学習したルート] セクションで次の操作を行います。
1. [すべてのカスタム学習したルートの優先度] セクションで、ルート優先度を構成するには、このセッションに構成されたすべてのカスタム学習ルートの優先順位の値を 0 と 65535（両端を含む）の間で入力します。
  
  Google Cloud では、優先度の値が小さいルートが優先されます。複数のカスタム学習ルートで同じ IP アドレス範囲が構成されている場合、最適なパスはルートの優先度に基づいて選択されます。
2. [新しい IP アドレス範囲を追加] をクリックします。
3. [IP アドレス範囲] フィールドに、IPv4 または IPv6 プレフィックスを入力します。サブネットマスクのない IP プレフィックスを指定すると、IPv4 の場合は /32 サブネットマスク、IPv6 の場合は /128 サブネットマスクと解釈されます。
[保存] をクリックします。

gcloud

gcloud compute routers update-bgp-peer コマンドを実行します。

  gcloud compute routers update-bgp-peer ROUTER_NAME \
      --peer-name=PEER_NAME \
      --region=REGION \
      --add-custom-learned-route-ranges=IP_PREFIXES \
      --custom-learned-route-priority=ROUTE_PRIORITY

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

ROUTER_NAME: Cloud Router の名前
PEER_NAME: BGP ピアの名前
REGION: Cloud Router が配置されているリージョン
IP_PREFIXES: IPv4 または IPv6 プレフィックスのカンマ区切りリスト（例: 1.2.3.4,6.7.0.0,2001:db8:abcd:12::/64）

サブネットマスクのない IP プレフィックスを指定すると、IPv4 の場合は /32 サブネットマスク、IPv6 の場合は /128 サブネットマスクと解釈されます。使用できるカスタム学習ルートの最大数については、上限をご覧ください。
ROUTE_PRIORITY: このセッションに構成したすべてのカスタム学習ルートの優先値（0～65535、両端を含む）

Google Cloud では、優先度の値が小さいルートが優先されます。つまり、優先度が 100 のルートが優先度 200 のルートよりも優先されます。値を指定しない場合、Google Cloud 内部で 100 が値として適用されます。

API

compute.routers.patch メソッドを使用して bgpPeers 配列を更新します。

bgpPeers 配列にパッチを適用するときは、すべての項目のすべてのフィールドに値を指定する必要があります（一部の BGP ピアまたは一部の値を削除する場合を除きます）。

たとえば、Cloud Router に 2 つの BGP ピアがあるとします。最初の BGP ピアを変更せずに、2 番目のカスタム学習ルートを 2 番目の BGP ピアに追加するには、次のようなリクエストを使用します。

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
  {
    "bgpPeers": [
      {
        "name": "PEER_NAME_1",
        "interfaceName": "INTERFACE_NAME_1",
        "ipAddress": "IP_ADDRESS_1",
        "peerIpAddress": "PEER_IP_ADDRESS_1",
        "peerAsn": "PEER_ASN_1"
      },
      {
        "name": "PEER_NAME_2",
        "interfaceName": "INTERFACE_NAME_2",
        "ipAddress": "IP_ADDRESS_2",
        "peerIpAddress": "PEER_IP_ADDRESS_2",
        "peerAsn": "PEER_ASN_2",
        "customLearnedRoutePriority": "ROUTE_PRIORITY",
        "customLearnedIpRanges": [
         {
          "range": "IP_PREFIX_1"
         },
         {
          "range": "IP_PREFIX_2"
         }
       ]
      }
    ]
  }

プレースホルダの値を次のように置き換えます。

Cloud Router に関する値を入力します。

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

変更しない BGP ピアリングセッションの値を指定します。

PEER_NAME_1: BGP セッションの名前
INTERFACE_NAME_1: セッションが使用するインターフェースの名前
IP_ADDRESS_1: BGP セッションが使用する Cloud Router の IP アドレス
PEER_IP_ADDRESS_1: BGP ピアの IP アドレス
PEER_ASN_1: セッションの自律システム番号（ASN）

カスタム学習ルートを追加する BGP ピアリングセッションの値を指定します。

PEER_NAME_2: BGP セッションの名前
INTERFACE_NAME_2: セッションが使用するインターフェースの名前
IP_ADDRESS_2: BGP セッションが使用する Cloud Router の IP アドレス
PEER_IP_ADDRESS_2: BGP ピアの IP アドレス
PEER_ASN_2: セッションの自律システム番号（ASN）
ROUTE_PRIORITY: このセッションに構成したすべてのカスタム学習ルートの優先値（0～65535、両端を含む）

Google Cloud では、優先度の値が小さいルートが優先されます。つまり、優先度が 100 のルートが優先度 200 のルートよりも優先されます。値を指定しない場合、Google Cloud 内部で 100 が値として適用されます。
IP_PREFIX_1 と IP_PREFIX_2: これらのフィールドに、IPv4 または IPv6 のプレフィックスを入力します。

サブネットマスクのない IP プレフィックスを指定すると、IPv4 の場合は /32 サブネットマスク、IPv6 の場合は /128 サブネットマスクと解釈されます。使用できるカスタム学習ルートの最大数については、上限をご覧ください。

既存のカスタム学習ルートを上書きする

BGP セッションに定義されているカスタム学習ルートを置き換える場合は、次のガイダンスに従ってください。この操作を行うと、既存のカスタム学習ルートは破棄され、定義した新しいルートが優先されます。

コンソール

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

[Cloud Router] に移動
[名前] フィールドで、適切な Cloud Router の名前をクリックします。
[ルーターの詳細] ページで、変更する BGP セッションの名前をクリックします。
[BGP セッションの詳細] ページで、[編集] を選択します。
[アドバタイズされたルート、カスタム学習したルート、Bidirectional Forwarding Detection（BFD）] セクションを開きます。
[IP アドレス範囲] フィールドで、IPv4 または IPv6 のプレフィックスを編集します。サブネットマスクのない IP プレフィックスを指定すると、IPv4 の場合は /32 サブネットマスク、IPv6 の場合は /128 サブネットマスクと解釈されます。
[保存] をクリックします。

gcloud

gcloud compute routers update-bgp-peer コマンドを使用します。set-custom-learned-route-ranges フラグを使用すると、新しい IP プレフィックスを指定したり、以前に定義したプレフィックスをクリアできます。

  gcloud compute routers update-bgp-peer ROUTER_NAME \
      --peer-name=PEER_NAME \
      --region=REGION \
      --set-custom-learned-route-ranges=IP_PREFIXES

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

ROUTER_NAME: Cloud Router の名前
PEER_NAME: BGP ピアの名前
REGION: Cloud Router が配置されているリージョン
IP_PREFIXES: IPv4 または IPv6 プレフィックスのカンマ区切りリスト（例: 1.2.3.4,6.7.0.0,2001:db8:abcd:12::/64）

サブネットマスクのない IP プレフィックスを指定すると、IPv4 の場合は /32 サブネットマスク、IPv6 の場合は /128 サブネットマスクと解釈されます。すべてのプレフィックスをクリアするには、後ろに値を付けずにフラグを使用します。使用できるカスタム学習ルートの最大数については、上限をご覧ください。

API

compute.routers.patch メソッドを使用して bgpPeers 配列を更新します。

たとえば、Cloud Router に 2 つのピアがあるとします。片方はカスタム学習ルートを使用せず、もう片方は使用します。最初のピアを変更せずに、2 番目のピアで定義されているルートを上書きするには、次のようなリクエストを使用します。

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
  {
    "bgpPeers": [
      {
        "name": "PEER_NAME_1",
        "interfaceName": "INTERFACE_NAME_1",
        "ipAddress": "IP_ADDRESS_1",
        "peerIpAddress": "PEER_IP_ADDRESS_1",
        "peerAsn": "PEER_ASN_1"
      },
      {
        "name": "PEER_NAME_2",
        "interfaceName": "INTERFACE_NAME_2",
        "ipAddress": "IP_ADDRESS_2",
        "peerIpAddress": "PEER_IP_ADDRESS_2",
        "peerAsn": "PEER_ASN_2",
        "customLearnedRoutePriority": "ROUTE_PRIORITY",
        "customLearnedIpRanges": [
          {
           "range": "IP_PREFIX_1"
          },
          {
           "range": "IP_PREFIX_2"
          }
         ]
       }
     ]
   }

プレースホルダの値を次のように置き換えます。

Cloud Router に関する値を入力します。

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

変更しない BGP ピアリングセッションの値を指定します。

PEER_NAME_1: BGP セッションの名前
INTERFACE_NAME_1: セッションが使用するインターフェースの名前
IP_ADDRESS_1: セッションが使用する Cloud Router の IP アドレス
PEER_IP_ADDRESS_1: BGP ピアの IP アドレス
PEER_ASN_1: セッションの自律システム番号（ASN）

カスタム学習ルートを上書きする BGP ピアリングセッションの値を指定します。

PEER_NAME_2: BGP セッションの名前
INTERFACE_NAME_2: セッションが使用するインターフェースの名前
IP_ADDRESS_2: セッションが使用する Cloud Router の IP アドレス
PEER_IP_ADDRESS_2: BGP ピアの IP アドレス
PEER_ASN_2: セッションの自律システム番号（ASN）
ROUTE_PRIORITY: このセッションに構成したすべてのカスタム学習ルートの優先値（0～65535、両端を含む）

Google Cloud では、優先度の値が小さいルートが優先されます。つまり、優先度が 100 のルートが優先度 200 のルートよりも優先されます。値を指定しない場合、Google Cloud 内部で 100 が値として適用されます。
IP_PREFIX_1 と IP_PREFIX_2: これらのフィールドに、IPv4 または IPv6 のプレフィックスを入力します。

サブネットマスクのない IP アドレスを指定すると、IPv4 の場合は /32 サブネットマスク、IPv6 の場合は /128 サブネットマスクと解釈されます。使用できるカスタム学習ルートの最大数については、上限をご覧ください。

BGP セッションからカスタム学習したルートを削除する

BGP セッションからカスタム学習ルートの一部またはすべてを削除するには、次のガイダンスに従ってください。

コンソール

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

[Cloud Router] に移動
[名前] フィールドで、適切な Cloud Router の名前をクリックします。
[ルーターの詳細] ページで、変更する BGP セッションの名前をクリックします。
[BGP セッションの詳細] ページで、[編集] を選択します。
[アドバタイズされたルート、カスタム学習したルート、Bidirectional Forwarding Detection（BFD）] セクションを開きます。
[カスタム学習したルート] セクションで、削除する [IP アドレス範囲] の横にある [IP 範囲を削除] をクリックします。
[保存] をクリックします。

gcloud

gcloud compute routers update-bgp-peer コマンドを実行します。

  gcloud compute routers update-bgp-peer ROUTER_NAME \
      --peer-name=PEER_NAME \
      --region=REGION \
      --remove-custom-learned-route-ranges=IP_PREFIXES

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

ROUTER_NAME: Cloud Router の名前
PEER_NAME: BGP ピアの名前
REGION: Cloud Router が配置されているリージョン
IP_PREFIXES: 削除する IP プレフィックスのカンマ区切りリスト

API

compute.routers.patch メソッドを使用して bgpPeers 配列を更新します。

たとえば、Cloud Router に 2 つの BGP ピアがあるとします。片方はカスタム学習ルートを使用せず、もう片方は使用します。最初のピアを変更せずに、2 番目のピアで定義されているルートを削除するには、次のようなリクエストを使用します。

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
  {
    "bgpPeers": [
      {
        "name": "PEER_NAME_1",
        "interfaceName": "INTERFACE_NAME_1",
        "ipAddress": "IP_ADDRESS_1",
        "peerIpAddress": "PEER_IP_ADDRESS_1",
        "peerAsn": "PEER_ASN_1"
      },
      {
        "name": "PEER_NAME_2",
        "interfaceName": "INTERFACE_NAME_2",
        "ipAddress": "IP_ADDRESS_2",
        "peerIpAddress": "PEER_IP_ADDRESS_2",
        "peerAsn": "PEER_ASN_2"
      }
    ]
  }

プレースホルダの値を次のように置き換えます。

Cloud Router に関する値を入力します。

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

変更しない BGP ピアリングセッションの値を指定します。

PEER_NAME_1: BGP セッションの名前
INTERFACE_NAME_1: セッションが使用するインターフェースの名前
IP_ADDRESS_1: セッションが使用する Cloud Router の IP アドレス
PEER_IP_ADDRESS_1: BGP ピアの IP アドレス
PEER_ASN_1: セッションの自律システム番号（ASN）

カスタム学習ルートを削除する BGP ピアリングセッションの値を指定します。

PEER_NAME_2: セッションの名前
INTERFACE_NAME_2: セッションが使用するインターフェースの名前
IP_ADDRESS_2: セッションが使用する Cloud Router の IP アドレス
PEER_IP_ADDRESS_2: BGP ピアの IP アドレス
PEER_ASN_2: セッションの自律システム番号（ASN）

BGP セッションでカスタム学習したすべてのルートの優先度を変更する

BGP セッションを更新して、カスタム学習ルートに異なる優先度を使用する場合は、次のガイダンスに従ってください。優先度は常に BGP ピアに定義されたすべてのカスタムルートに適用されることに注意してください。IP プレフィックスごとに異なる優先度を適用することはできません。

コンソール

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

[Cloud Router] に移動
[名前] フィールドで、適切な Cloud Router の名前をクリックします。
[ルーターの詳細] ページで、変更する BGP セッションの名前をクリックします。
[BGP セッションの詳細] ページで、[編集] を選択します。
[アドバタイズされたルート、カスタム学習したルート、Bidirectional Forwarding Detection（BFD）] セクションを開きます。
[すべてのカスタム学習したルートの優先度] フィールドで、ルート優先度を編集するには、このセッションに構成されたすべてのカスタム学習ルートの優先順位の値を 0 と 65535（両端を含む）の間で入力します。

Google Cloud では、優先度の値が小さいルートが優先されます。複数のカスタム学習ルートで同じ IP アドレス範囲が構成されている場合、最適なパスはルートの優先度に基づいて選択されます。
[保存] をクリックします。

gcloud

gcloud compute routers update-bgp-peer コマンドを実行します。

  gcloud compute routers update-bgp-peer ROUTER_NAME \
      --peer-name=PEER_NAME \
      --region=REGION \
      --custom-learned-route-priority=NEW_ROUTE_PRIORITY

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

ROUTER_NAME: Cloud Router の名前
PEER_NAME: BGP ピアの名前
REGION: Cloud Router が配置されているリージョン
NEW_ROUTE_PRIORITY: このセッションに構成したすべてのカスタム学習ルートの優先値（0～65535、両端を含む）

Google Cloud では、優先度の値が小さいルートが優先されます。つまり、優先度が 100 のルートが優先度 200 のルートよりも優先されます。

API

compute.routers.patch メソッドを使用して bgpPeers 配列を更新します。

bgpPeers 配列にパッチを適用するときは、すべての項目のすべてのフィールドに値を指定する必要があります。ただし、一部の BGP ピアまたは一部の値を削除する場合を除きます。

たとえば、Cloud Router に 2 つの BGP ピアがあるとします。最初のピアを変更せずに、2 番目のピアに定義された 2 つのカスタム学習ルートの優先度を更新するには、次のようなリクエストを使用します。

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
  {
    "bgpPeers": [
      {
        "name": "PEER_NAME_1",
        "interfaceName": "INTERFACE_NAME_1",
        "ipAddress": "IP_ADDRESS_1",
        "peerIpAddress": "PEER_IP_ADDRESS_1",
        "peerAsn": "PEER_ASN_1"
      },
      {
        "name": "PEER_NAME_2",
        "interfaceName": "INTERFACE_NAME_2",
        "ipAddress": "IP_ADDRESS_2",
        "peerIpAddress": "PEER_IP_ADDRESS_2",
        "peerAsn": "PEER_ASN_2",
        "customLearnedRoutePriority": "NEW_ROUTE_PRIORITY",
        "customLearnedIpRanges": [
          {
           "range": "IP_PREFIX_1"
          },
          {
           "range": "IP_PREFIX_2"
          }
        ]
      }
    ]
  }

プレースホルダの値を次のように置き換えます。

Cloud Router に関する値を入力します。

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

変更しない BGP ピアリングセッションの値を指定します。

PEER_NAME_1: BGP セッションの名前
INTERFACE_NAME_1: セッションが使用するインターフェースの名前
IP_ADDRESS_1: セッションが使用する Cloud Router の IP アドレス
PEER_IP_ADDRESS_1: BGP ピアの IP アドレス
PEER_ASN_1: セッションの自律システム番号（ASN）

優先度を変更する BGP ピアリングセッションの値を指定します。

PEER_NAME_2: BGP セッションの名前
INTERFACE_NAME_2: セッションが使用するインターフェースの名前
IP_ADDRESS_2: セッションが使用する Cloud Router の IP アドレス
PEER_IP_ADDRESS_2: BGP ピアの IP アドレス
PEER_ASN_2: セッションの自律システム番号（ASN）
NEW_ROUTE_PRIORITY: このセッションに構成したすべてのカスタム学習ルートの優先値（0～65535、両端を含む）

Google Cloud では、優先度の値が小さいルートが優先されます。つまり、優先度が 100 のルートが優先度 200 のルートよりも優先されます。
IP_PREFIX_1 と IP_PREFIX_2: BGP セッションにすでに定義されている IP プレフィックス

カスタム学習ルートのステータスを確認する

カスタム学習ルートのステータスを確認するには、次のガイダンスに従ってください。

コンソール

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

[Cloud Router] に移動
[名前] フィールドで、適切な Cloud Router の名前をクリックします。
[ルーターの詳細] ページで、変更する BGP セッションの名前をクリックします。
[BGP セッションの詳細] ページで、[編集] を選択します。
[アドバタイズされたルート、カスタム学習したルート、Bidirectional Forwarding Detection（BFD）] セクションを開きます。
ルートの優先度は、[すべてのカスタム学習したルートの優先度] フィールドで確認してください。

Google Cloud では、優先度の値が小さいルートが優先されます。つまり、優先度が 100 のルートが優先度 200 のルートよりも優先されます。
IP アドレス範囲は、[IP アドレス範囲] フィールドで確認してください。

gcloud

BGP セッションの構成を確認するには、gcloud compute routers describe コマンドを使用します。次に例を示します。
```
gcloud compute routers describe ROUTER_NAME \
    --region=REGION
```
次のように置き換えます。
- ROUTER_NAME: Cloud Router の名前
- REGION: Cloud Router が配置されているリージョン
このコマンドの出力には、BGP セッションごとに構成された IP プレフィックスと優先度が含まれます。
カスタム学習ルートのいずれかがルーターの最適ルートと見なされるかどうかを確認するには、gcloud compute routers get-status コマンドを使用します。
```
gcloud compute routers get-status ROUTER_NAME \
    --region=REGION
```
次のように置き換えます。
- ROUTER_NAME: Cloud Router の名前
- REGION: Google Cloud リージョン
出力には、Cloud Router の最適ルートと各 BGP セッションの状態が表示されます。

API

BGP セッション構成の詳細を取得するには、routers.get メソッドを使用します。
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
```
次のように置き換えます。
- PROJECT_ID: Cloud Router が含まれるプロジェクト
- REGION: Cloud Router が配置されているリージョン
- ROUTER_NAME: Cloud Router の名前
出力の bgpPeers フィールドに、各 BGP セッションの構成が含まれます。
routers.getRouterStatus メソッドを使用します。
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/getRouterStatus
```
次のように置き換えます。
- PROJECT_ID: Cloud Router が含まれるプロジェクト
- REGION: Cloud Router が配置されているリージョン
- ROUTER_NAME: Cloud Router の名前
出力には、Cloud Router の最適ルートと各 BGP セッションの状態が表示されます。

次のステップ

BGP セッションの状態については、BGP セッションの状態をご覧ください。
Cloud Router のトラブルシューティングについては、トラブルシューティングをご覧ください。