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:

Installieren Sie das Google Cloud CLI oder aktualisieren Sie es auf die neueste Version.
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

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

Zu "Cloud Router"
Wählen Sie den Router aus, der die BGP-Sitzung hostet, die Sie deaktivieren möchten.
Wählen Sie auf der Seite Routerdetails die BGP-Sitzung aus, die Sie deaktivieren möchten.
Klicken Sie auf der Seite mit den BGP-Sitzungsdetails auf Bearbeiten.
Wählen Sie für BGP-Peer die Option Deaktiviert aus.
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.

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.

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

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

Zu "Cloud Router"
Wählen Sie den Router aus, der die BGP-Sitzung hostet, die Sie aktivieren möchten.
Wählen Sie auf der Seite Routerdetails die BGP-Sitzung aus, die Sie aktivieren möchten.
Klicken Sie auf der Seite mit den BGP-Sitzungsdetails auf Bearbeiten.
Wählen Sie für BGP-Peer die Option Aktiviert aus.
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.

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.

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

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

Zu "Cloud Router"
Wählen Sie den Router aus, von dem Sie eine BGP-Sitzung entfernen möchten.
Wählen Sie unter BGP-Sitzungen die BGP-Sitzung aus, die Sie entfernen möchten.
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.

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.

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.