Cloud-Router verwalten

In diesem Dokument wird beschrieben, wie Sie Cloud Router auflisten, aktualisieren, den Status abrufen und löschen.

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.

Cloud Router auflisten

Führen Sie die folgenden Schritte aus, um alle Cloud Router in einem Projekt aufzulisten.

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Cloud Router auf.

    Zu Cloud Routers

  2. Rufen Sie auf der Seite Cloud Router eine Liste der Cloud Router auf.

gcloud

Führen Sie den Befehl list aus: Um die Liste auf eine einzige Region zu beschränken, geben Sie --filter="region:(<var>REGION</var>) an.

  gcloud compute routers list \
      --project=PROJECT_ID \
      [--filter="region:(REGION)]

Ersetzen Sie Folgendes:

  • PROJECT_ID: Die ID des Projekts, für das Sie Cloud Router auflisten möchten
  • REGION: Die Region, für die Sie Router auflisten möchten, z. B. asia-east1

Die Ausgabe sieht etwa so aus:

  NAME        REGION       NETWORK
  my-router   asia-east1   my-network

API

Verwenden Sie die Methode routers.aggregatedList:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/routers

Ersetzen Sie PROJECT_ID durch die ID des Projekts, für das Sie Cloud Router auflisten möchten.

Verwenden Sie die Methode routers.list, um nur die Cloud Router in einer bestimmten Region aufzulisten.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: Die ID des Projekts, für das Sie Cloud Router auflisten möchten
  • REGION: Die Region, für die Sie Cloud Router auflisten möchten

Cloud Router aktualisieren

Wenn ein Cloud Router mit einem NCC-Gateway verknüpft ist, beachten Sie Folgendes:

  • Das Feld ncc_gateway kann nicht aktualisiert werden.

  • Bei den Methoden patch oder update ist das Feld network nicht als Teil des Anfragetexts zulässig.

gcloud

Führen Sie folgenden gcloud compute routers update-Befehl aus:

gcloud compute routers update ROUTER_NAME
    --region=REGION

Ersetzen Sie Folgendes:

  • ROUTER_NAME: der Name des Cloud Router, den Sie aktualisieren möchten
  • REGION: Die Region, in der sich der Cloud Router befindet

API

Verwenden Sie die Methode routers.update:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME

Ersetzen Sie Folgendes:

  • PROJECT_ID: Die ID des Projekts, für das Sie Cloud Router auflisten möchten
  • REGION: Die Region, in der sich der Cloud Router befindet
  • ROUTER_NAME: der Name des Cloud Router, den Sie aktualisieren möchten

Cloud Router-Status abrufen

gcloud

Führen Sie den Befehl gcloud compute routers get-status aus.

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

Ersetzen Sie Folgendes:

  • ROUTER_NAME: Der Name des Cloud Router, dessen Status Sie abrufen möchten.
  • PROJECT_ID: die Projekt-ID, zu der der Cloud Router gehört
  • REGION: Die Region, in der sich der Cloud Router befindet

API

Verwenden Sie die Methode routers.getRouterStatus mit einem leeren Anfragetext:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID, zu der der Cloud Router gehört
  • REGION: Die Region, in der sich der Cloud Router befindet
  • ROUTER_NAME: Der Name des Cloud Router, dessen Status Sie abrufen möchten.

Cloud Router löschen

Prüfen Sie vor dem Löschen eines Cloud Router, ob er von einer anderen Ressource verwendet wird, z. B. einem Cloud VPN-Tunnel oder einem VLAN-Anhang. Sie müssen die zugeordnete Ressource löschen, bevor Sie den Cloud Router löschen können. Sie müssen jedoch keine BGP-Sitzungen entfernen, bevor Sie den Cloud Router löschen.

So löschen Sie den Cloud Router:

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Cloud Router auf.

    Zu Cloud Routers

  2. Klicken Sie das Kästchen neben dem Cloud Router an, den Sie löschen möchten.

  3. Klicken Sie auf Löschen.

gcloud

Führen Sie den Befehl delete aus: Geben Sie den Namen und den Standort des Cloud Routers an, den Sie löschen möchten.

gcloud compute routers delete ROUTER_NAME \
    --project=PROJECT_ID \
    --region=REGION

Ersetzen Sie Folgendes:

  • ROUTER_NAME: Der Name des Cloud Router, den Sie löschen möchten.

  • PROJECT_ID: die ID des Projekts, das den zu löschenden Cloud Router enthält

  • REGION: Die Region, in der sich der Cloud Router befindet

Die Ausgabe sieht etwa so aus:

Deleted [https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/asia-east1/routers/ROUTER_NAME].

API

Verwenden Sie die Methode routers.delete:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, das den zu löschenden Cloud Router enthält
  • REGION: Die Region, in der sich der Cloud Router befindet
  • ROUTER_NAME: Der Name des Cloud Routers

Nächste Schritte

  • Informationen zur Konfiguration eines Cloud Routers, seiner BGP-Sitzungen und der Routen, die Cloud Router bewirbt, finden Sie unter Router-Details aufrufen.
  • Informationen zur Behebung von Problemen bei der Verwendung von Cloud Router finden Sie unter Fehlerbehebung.