BGP-Sitzungen deaktivieren oder entfernen

Sie können eine BGP-Sitzung vorübergehend deaktivieren oder vollständig entfernen. Häufige Gründe für das Deaktivieren einer Sitzung sind das Ändern der Routerkonfiguration bei der Migration zu einem anderen BGP-Peer oder die Ausführung von Wartungsarbeiten an einem BGP-Peer.

Hinweise

gcloud

Wenn Sie die Befehlszeilenbeispiele in dieser Anleitung verwenden möchten, gehen Sie so vor:

  1. Installieren Sie das Google Cloud CLI oder aktualisieren Sie es auf die neueste Version.
  2. Legen Sie eine Standardregion und -zone fest.

API

Wenn Sie die API-Beispiele dieser Anleitung verwenden möchten, richten Sie den API-Zugang ein.

BGP-Sitzung deaktivieren

Sie können eine BGP-Sitzung über die Google Cloud Console, den Befehl update-bgp-peer oder die API deaktivieren. BGP-Sitzungen sind standardmäßig aktiviert.

Wenn diese Option deaktiviert ist, werden alle aktiven Sitzungen mit dem BGP-Peer beendet und alle zugehörigen Routinginformationen entfernt.

Führen Sie die folgenden Schritte aus, um eine BGP-Sitzung zu deaktivieren.

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Routers.

    Zu "Cloud Router"

  2. Wählen Sie den Router aus, der die BGP-Sitzung hostet, die Sie deaktivieren möchten.
  3. Wählen Sie auf der Seite Routerdetails die BGP-Sitzung aus, die Sie deaktivieren möchten.
  4. Klicken Sie auf der Seite mit den BGP-Sitzungsdetails auf Bearbeiten.
  5. Wählen Sie für BGP-Peer die Option Deaktiviert aus.
  6. Klicken Sie auf Speichern.

gcloud

Führen Sie den Befehl update-bgp-peer aus:

  gcloud compute routers update-bgp-peer ROUTER_NAME \
      --project=PROJECT_ID \
      --peer-name=PEER_NAME \
      --region=REGION \
      --no-enabled

Ersetzen Sie Folgendes:

  • ROUTER_NAME: Der Name Ihres Cloud Routers
  • PROJECT_ID: Das Projekt, das den Cloud Router enthält
  • PEER_NAME: Der Name Ihres BGP-Peers
  • REGION: Die Region, in der sich der Cloud Router befindet

API

Verwenden Sie die Methode routers.patch, um das Feld bgpPeers[] zu aktualisieren.

Im Feld bgpPeers[] wird ein Array von BGP-Peers akzeptiert. Wenn Sie PATCH auf dieses Feld anwenden, überschreiben Sie das vorhandene Array von BGP-Peers mit dem neuen Array, das in der Anfrage enthalten ist.

  1. Senden Sie eine GET-Anfrage, um das aktuelle Array von BGP-Peers für den Router abzurufen. Weitere Informationen finden Sie unter BGP-Sitzungskonfiguration aufrufen.

  2. Senden Sie eine PATCH-Anfrage mit einem neuen Array von BGP-Peers. Legen Sie für jeden BGP-Peer, für den Sie die BGP-Sitzung deaktivieren möchten, bgpPeers[].enable auf FALSE fest.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
    {
      "bgpPeers": [
        BGP_PEERS
      ]
    }
    

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Das Projekt, das den Cloud Router enthält
    • REGION: Die Region, in der sich der Cloud Router befindet
    • ROUTER_NAME: Der Name des Cloud Routers
    • BGP_PEERS: Der Inhalt des neuen Arrays von BGP-Peers

    Im folgenden Beispiel wird die Sitzung für den ersten BGP-Peer deaktiviert:

        {
          "name": "peer-1",
          "interfaceName": "if-peer-1",
          "ipAddress": "169.254.10.1",
          "peerIpAddress": "169.254.10.2",
          "peerAsn": 64512,
          "advertisedRoutePriority": 100,
          "advertiseMode": "DEFAULT",
          "advertisedGroups": [],
          "advertisedIpRanges": [],
          "enable": "FALSE"
        },
        {
          "name": "peer-2",
          "interfaceName": "if-peer-2",
          "ipAddress": "169.254.20.1",
          "peerIpAddress": "169.254.20.2",
          "peerAsn": 64513,
          "advertisedRoutePriority": 100,
          "advertiseMode": "DEFAULT",
          "advertisedGroups": [],
          "advertisedIpRanges": []
        }
    

BGP-Sitzung aktivieren

Sie können eine BGP-Sitzung über die Google Cloud Console, den Befehl update-bgp-peer oder die API aktivieren. BGP-Sitzungen sind standardmäßig aktiviert.

Wenn diese Option aktiviert ist, kann die Peer-Verbindung mit Routinginformationen hergestellt werden.

Führen Sie die folgenden Schritte aus, um eine BGP-Sitzung zu aktivieren.

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Routers.

    Zu "Cloud Router"

  2. Wählen Sie den Router aus, der die BGP-Sitzung hostet, die Sie aktivieren möchten.
  3. Wählen Sie auf der Seite Routerdetails die BGP-Sitzung aus, die Sie aktivieren möchten.
  4. Klicken Sie auf der Seite mit den BGP-Sitzungsdetails auf Bearbeiten.
  5. Wählen Sie für BGP-Peer die Option Aktiviert aus.
  6. Klicken Sie auf Speichern.

gcloud

Führen Sie den Befehl update-bgp-peer aus:

  gcloud compute routers update-bgp-peer ROUTER_NAME \
      --project=PROJECT_ID \
      --peer-name=PEER_NAME \
      --region=REGION \
      --enabled

Ersetzen Sie Folgendes:

  • ROUTER_NAME: Der Name Ihres Cloud Routers
  • PROJECT_ID: Das Projekt, das den Cloud Router enthält
  • PEER_NAME: Der Name Ihres BGP-Peers
  • REGION: Die Region, in der sich der Cloud Router befindet

API

Verwenden Sie die Methode routers.patch, um das Feld bgpPeers[] zu aktualisieren.

Im Feld bgpPeers[] wird ein Array von BGP-Peers akzeptiert. Wenn Sie eine PATCH-Anfrage mit diesem Feld stellen, überschreiben Sie das vorhandene Array von BGP-Peers mit dem neuen Array, das in der Anfrage enthalten ist.

  1. Senden Sie eine GET-Anfrage, um das aktuelle Array von BGP-Peers für den Router abzurufen. Weitere Informationen finden Sie unter Details zu Cloud Router aufrufen.

  2. Senden Sie eine PATCH-Anfrage mit einem neuen Array von BGP-Peers. Legen Sie für jeden BGP-Peer, für den Sie die BGP-Sitzung aktivieren möchten, bgpPeers[].enable auf TRUE fest.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
    {
      "bgpPeers": [
        BGP_PEERS
      ]
    }
    

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Das Projekt, das den Cloud Router enthält
    • REGION: Die Region, in der sich der Cloud Router befindet
    • ROUTER_NAME: Der Name des Cloud Routers
    • BGP_PEERS: Der Inhalt des neuen Arrays von BGP-Peers

    Im folgenden Beispiel wird die Sitzung für den ersten BGP-Peer aktiviert:

        {
          "name": "peer-1",
          "interfaceName": "if-peer-1",
          "ipAddress": "169.254.10.1",
          "peerIpAddress": "169.254.10.2",
          "peerAsn": 64512,
          "advertisedRoutePriority": 100,
          "advertiseMode": "DEFAULT",
          "advertisedGroups": [],
          "advertisedIpRanges": [],
          "enable": "TRUE"
        },
        {
          "name": "peer-2",
          "interfaceName": "if-peer-2",
          "ipAddress": "169.254.20.1",
          "peerIpAddress": "169.254.20.2",
          "peerAsn": 64513,
          "advertisedRoutePriority": 100,
          "advertiseMode": "DEFAULT",
          "advertisedGroups": [],
          "advertisedIpRanges": []
        }
    

BGP-Sitzung entfernen

Wenn Sie den Cloud VPN-Tunnel oder den VLAN-Anhang löschen, der einer BGP-Sitzung zugeordnet ist, wird die Sitzung automatisch heruntergefahren.

Sie können BGP-Sitzungen manuell über die Google Cloud Console, den Befehl remove-bgp-peer oder die API entfernen. Wenn Sie die BGP-Sitzung entfernen, bleibt der VPN-Tunnel oder VLAN-Anhang zwar bestehen, der Cloud Router bewirbt jedoch keine Routen darüber.

Führen Sie die folgenden Schritte aus, um eine BGP-Sitzung zu entfernen.

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Routers.

    Zu "Cloud Router"

  2. Wählen Sie den Router aus, von dem Sie eine BGP-Sitzung entfernen möchten.
  3. Wählen Sie unter BGP-Sitzungen die BGP-Sitzung aus, die Sie entfernen möchten.
  4. Klicken Sie oben auf der Seite auf Löschen und bestätigen Sie den Löschvorgang.

gcloud

Führen Sie den Befehl remove-bgp-peer aus:

gcloud compute routers remove-bgp-peer ROUTER_NAME \
    --project=PROJECT_ID \
    --peer-name=PEER_NAME \
    --region=REGION \

Ersetzen Sie Folgendes:

  • ROUTER_NAME: Der Name Ihres Cloud Routers
  • PROJECT_ID: Das Projekt, das den Cloud Router enthält
  • PEER_NAME: Der Name Ihres BGP-Peers
  • REGION: Die Region, in der sich der Cloud Router befindet

API

Verwenden Sie zum Entfernen von BGP-Peers von einem Cloud Router die Methode routers.patch, um das Feld bgpPeers[] zu aktualisieren.

Im Feld bgpPeers[] wird ein Array von BGP-Peers akzeptiert. Wenn Sie PATCH auf dieses Feld anwenden, überschreiben Sie das vorhandene Array von BGP-Peers mit dem neuen Array, das in der Anfrage enthalten ist.

  1. Senden Sie eine GET-Anfrage, um das aktuelle Array von BGP-Peers für den Router abzurufen. Weitere Informationen finden Sie unter Details zu Cloud Router aufrufen.

  2. Senden Sie eine PATCH-Anfrage mit einem neuen Array von BGP-Peers. Verwenden Sie das Array aus der GET-Anfrage im vorherigen Schritt und entfernen Sie alle BGP-Peers, die nicht auf dem Router enthalten sein sollen.

    Sie können ein leeres Array senden, um alle BGP-Peers zu entfernen.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
    {
      "bgpPeers": [
        BGP_PEERS
      ]
    }
    

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Das Projekt, das den Cloud Router enthält
    • REGION: Die Region, in der sich der Cloud Router befindet
    • ROUTER_NAME: Der Name des Cloud Routers
    • BGP_PEERS: Der Inhalt des neuen Arrays von BGP-Peers

    Das folgende Beispiel enthält zwei BGP-Peers:

        {
          "name": "peer-1",
          "interfaceName": "if-peer-1",
          "ipAddress": "169.254.10.1",
          "peerIpAddress": "169.254.10.2",
          "peerAsn": 64512,
          "advertisedRoutePriority": 100,
          "advertiseMode": "DEFAULT"
        },
        {
          "name": "peer-2",
          "interfaceName": "if-peer-2",
          "ipAddress": "169.254.20.1",
          "peerIpAddress": "169.254.20.2",
          "peerAsn": 64513,
          "advertisedRoutePriority": 100,
          "advertiseMode": "DEFAULT"
        }
    

Nächste Schritte

  • Informationen zur Konfiguration eines Cloud Routers, seiner BGP-Sitzungen und der Routen, die Cloud Router bewirbt, finden Sie unter Cloud Router-Details aufrufen.
  • Weitere Informationen zum BGP-Sitzungsstatus finden Sie unter BGP-Sitzungsstatus.
  • Informationen zur Fehlerbehebung bei Cloud Router finden Sie unter Fehlerbehebung.