Routen verwenden

Console

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

   Zur Seite „Routes“

2. Führen Sie auf dem Tab Aktive Routen folgende Schritte aus:

   • Wählen Sie ein VPC-Netzwerk aus.
   • Wählen Sie eine Region aus.

3. Klicken Sie auf Ansehen.

4. Sie können nach Eigenschaften wie Routentyp, Ziel-IP-Bereich und Typ des nächsten Hops filtern.

5. Optional: Stellen Sie den Schalter Unterdrückte Routen anzeigen auf „Ein“, um unterdrückte Routen aufzurufen. Wenn Sie den Grund für die Unterdrückung einer Route sehen möchten, bewegen Sie den Mauszeiger auf das Symbol in der Spalte Status.

gcloud

Verwenden Sie die gcloud compute routes-Befehle, um Subnetzrouten und statische Routen aufzulisten und Details dazu aufzurufen. Mit diesen Befehlen werden keine anderen Routentypen angezeigt. Verwenden Sie die Google Cloud Console, um alle Routen aufzurufen.

So listen Sie Routen auf:

gcloud compute routes list \
    --filter="network=NETWORK_NAME" \
    --project=PROJECT_ID

So rufen Sie Details zu einer Route ab:

gcloud compute routes describe ROUTE_NAME \
    --format="flattened()" \
    --project=PROJECT_ID

Ersetzen Sie Folgendes:

• NETWORK_NAME: Der Name des VPC-Netzwerks
• PROJECT_ID: die Projekt-ID, die Ihr VPC-Netzwerk enthält
• ROUTE_NAME: der Name der Route

API

Verwenden Sie die Methoden routes.list und routes.get, um Subnetzrouten und statische Routen aufzulisten und Details dazu aufzurufen. Mit diesen Methoden werden keine anderen Routentypen angezeigt. Verwenden Sie die Google Cloud Console, um alle Routen aufzurufen.

So listen Sie Routen auf:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/routes?filter=network="NETWORK_URL

So rufen Sie Details zu einer Route ab:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/routes/ROUTE_NAME

Ersetzen Sie Folgendes:

• PROJECT_ID: die Projekt-ID, die Ihr VPC-Netzwerk enthält
• NETWORK_URL: die URL des VPC-Netzwerk
• ROUTE_NAME: der Name der Route

Console

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

   Zur Seite „VM-Instanzen“

2. Suchen Sie nach einer VM-Instanz in der Liste. Wählen Sie am Ende der Zeile im Menü more_vertWeitere Aktionen die Option Netzwerkdetails anzeigen aus.

3. Wenn eine Instanz mehrere Netzwerkschnittstellen hat, wählen Sie im Abschnitt Details zur Netzwerkschnittstelle die Netzwerkschnittstelle aus, die Sie aufrufen möchten.

4. Klicken Sie im Abschnitt Firewall- und Routendetails auf den Tab Routen, um alle Routen aufzulisten, die für die Netzwerkschnittstelle gelten. Diese sind nach Routennamen sortiert.

Console

1. Rufen Sie in der Google Cloud Console die Seite „Routen“ auf.

   Zur Seite „Routes“

2. Klicken Sie auf den Tab Routenverwaltung.

3. Klicken Sie auf Route erstellen.

4. Geben Sie einen Namen und eine Beschreibung für die Route an.

5. Wählen Sie in der Liste Netzwerk ein vorhandenes Netzwerk für die Route aus.

6. Wählen Sie in der Liste Routentyp die Option Statische Route aus.

7. Wählen Sie in der Liste IP-Version die erforderliche IP-Version aus:

   • Wählen Sie zum Erstellen einer statischen IPv4-Route IPv4 aus.
   • Wählen Sie zum Erstellen einer statischen IPv6-Route IPv6 aus.

8. Geben Sie einen Ziel-IP-Bereich an. Das breitestmögliche Ziel ist 0.0.0.0/0 für IPv4 oder ::/0 für IPv6.

9. Geben Sie eine Priorität für die Route an. Die Priorität kann zwischen 0 (der höchsten Priorität) und 65535 (niedrigste Priorität) liegen.

10. Damit die Route nur auf ausgewählte Instanzen mit übereinstimmenden Netzwerktags angewendet werden kann, geben Sie diese Tags im Feld Instanztags an. Lassen Sie das Feld leer, damit die Route für alle Instanzen im Netzwerk gilt.

11. Wählen Sie einen nächsten Hop für die Route aus:

    • Standard-Internetgateway: Stellt Pakete an das Internet sowie an Google APIs und Google-Dienste bereit.
    • Instanz angeben: Stellt Pakete an die Netzwerkschnittstelle einer VM-Instanz bereit. Geben Sie die VM-Instanz nach Name und Zone an. Wenn das Routenziel eine IPv6-Adresse ist, muss die VM-Instanz Dual-Stack oder Nur-IPv6 sein.
    • IP-Adresse einer Instanz angeben: Geben Sie eine IP-Adresse einer vorhandenen Instanz im VPC-Netzwerk an. Für statische IPv6-Routen muss die Instanz Dual-Stack oder nur IPv6 sein. Wichtige Einschränkungen für gültige IP-Adressen für den nächsten Hop finden Sie unter Nächste Hops für statische Routen.
    • VPN-Tunnel angeben: Pakete werden mit statischem Routing an einen vorhandenen klassischen VPN-Tunnel gesendet.
    • Weiterleitungsregel eines internen Passthrough-Network Load Balancers angeben: Stellt Pakete an einen internen Passthrough-Network Load Balancer bereit, der durch seinen internen Namen und die Region der Weiterleitungsregel angegeben wird. Die Weiterleitungsregel kann eine IPv4- oder IPv6-Adresse haben. Die IP-Version der von Ihnen angegebenen Weiterleitungsregel muss mit der IP-Version der statischen Route übereinstimmen, die Sie erstellen.

12. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie folgenden gcloud CLI-Befehl, um eine neue benutzerdefinierte statische Route zu erstellen:

gcloud compute routes create ROUTE_NAME \
    --network=NETWORK \
    --destination-range=DESTINATION_RANGE \
    --priority=PRIORITY \
    NEXT_HOP_SPECIFICATION

Ersetzen Sie Folgendes:

• ROUTE_NAME: der Name der Route
• NETWORK: der Name des VPC-Netzwerks, das die Route enthält
• DESTINATION_RANGE: die IPv4- oder IPv6-Zieladressen, auf die diese Route angewendet wird Das breitestmögliche Ziel ist 0.0.0.0/0 für IPv4 oder ::/0 für IPv6.
• PRIORITY: die Priorität der Route, die von 0 (die höchste Priorität) bis 65535 (die niedrigste Priorität) lauten kann

• NEXT_HOP_SPECIFICATION: der nächste Hop für die statische Route. Verwenden Sie einen der folgenden Parameter oder eine Kombination aus Parametern:

  • --next-hop-gateway=default-internet-gateway: Pakete an das Internet sowie an Google APIs und Google-Dienste senden.
  • --next-hop-instance=INSTANCE_NAME und --next-hop-instance-zone=ZONE: Pakete an die Netzwerkschnittstelle einer vorhandenen VM-Instanz senden. Geben Sie die VM-Instanz nach Name und Zone an. Wenn das Routenziel eine IPv6-Adresse ist, muss die VM-Instanz Dual-Stack oder Nur-IPv6 sein.
  • --next-hop-address=ADDRESS: Geben Sie eine IP-Adresse einer vorhandenen Instanz im VPC-Netzwerk an. Für statische IPv6-Routen muss die Instanz Dual-Stack oder nur IPv6 sein. Wichtige Einschränkungen für gültige IP-Adressen für den nächsten Hop finden Sie unter Next-Hops und Funktionen.
  • --next-hop-vpn-tunnel=VPN_TUNNEL_NAME und --next-hop-vpn-tunnel-region=REGION Pakete an einen vorhandenen Klassischen VPN-Tunnel unter Verwendung von statischem Routing senden.
  • --next-hop-ilb=FORWARDING_RULE und --next-hop-ilb-region=REGION: Pakete an einen internen Passthrough-Network Load Balancer senden. Geben Sie die Weiterleitungsregel anhand ihres Namens (oder ihrer IPv4- oder IPv6-Adresse) und ihrer Region an. Die IP-Version der von Ihnen angegebenen Weiterleitungsregel muss mit der IP-Version der statischen Route übereinstimmen, die Sie erstellen. Weitere Informationen zum Konfigurieren statischer Routen für interne Passthrough-Network Load Balancer finden Sie unter Statische Routen erstellen.

  Wenn die benutzerdefinierte statische Route nur für VMs gelten soll, die nach Netzwerk-Tag ausgewählt werden, fügen Sie das Flag --tags hinzu und geben Sie ein oder mehrere Netzwerk-Tags an. Weitere Informationen zum Zusammenspiel von Netzwerktags und benutzerdefinierten statischen Routen finden Sie unter Anwendbare Routen in der Routenübersicht. Sie können Tags bei jeder benutzerdefinierten statischen Route verwenden.

Weitere Informationen zur Syntax der gCloud CLI finden Sie in der SDK-Dokumentation.

API

Erstellen Sie eine neue benutzerdefinierte statische Route.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/routes
{
  "name": "ROUTE_NAME",
  "network": "NETWORK_NAME",
  "destRange": "DESTINATION_RANGE",
  "priority": PRIORITY,
  "NEXT_HOP_SPECIFICATION"
}

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des Projekts, in dem Ihre Route erstellt wird.
• ROUTE_NAME: der Name der Route
• NETWORK: der Name des VPC-Netzwerks, das die Route enthält.
• DESTINATION_RANGE: der IPv4- oder IPv6-Zieladressbereich, für den diese Route gilt. Das breitestmögliche Ziel ist 0.0.0.0/0 für IPv4 oder ::/0 für IPv6.
• PRIORITY: die Priorität der Route, die von 0 (die höchste Priorität) bis 65535 (die niedrigste Priorität) lauten kann
• NEXT_HOP_SPECIFICATION: der nächste Hop für die statische Route. Einen der folgenden Parameter oder eine Kombination aus Parametern verwenden:
  • nextHopGateway: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/gateways/default-internet-gateway: sendet Pakete an das Internet sowie an Google APIs und Google-Dienste
  • nextHopInstance: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME: sendet Pakete an die Netzwerkschnittstelle einer VM-Instanz. Geben Sie die VM-Instanz nach Name und Zone an. Wenn das Routenziel eine IPv6-Adresse ist, muss die VM-Instanz Dual-Stack oder Nur-IPv6 sein.
  • nextHopIp: ADDRESS: Geben Sie eine IP-Adresse einer vorhandenen Instanz im VPC-Netzwerk an. Für statische IPv6-Routen muss die Instanz Dual-Stack oder nur IPv6 sein. Wichtige Einschränkungen für gültige IP-Adressen für den nächsten Hop finden Sie unter Nächste Hops und Funktionen.
  • nextHopVpnTunnel: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/vpnTunnels/VPN_TUNNEL_NAME: sendet Pakete an einen vorhandenen Klassischen VPN-Tunnel mit statischem Routing.
  • nextHopIlb: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE: sendet Pakete an einen internen Passthrough-Network Load Balancer. Geben Sie die Weiterleitungsregel anhand ihres Namens (oder ihrer IPv4- oder IPv6-Adresse) und ihrer Region an. Die IP-Version der von Ihnen angegebenen Weiterleitungsregel muss mit der IP-Version der statischen Route übereinstimmen, die Sie erstellen.

Wenn die benutzerdefinierte statische Route nur für VMs gelten soll, die nach Netzwerk-Tag ausgewählt werden, fügen Sie das Feld tags hinzu und geben Sie ein oder mehrere Netzwerk-Tags an. Weitere Informationen zum Zusammenspiel von Netzwerktags und benutzerdefinierten statischen Routen finden Sie unter Anwendbare Routen in der Routenübersicht. Sie können Tags bei jeder benutzerdefinierten statischen Route verwenden.

Weitere Informationen finden Sie in der Methode routes.insert.

Terraform

Sie können eine statische Route mit einem Terraform-Modul erstellen.

Mit dieser statischen Route wird eine Standardroute zum Internet erstellt.

module "google_compute_route" {
  source       = "../../modules/routes" #adding local path
  project_id   = var.project_id         # Replace this with your project ID in quotes
  network_name = "default"

  routes = [
    {
      name              = "egress-internet"
      description       = "route through IGW to access internet"
      destination_range = "0.0.0.0/0"
      tags              = ["egress-inet"]
      next_hop_internet = true
    }
  ]
}

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

Go

import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "cloud.google.com/go/compute/apiv1/computepb"
	"google.golang.org/protobuf/proto"
)

// createRoute creates a route with given name inside given project.
func createRoute(w io.Writer, projectID, name string) error {
	// projectID := "your_project_id"
	// name := "testname"

	ctx := context.Background()
	client, err := compute.NewRoutesRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewRoutesRESTClient: %w", err)
	}
	defer client.Close()

	route := &computepb.Route{
		Name:           proto.String(name),
		Network:        proto.String("global/networks/default"),
		DestRange:      proto.String("0.0.0.0/0"),
		NextHopGateway: proto.String("global/gateways/default-internet-gateway"),
	}

	req := &computepb.InsertRouteRequest{
		Project:       projectID,
		RouteResource: route,
	}
	op, err := client.Insert(ctx, req)

	if err != nil {
		return fmt.Errorf("unable to insert a route: %w", err)
	}

	if err := op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	fmt.Fprintf(w, "Route created\n")

	return nil
}

Java

import com.google.cloud.compute.v1.InsertRouteRequest;
import com.google.cloud.compute.v1.Operation;
import com.google.cloud.compute.v1.Route;
import