Subnetzwerke erstellen und verwalten

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

Weitere Informationen zu Distributed Cloud-Subnetzwerken, siehe Funktionsweise von Distributed Cloud verbunden.

Beachten Sie Folgendes:

  • Sie können bis zu 138 Subnetzwerke pro Distributed Cloud-Zone erstellen.
  • Das Subnetzwerk ist ein VLAN innerhalb des übergeordneten Netzwerks. Daher muss jedes Subnetzwerk eine global eindeutige VLAN-ID haben. Bei Distributed Cloud verbunden ist die Wiederverwendung von VLAN-IDs nicht zulässig.
  • Wenn Distributed Cloud verbunden eine nicht verwendete VLAN-ID nach dem Zufallsprinzip zuweisen soll, geben Sie beim Erstellen des Subnetzwerks 0 als VLAN-ID an.
  • Das Subnetzwerk ist für alle Knoten in Ihrer Distributed Cloud-Zone zugänglich.

Subnetzwerk erstellen

Führen Sie die Schritte in diesem Abschnitt aus, um ein Distributed Cloud-Subnetzwerk 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 subnets create aus:

gcloud edge-cloud networking subnets create SUBNETWORK_NAME \
    --network=NETWORK_NAME \
    --ipv4-range=IPV4_RANGE \
    --vlan-id=VLAN_ID \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • SUBNETWORK_NAME: ein beschreibender Name, der dieses Subnetzwerk eindeutig identifiziert.
  • NETWORK_NAME: das Netzwerk, das dieses Subnetzwerk kapselt.
  • IPV4_RANGE: der IPv4-Adressbereich, der von diesem Subnetzwerk im Format „IP-Adresse/Präfix“ abgedeckt wird.
  • VLAN_ID: die Ziel-VLAN-ID für dieses Subnetzwerk.
  • REGION: die Google Cloud Region, zu der die Ziel-Distributed Cloud-Zone gehört.
  • ZONE_NAME: der Name der Ziel-Distributed Cloud-Zone.

API

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

 POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets?subnetId=SUBNETWORK_ID
 {
  "labels": { LABELS,
   },
  "network": { NETWORK_NAME,
   },
  "ipv4Cidr": { IPV4_RANGE,
   },
  "vlanId": { VLAN_ID,
   },
 }

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Ziel Google Cloud projekts.
  • REGION: die Google Cloud Region, zu der die Ziel- Distributed Cloud-Zone gehört.
  • ZONE_NAME: der Name der Ziel-Distributed Cloud-Zone.
  • SUBNETWORK_ID: eine ID, die dieses Subnetzwerk eindeutig identifiziert.
  • LABELS: eine Liste von Labels, die auf diese Subnetzwerkressource angewendet werden sollen.
  • NETWORK_NAME: das Netzwerk, das dieses Subnetzwerk kapselt.
  • IPV4_RANGE: der IPv4-Adressbereich, der von diesem Subnetzwerk im Format „IP-Adresse/Präfix“ abgedeckt wird.
  • VLAN_ID: die Ziel-VLAN-ID für dieses Subnetzwerk.

Subnetzwerke auflisten

Führen Sie die Schritte in diesem Abschnitt aus, um Subnetzwerke aufzulisten, die in einer Distributed Cloud-Zone bereitgestellt wurden.

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 subnets list aus:

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

Ersetzen Sie Folgendes:

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

API

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

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Ziel Google Cloud projekts.
  • REGION: die Google Cloud Region, zu der die Ziel- Distributed Cloud-Zone gehört.
  • ZONE_NAME: der Name der Ziel-Distributed Cloud-Zone.
  • 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 Subnetzwerk abrufen

Führen Sie die Schritte in diesem Abschnitt aus, um Informationen zu einem Distributed Cloud-Subnetzwerk 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 subnets describe aus:

gcloud edge-cloud networking subnets describe SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • SUBNETWORK_NAME: der Name des Zielsubnetzwerks.
  • REGION: die Google Cloud Region, zu der die Ziel- Distributed Cloud-Zone gehört.
  • ZONE_NAME: der Name der Ziel-Distributed Cloud-Zone.

API

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

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets/SUBNETWORK_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Ziel Google Cloud projekts.
  • REGION: die Google Cloud Region, zu der die Ziel-Distributed Cloud-Zone gehört.
  • ZONE_NAME: der Name der Ziel-Distributed Cloud-Zone.
  • SUBNETWORK_NAME: der Name des Zielsubnetzwerks.

Dieser Vorgang gibt detaillierte Informationen zur Ressource zurück, einschließlich des Bereitstellungsstatus:

  • PENDING: Die Bereitstellung der Ressource hat noch nicht begonnen und sie wurde noch nicht in der gesamten Zone weitergegeben.
  • PROVISIONING: Die Ressource wird bereitgestellt. Sie müssen warten, bis sie in der gesamten Zone weitergegeben wurde.
  • RUNNING: Die Ressource wurde erfolgreich bereitgestellt und in der gesamten Zone weitergegeben. Sie kann verwendet werden.
  • FAILED: Die Bereitstellung der Ressource war nicht erfolgreich. Die Ressource wurde nicht in der gesamten Zone weitergegeben.

Subnetzwerk löschen

Führen Sie die Schritte in diesem Abschnitt aus, um ein Distributed Cloud-Subnetzwerk 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 subnets delete aus:

gcloud edge-cloud networking subnets delete SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • SUBNETWORK_NAME: der Name des Zielsubnetzwerks.
  • REGION: die Google Cloud Region, zu der die Ziel-Distributed Cloud-Zone gehört.
  • ZONE_NAME: der Name der Ziel-Distributed Cloud-Zone.

API

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

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets/SUBNETWORK_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Ziel Google Cloud projekts.
  • REGION: die Google Cloud Region, zu der die Ziel-Distributed Cloud-Zone gehört.
  • ZONE_NAME: der Name der Ziel-Distributed Cloud-Zone.
  • SUBNETWORK_NAME: der Name des Zielsubnetzwerks.

Nächste Schritte