Netzwerke erstellen und verwalten

Auf dieser Seite wird beschrieben, wie Sie Google Distributed Cloud-Netzwerkressourcen in einer Distributed Cloud Connected-Zone erstellen und verwalten.

Distributed Cloud Connected-Server werden mit einem vorkonfigurierten Netzwerk ausgeliefert, dem Standardnetzwerk von Distributed Cloud. Distributed Cloud Connected-Server unterstützen die Konfiguration zusätzlicher Netzwerke nicht.

Weitere Informationen zu Distributed Cloud-Netzwerken finden Sie unter Funktionsweise von Distributed Cloud Connected.

Beachten Sie Folgendes:

  • Sie können bis zu 100 Netzwerke pro Distributed Cloud-Zone erstellen.
  • Ein Netzwerk ist ein virtuelles privates Netzwerk, das in der Zielzone instanziiert wird.
  • Das Netzwerk wird als Virtual Routing Function (VRF) instanziiert.
  • Pakete werden unabhängig voneinander innerhalb eines Netzwerks weitergeleitet.
  • Wenn sich Ihr Zonen Google Cloud projekt und Ihr Cluster Google Cloud projekt unterscheiden, müssen Sie dem Cluster Google Cloud projekt die Berechtigung im Zonen Google Cloud projekt erteilen, um den Zugriff auf die Edge Network API zu ermöglichen. Eine Anleitung finden Sie unter Aktionen in Clustern mit rollenbasierter Zugriffssteuerung autorisieren.

Netzwerk erstellen

Führen Sie die Schritte in diesem Abschnitt aus, um ein Distributed Cloud-Netzwerk zu erstellen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkadministrator“ (roles/edgenetwork.admin) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking networks create aus:

gcloud edge-cloud networking networks create NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --mtu=MTU_SIZE

Ersetzen Sie Folgendes:

  • NETWORK_NAME: ein beschreibender Name, der dieses Netzwerk eindeutig identifiziert.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.
  • MTU_SIZE: die Größe der maximalen Übertragungseinheit (Maximum Transmission Unit, MTU) für dieses Netzwerk. Gültige Werte sind 1500 und 9000. Dieser Wert muss mit der MTU-Größe des Netzwerks default übereinstimmen und für alle Netzwerke gleich sein.

API

Senden Sie eine POST-Anfrage an die Methode projects.locations.zones.networks.create:

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks?networkId=NETWORK_ID
{
 "labels": { LABELS,
  },
 "mtu": { MTU_SIZE,
  },
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID desZielprojekts. Google Cloud
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud-Zielzone.
  • NETWORK_ID: eine eindeutige ID, die dieses Netzwerk identifiziert.
  • LABELS: eine Liste von Labels, die auf diese Netzwerkressource angewendet werden sollen.
  • MTU_SIZE: die Größe der maximalen Übertragungseinheit (Maximum Transmission Unit, MTU) für dieses Netzwerk. Gültige Werte sind 1500 und 9000.

Netzwerke auflisten

Führen Sie die Schritte in diesem Abschnitt aus, um in einer Distributed Cloud Connected-Zone bereitgestellte Distributed Cloud-Netzwerke aufzulisten.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkbetrachter“ (roles/edgenetwork.viewer) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking networks list aus:

gcloud edge-cloud networking networks list \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

API

Senden Sie eine GET-Anfrage an die Methode projects.locations.zones.networks.list:

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID desZielprojekts. Google Cloud
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud-Zielzone.
  • FILTER: ein Ausdruck, der die zurückgegebenen Ergebnisse auf bestimmte Werte beschränkt.
  • PAGE_SIZE: die Anzahl der Ergebnisse, die pro Seite zurückgegeben werden sollen.
  • SORT_BY: eine durch Kommas getrennte Liste von Feldnamen, nach denen die zurückgegebenen Ergebnisse sortiert werden. Die Standardsortierreihenfolge ist aufsteigend. Für eine absteigende Sortierreihenfolge stellen Sie dem gewünschten Feld ein ~ voran.
  • PAGE_TOKEN: ein Token, das in der Antwort auf die letzte Listenanfrage im Feld nextPageToken enthalten ist. Senden Sie dieses Token, um eine Seite mit Ergebnissen zu erhalten.

Informationen zu einem Netzwerk abrufen

Führen Sie die Schritte in diesem Abschnitt aus, um Informationen zu einem Distributed Cloud-Netzwerk abzurufen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkbetrachter“ (roles/edgenetwork.viewer) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking networks describe aus:

gcloud edge-cloud networking networks describe NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • NETWORK_NAME: der Name des Zielnetzwerks.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

API

Senden Sie eine GET-Anfrage an die Methode projects.locations.zones.networks.get:

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID desZielprojekts. Google Cloud
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.
  • NETWORK_ID: die ID des Zielnetzwerks.

Betriebsstatus eines Netzwerks prüfen

Führen Sie die Schritte in diesem Abschnitt aus, um den Betriebsstatus eines Distributed Cloud-Netzwerks zu prüfen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkbetrachter“ (roles/edgenetwork.viewer) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking networks get-status aus:

gcloud edge-cloud networking networks get-status NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • NETWORK_NAME: der Name des Zielnetzwerks.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

API

Senden Sie eine GET-Anfrage an die Methode projects.locations.zones.networks.diagnose:

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID:diagnose

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID desZielprojekts. Google Cloud
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.
  • NETWORK_ID: die ID des Zielnetzwerks.

Netzwerk löschen

Führen Sie die Schritte in diesem Abschnitt aus, um ein Distributed Cloud-Netzwerk zu löschen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkadministrator“ (roles/edgenetwork.admin) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking networks delete aus:

gcloud edge-cloud networking networks delete NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • NETWORK_NAME: der Name des Zielnetzwerks.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

API

Senden Sie eine DELETE-Anfrage an die Methode projects.locations.zones.networks.delete:

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID desZielprojekts. Google Cloud
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.
  • NETWORK_ID: die ID des Zielnetzwerks.

Nächste Schritte