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. Rufen Sie in der Google Cloud Console die Seite Cloud Router auf.

    Zu Cloud Routers

  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. Rufen Sie in der Google Cloud Console die Seite Cloud Router auf.

    Zu Cloud Routers

  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. Rufen Sie in der Google Cloud Console die Seite Cloud Router auf.

    Zu Cloud Routers

  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.