Zielpools verwenden

Das externe TCP/UDP-Netzwerk-Load-Balancing kann entweder einen Back-End-Dienst oder einen Zielpool verwenden, um die Gruppe der Back-End-Instanzen zu definieren, die eingehenden Traffic empfangen. Auf dieser Seite werden Konfigurationsoptionen für Zielpool-Back-Ends für Netzwerk-Load-Balancing beschrieben. Informationen zur Funktionsweise des Netzwerk-Load-Balancings mit regionalen Back-End-Diensten finden Sie unter Netzwerk-Load-Balancer mit Back-End-Diensten – Überblick.

Wenn die Weiterleitungsregel eines Netzwerk-Load-Balancers Traffic an einen Zielpool weiterleitet, wählt der Load-Balancer eine Instanz aus dem Zielpool anhand von einem Hash der Quell-IP-Adresse, dem Quellport, der Ziel-IP-Adresse und dem Zielport aus.

Wenn ein Zielpool eine einzelne virtuelle Maschine (VM) enthalten soll, sollten Sie die Protokollweiterleitung anstelle des Load-Balancings verwenden.

Zielpooleigenschaften

Zielpools arbeiten mit Weiterleitungsregeln, die TCP- und UDP-Traffic verarbeiten können. Sie müssen einen Zielpool erstellen, bevor Sie eine Weiterleitungsregel dafür anwenden können.

Zielpools verwenden Legacy-HTTP-Systemdiagnosen.

Ein Zielpool besteht aus den folgenden Eigenschaften:

name
[Erforderlich] Der Name des Zielpools. Der Name muss in diesem Projekt einmalig sein, 1 bis 63 Zeichen umfassen und mit dem regulären Ausdruck [a-z]([-a-z0-9]*[a-z0-9])? übereinstimmen. Daher muss das erste Zeichen kleingeschrieben sein und alle weiteren Zeichen müssen aus Bindestrichen, Kleinbuchstaben und Ziffern bestehen. Das letzte Zeichen darf kein Bindestrich sein.
description
[Optional] Eine benutzerdefinierte Beschreibung dieses Zielpools.
region

[Erforderlich] Die vollqualifizierte URL zu der Region, wo dieser Zielpool existieren soll. Dies sollte die gleiche Region sein, in der sich Ihre gewünschten Instanzen befinden werden. Beispiel:

"region" : "https://www.googleapis.com/compute/v1/projects/<var>PROJECT_ID</var>/regions/<var>REGION</var>"
healthChecks[ ]

[Optional] Eine optionale Liste von Systemdiagnosen für diesen Zielpool. Es kann nur eine Systemdiagnose mit einem bestimmten Zielpool verbunden werden. Weitere Informationen hierzu finden Sie unter Systemdiagnose.

instances[ ]

[Erforderlich] Eine Liste von Instanz-URLs, die den Traffic für diesen Zielpool bearbeiten sollten. Alle Instanzen müssen sich in der gleichen Region wie der Zielpool befinden, aber Instanzen können zu verschiedenen Zonen innerhalb einer einzelnen Region gehören. Beispiel:

"instances" : [
  "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE",
  "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE-2"
]
sessionAffinity

[Optional] Steuert die Methode, die angewandt wird, um eine Back-End-VM-Instanz auszuwählen. Sie können diesen Wert nur bei der Erstellung des Zielpools festlegen. Wenn Sie diesen Wert einmal eingestellt haben, können Sie ihn nicht mehr ändern. Die Hash-Verfahren wählt einen Back-End basierend auf einer Teilmenge der folgenden 5 Werte:

  • Quell-/Ziel-IP
  • Quell-/Ziel-Port
  • Layer-4-Protokoll (TCP, UDP)

Mögliche Hashes sind:

NONE (d. h., es wurde kein Hash festgelegt) (Standard)
Ein 5-Tupel-Hashing, das die Quell- und Ziel-IP-Adressen, die Quell- und Ziel-Ports sowie ein Protokoll verwendet. Jede neue Verbindung kann auf einer beliebigen Instanz enden, aber der gesamte Traffic einer bestimmten Verbindung bleibt auf derselben Instanz, sofern die Instanz fehlerfrei bleibt.
CLIENT_IP_PROTO
Ein 3-Tupel-Hashing, das die Quell- und Ziel-IP-Adressen und das Protokoll verwendet. Alle Verbindungen von einem Client werden auf der gleichen Instanz enden, solange sie dasselbe Protokoll verwenden und die Instanz fehlerfrei bleibt.
CLIENT_IP
Ein 2-Tupel-Hashing, das die Quell- und Ziel-IP-Adressen verwendet. Alle Verbindungen von einem Client werden unabhängig vom Protokoll auf der gleichen Instanz enden, solange die Instanz fehlerfrei bleibt.

Ein 5-Tupel-Hashing bietet eine gute Verteilung des Traffics über viele virtuelle Maschinen hinweg. Eine zweite Sitzung vom selben Client kann jedoch auf einer anderen Instanz ankommen, weil sich der Quellport ändern kann. Wenn Sie möchten, dass alle Sitzungen vom gleichen Client das gleiche Back-End erreichen, solange das Back-End fehlerfrei bleibt, legen Sie die Optionen CLIENT_IP_PROTO oder CLIENT_IP fest.

Allgemein gilt: Wenn Sie eine 3-Tupel- oder 2-Tupel-Methode wählen, erhalten Sie eine bessere Sitzungsaffinität als mit der Standard-5-Tupel-Methode, aber der gesamten Traffic wird eventuell nicht gleichmäßig verteilt.

Fragmentierte UDP-Pakete: Wenn Sie das Load-Balancing für einen UDP-Traffic ausführen, der wahrscheinlich fragmentiert ist, setzen Sie die Sitzungsaffinität auf CLIENT_IP_PROTO oder CLIENT_IP fest. Verwenden Sie nicht NONE (5-Tupel-Hashing). Dies ist erforderlich, weil die anderen UDP-Fragmente, mit Ausnahme des ersten Fragments, keine Portnummer beinhalten und Load-Balancing die Fragmente ohne Port weglassen könnte. Weitere Informationen hierzu finden Sie unter Load-Balancing und fragmentierte UDP-Pakete.

backupPool

[Optional] Eine vollqualifizierte URL zu einer anderen Zielpoolressource. Ein Sicherungspool ist ein Zielpool, auf den ein anderer Zielpool verweist. Sie müssen auch failoverRatio angeben, um dieses Feature nutzen zu können. Wenn das Verhältnis von fehlerfreien virtuellen Maschinen in Ihrem Zielpool unter failoverRatio fällt, sendet der Netzwerk-Load-Balancer Traffic an Ihren Sicherungspool. Allerdings können Sie pro Zielpool nur einen Sicherungspool haben. Der Sicherungspool muss sich in der gleichen Region wie der Zielpool befinden. Wenn das Verhältnis von fehlerfreien Instanzen in Ihrem Zielpool unter den konfigurierten Wert der Failover-Quote fällt, wendet der Netzwerk-Load-Balancer die folgenden Regeln zur Trafficweiterleitung an:

  1. Wenn das Verhältnis der fehlerfreien Instanzen zur Gesamtzahl der Instanzen im Zielpool kleiner als die Failover-Quote ist, wird Traffic an fehlerfreie Instanzen im Sicherungspool gesendet.
  2. Wenn das Verhältnis von fehlerfreien Instanzen zur Gesamtzahl der Instanzen im Zielpool kleiner als die Failover-Quote ist, aber keine verbleibenden fehlerfreien Instanzen im Sicherungspool vorhanden sind, wird der Traffic zu den verbleibenden fehlerfreien Instanzen im Zielpool gesendet.
  3. Wenn der Zielpool nicht leer ist und alle Instanzen sowohl im Ziel- als auch im Sicherungspool die Systemdiagnosen nicht bestehen, wird der Traffic als letztes Mittel an alle Instanzen im Zielpool gesendet.
  4. Wenn der Zielpool leer ist und alle Instanzen im Sicherungspool die Systemdiagnosen nicht bestehen, wird der Traffic als letztes Mittel an alle Instanzen im Sicherungspool gesendet.

Es wird nur eine Failover-Ebene unterstützt. Wenn der Zielpool A beispielsweise über den Sicherungspool B und der Sicherungspool B über den Sicherungspool C verfügt, kann der für den Zielpool A bestimmte Traffic nur in den Sicherungspool B und nicht in den Sicherungspool C geleitet werden.

failoverRatio

[Optional] Ein Gleitkommawert zwischen 0.0 und 1.0, der bestimmt, wann dieser Zielpool für fehlerhaft erklärt wird. Wenn dieser Wert zum Beispiel auf .1 festgelegt wird, wird dieser Zielpool als fehlerhaft erklärt, wenn die Anzahl der fehlerfreien Instanzen unter .1 (10 %) liegt. Wenn das Failover-Verhältnis 0.0 beträgt, muss zumindest ein Back-End fehlerfrei sein, damit der Pool als fehlerfrei erachtet wird. Wenn das Failover-Verhältnis auf 1.0 festgelegt ist, müssen alle Instanzen fehlerfrei sein, damit der Pool als fehlerfrei eingestuft wird. Sie müssen diesen Wert festlegen, wenn Sie das Feld backupPool definieren.

Failover-Bedingungen

Bedingungen Neue Verbindungen gehen an
Failover-Quote !=0, fehlerfreie VMs im Zielpool >= FR Zielpool
Failover-Quote =0, fehlerfreie VMs im Zielpool > 0 Zielpool
Failover-Quote !=0, fehlerfreie VMs im Zielpool < FR; mindestens eine VM im Sicherungspool ist fehlerfrei Sicherungspool
Failover-Quote =0, fehlerfreie VMs im Zielpool = 0; mindestens eine VM im Sicherungspool ist fehlerfrei Sicherungspool
Mindestens eine VM befindet sich im Zielpool, alle VMs im Zielpool sind fehlerhaft und alle VMs im Sicherungspool sind fehlerhaft Zielpool (letztes Mittel)
Im Zielpool befinden sich keine VMs und alle VMs im Sicherungspool sind fehlerhaft Sicherungspool (letztes Mittel)
Im Zielpool befinden sich keine VMs; im Sicherungspool befinden sich ebenfalls keine VMs Traffic wird unterbrochen

Zielpool erstellen

Console

Verwenden Sie das Menü „Erweitert“ für das Load-Balancing, um einen Zielpool über die Cloud Console zu erstellen.

  1. Wechseln Sie auf der Load-Balancing-Seite Erweitert zum Tab Zielpools.
    Zu Zielpools
  2. Klicken Sie auf Zielpool erstellen.
  3. Geben Sie einen Namen ein.
  4. Wählen Sie eine Region aus.
  5. Klicken Sie unter Systemdiagnose auf Neue Systemdiagnose erstellen oder Weitere Systemdiagnose erstellen. Mit diesen Schritten wird eine Legacy-HTTP-Systemdiagnose erstellt, die für Zielpools erforderlich ist.
    1. Geben Sie unter Name den Wert basic-check für die Systemdiagnose ein.
    2. Übernehmen Sie die Standardeinstellungen.
    3. Klicken Sie auf Speichern und fortfahren.
  6. Je nachdem, welche Ressourcen in der ausgewählten Region verfügbar sind, klicken Sie entweder auf Vorhandene Instanzen auswählen oder auf Vorhandene Instanzgruppen auswählen.
    1. Wählen Sie unter VM-Instanzen oder Instanzgruppen die Ressourcen für den Zielpool aus.
  7. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie den Befehl target-pools create, um mit gcloud compute einen Zielpool zu erstellen:

  gcloud compute target-pools create TARGET_POOL \
      [--backup-pool=BACKUP_POOL] \
      [--description=DESCRIPTION] \
      [--failover-ratio=FAILOVER_RATIO] \
      [--http-health-check=HEALTH_CHECK] \
      [--session-affinity=SESSION_AFFINITY; default="NONE"]

Dabei gilt:

  • TARGET_POOL: ein Name für den Zielpool
  • BACKUP_POOL: ein Name für den Sicherungszielpool
  • DESCRIPTION: eine optionale Beschreibung
  • FAILOVER_RATIO: ein Wert zwischen 0,0 und 1,0, der bestimmt, wann der Zielpool für fehlerhaft erklärt wird.
  • HEALTH_CHECK: eine Systemdiagnose für diesen Zielpool
  • SESSION_AFFINITY: die Methode, mit der eine Back-End-VM-Instanz ausgewählt wird

API

Senden Sie zum Erstellen eines Zielpools in der API eine HTTP POST-Anfrage an den folgenden URI:

  https://www.googleapis.com/v1/compute/projects/PROJECT_ID/regions/REGION/targetPools
  {
    "name": name,
    "instances": [
       "https://www.googleapis.com/v1/compute/project/PROJECT_ID/zones/ZONE/instances/INSTANCE",
       "https://www.googleapis.com/v1/compute/project/PROJECT_ID/zones/ZONE/instances/INSTANCE-2",
    ]
  }
 

Dabei gilt:

  • PROJECT_ID: die Google Cloud-Projekt-ID
  • ZONE: die Zone, in der sich die Instanzen des Zielpools befinden
  • INSTANCE, INSTANCE-2: die Instanzen, die dem Zielpool hinzugefügt werden sollen

Instanz zum Zielpool hinzufügen oder entfernen

Console

Wenn Sie der Cloud Console Instanzen hinzufügen oder daraus entfernen möchten, verwenden Sie das erweiterte Menü des Load-Balancing.

  1. Wechseln Sie auf der Load-Balancing-Seite Erweitert zum Tab Zielpools.
    Zu Zielpools
  2. Klicken Sie auf den Namen des Zielpools, den Sie ändern möchten.
  3. Klicken Sie auf Bearbeiten.
  4. Wenn Sie dem Zielpool weitere Ressourcen hinzufügen möchten, verwenden Sie die Liste Instanz hinzufügen oder Instanzgruppe hinzufügen.
  5. Wenn Sie eine Instanz oder Instanzgruppe entfernen möchten, klicken Sie auf das X neben dem Namen.
  6. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl target-pools add-instances, um mit gcloud compute Instanzen zu einem Zielpool hinzuzufügen:

  gcloud compute target-pools add-instances TARGET_POOL \
      --instances=INSTANCE,[INSTANCE-2,...]

Dabei gilt:

  • TARGET_POOL: der Name des Zielpools
  • INSTANCE, INSTANCE-2: der Name der Instanz (oder Instanzen), die dem Zielpool hinzugefügt werden soll

Verwenden Sie zum Entfernen von Instanzen den Befehl target-pools remove-instances:

  gcloud compute target-pools remove-instances TARGET_POOL \
      --instances=INSTANCE,[INSTANCE-2,...]

Dabei gilt:

  • TARGET_POOL: der Name des Zielpools
  • INSTANCE, INSTANCE-2: der Name der Instanz (oder Instanzen), die aus dem Zielpool entfernt werden soll

API

Senden Sie in der API eine POST-Anfrage an die folgenden URIs:

  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/removeInstance
  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/addInstance

Der Text Ihrer Anfrage sollte die vollqualifizierten URIs zu den Instanzen enthalten, die Sie hinzufügen oder entfernen möchten:

  {
   "instances": [
      {"instance": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE"},
      {"instance": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE-2"}
    ]
  }
 

Dabei gilt:

  • PROJECT_ID: die Google Cloud-Projekt-ID
  • TARGET_POOL: der Name des zu aktualisierenden Zielpools
  • REGION: die Region, in der sich der Zielpool befindet
  • ZONE: die Zone, in der sich die aktualisierten Instanzen befinden
  • INSTANCE, INSTANCE-2: die Instanzen, die dem Zielpool hinzugefügt werden sollen

Weitere Informationen finden Sie in der API-Referenzdokumentation für die Methoden targetPools.addInstance und targetPools.removeInstance.

Zielpools auflisten

Console

Eine Liste der Zielpools finden Sie im erweiterten Menü des Load-Balancing.

Wechseln Sie auf der Load-Balancing-Seite Erweitert zum Tab Zielpools.
Zu Zielpools

Auf der Seite wird eine Liste von Zielpools angezeigt.

gcloud

Verwenden Sie den Befehl target-pools list, um vorhandene Zielpools mithilfe von gcloud compute aufzulisten:

  gcloud compute target-pools list

Für eine ausführlichere Ausgabe verwenden Sie den Befehl describe und legen einen Poolnamen fest:

API

Senden Sie in der API eine GET-Anfrage an den folgenden URI:

  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools

Dabei gilt:

  • PROJECT_ID: die Google Cloud-Projekt-ID
  • REGION: die Region, in der sich der Zielpool befindet

Zielpool beschreiben

Console

Verwenden Sie das erweiterte Menü des Load-Balancing, um Informationen zu einem Zielpool abzurufen.

  1. Wechseln Sie auf der Load-Balancing-Seite Erweitert zum Tab Zielpools.
    Zu Zielpools
  2. Detaillierte Informationen erhalten Sie, wenn Sie auf den Namen des Zielpools klicken.

gcloud

Verwenden Sie den Befehl target-pools describe, um mit gcloud compute Informationen zu einem einzelnen Zielpool abzurufen:

  gcloud compute target-pools describe TARGET_POOL

Dabei gilt:

  • TARGET_POOL: der Name des Zielpools

    Wenn Sie die Cloud Shell-Sitzung beenden, verlieren Sie diese Umgebungsvariablen.

API

Senden Sie aus der API eine leere GET-Anfrage an folgenden URI:

  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL

Dabei gilt:

  • PROJECT_ID: die Google Cloud-Projekt-ID
  • TARGET_POOL: der Name des zu aktualisierenden Zielpools
  • REGION: die Region, in der sich der Zielpool befindet

Systemstatus von Instanzen abfragen

Console

Verwenden Sie das erweiterte Load-Balancing-Menü, um den Systemstatus von Instanzen in einem Zielpool zu ermitteln.

  1. Wechseln Sie auf der Load-Balancing-Seite Erweitert zum Tab Zielpools.
    Zu Zielpools
  2. Klicken Sie auf den Namen des Zielpools.
  3. Auf der Seite Details zum Zielpool werden alle Instanzen und deren Systemstatus aufgelistet.

gcloud

Um mit gcloud compute den aktuellen Integritätsstatus einer Instanz in Ihrem Zielpool oder aller Instanzen im Zielpool zu prüfen, können Sie den Befehl gcloud compute target-pools get-health verwenden:

  gcloud compute target-pools get-health TARGET_POOL

Dabei gilt:

  • TARGET_POOL: der Name des Zielpools

Der Befehl gibt den Systemstatus entsprechend der konfigurierten Systemdiagnose mit fehlerfrei oder fehlerhaft zurück.

API

Stellen Sie in der API eine HTTP POST-Anfrage an den folgenden URI, wobei die Instanz im Text der Anfrage festlegt ist:

  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/getHealth

  {
    "instance": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE"
  }

Dabei gilt:

  • PROJECT_ID: die Google Cloud-Projekt-ID
  • TARGET_POOL: der Name des zu aktualisierenden Zielpools
  • REGION: die Region, in der sich der Zielpool befindet
  • ZONE: die Zone, in der sich die Instanz befindet
  • INSTANCE: die Instanz, deren Systemdiagnosestatus Sie prüfen möchten

Zielpool löschen

Um einen Zielpool zu löschen, müssen Sie zuerst sicherstellen, dass keine Weiterleitungsregel auf diesen Zielpool verweist. Wenn eine Weiterleitungsregel derzeit auf einen Zielpool verweist, müssen Sie die Weiterleitungsregel löschen, um die Referenz zu entfernen.

Console

Zum Löschen eines Zielpools verwenden Sie das erweiterte Menü des Load-Balancing.

  1. Wechseln Sie auf der Load-Balancing-Seite Erweitert zum Tab Zielpools.
    Zu Zielpools
  2. Klicken Sie auf den Namen des Zielpools.
  3. Klicken Sie auf Löschen.
  4. Klicken Sie im Fenster Zielpool löschen auf Löschen.

gcloud

Verwenden Sie den Befehl target-pools delete, um mit gcloud compute einen Zielpool zu löschen:

  gcloud compute target-pools delete TARGET_POOL

Dabei gilt:

  • TARGET_POOL: der Name des zu löschenden Zielpools

API

Senden Sie aus der API eine leere DELETE-Anfrage an folgenden URI:

  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL

Dabei gilt:

  • PROJECT_ID: die Google Cloud-Projekt-ID
  • TARGET_POOL: der Name des zu aktualisierenden Zielpools
  • REGION: die Region, in der sich der Zielpool befindet

Systemdiagnose dem Zielpool hinzufügen oder daraus entfernen

Die Objekte der Systemdiagnose sind eigenständige, globale Ressourcen, die zu einem Zielpool gehören oder von ihm getrennt sein können.

Wenn einem Zielpool keine Systemdiagnose zugeordnet ist, behandelt der Netzwerk-Load-Balancer alle Instanzen als fehlerfrei und sendet Traffic an alle Instanzen im Zielpool. Wenn Sie jedoch den Systemstatus eines Zielpools ohne Systemdiagnose abfragen, wird der Status unhealthy zurückgegeben und signalisiert, dass der Zielpool keine Systemdiagnose hat. Wir empfehlen, dass Ihre Zielpools über dazugehörige Systemdiagnosen verfügen sollten, damit Sie Ihre Instanzen besser verwalten können.

Das Netzwerk-Load-Balancing verwendet Legacy-HTTP-Systemdiagnosen, um den Status der Instanzen im Zielpool zu ermitteln. Ein Netzwerk-Load-Balancer kann nur eine Legacy-HTTP-Systemdiagnose verwenden, keine Legacy-HTTPS-Systemdiagnose.

Console

Wenn Sie die Cloud Console verwenden, können Sie entweder beim Erstellen eines Zielpools oder beim Erstellen eines Netzwerk-Load-Balancers mit einem Zielpool-Back-End eine Legacy-HTTP-Systemdiagnose erstellen.

Über die Seite Systemdiagnosen der Cloud Console können Sie keine eigenständige Legacy-Systemdiagnose erstellen.

So entfernen Sie die einem Zielpool zugeordnete Systemdiagnose:

  1. Wechseln Sie auf der Load-Balancing-Seite Erweitert zum Tab Zielpools.
    Zu Zielpools
  2. Klicken Sie auf den Namen des Zielpools, den Sie ändern möchten.
  3. Klicken Sie auf Bearbeiten.
  4. Wählen Sie unter Systemdiagnose die Option Keine Systemdiagnose aus.
  5. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl target-pools add-health-checks, um mit gcloud compute eine Systemdiagnose zu einem Zielpool hinzuzufügen:

  gcloud compute target-pools add-health-checks TARGET_POOL \
      --http-health-check=HEALTH_CHECK

Dabei gilt:

  • TARGET_POOL: der Name des Zielpools
  • HEALTH_CHECK: die Legacy-HTTP-Systemdiagnose, die mit diesem Zielpool verwendet werden soll

Verwenden Sie zum Entfernen einer Systemdiagnose den Befehl target-pools remove-health-checks:

  gcloud compute target-pools remove-health-checks TARGET_POOL \
    --http-health-check=HEALTH_CHECK

Dabei gilt:

  • TARGET_POOL: der Name des Zielpools
  • HEALTH_CHECK: die Legacy-HTTP-Systemdiagnose, die aus diesem Zielpool entfernt werden soll

API

Senden Sie eine HTTP POST-Anfrage an die entsprechenden URIs, um eine Systemdiagnose mithilfe der API zu verknüpfen oder zu trennen:

  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/removeHealthCheck
  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/addHealthCheck

Der Text Ihrer Anfrage sollte die zu verknüpfende oder zu trennende Systemdiagnose enthalten:

  {
    "healthCheck": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/httpHealthChecks/HEALTH_CHECK"
  }

Dabei gilt:

  • PROJECT_ID: die Google Cloud-Projekt-ID
  • TARGET_POOL: der Name des zu aktualisierenden Zielpools
  • REGION: die Region, in der sich der Zielpool befindet
  • HEALTH_CHECK: die Legacy-HTTP-Systemdiagnose, die mit dem Zielpool verknüpft ist oder zu ihr gehört

Weitere Informationen finden Sie in der API-Referenzdokumentation zu targetPools.addHealthCheck und targetPools.removeHealthCheck.

Sicherungszielpool hinzufügen oder entfernen

Wenn Sie das erste Mal einen Zielpool einrichten, können Sie wählen, ob ein Sicherungszielpool für den Trafficempfang verwendet werden soll, wenn Ihr Zielpool fehlerhaft wird.

Wenn Sie bisher noch keinen Sicherungszielpool eingerichtet haben, sollten Sie auch Systemdiagnosen festlegen, damit das Feature ordnungsgemäß funktioniert.

Console

So fügen Sie einen Sicherungszielpool hinzu:

  1. Wechseln Sie auf der Load-Balancing-Seite Erweitert zum Tab Zielpools.
    Zu Zielpools
  2. Klicken Sie auf den Namen des Zielpools, den Sie ändern möchten.
  3. Klicken Sie auf Bearbeiten.
  4. Wählen Sie unter Sicherungspool einen Sicherungszielpool aus der Liste aus.
  5. Legen Sie eine Failover-Quote fest.
  6. Klicken Sie auf Speichern.

So entfernen Sie einen Sicherungszielpool:

  1. Wechseln Sie auf der Load-Balancing-Seite Erweitert zum Tab Zielpools.
    Zu Zielpools
  2. Klicken Sie auf den Namen des Zielpools, den Sie ändern möchten.
  3. Klicken Sie auf Bearbeiten.
  4. Wählen Sie unter Sicherungspool die Option Keinen aus.
  5. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl target-pools set-backup, um die Sicherungspoolressource mit gcloud compute zu aktualisieren:

  gcloud compute target-pools set-backup TARGET_POOL \
      --backup-pool=BACKUP_POOL \
      --failover-ratio=FAILOVER_RATIO

Dabei gilt:

  • TARGET_POOL: der Name des Zielpools
  • BACKUP_POOL: ein Name für den Sicherungszielpool
  • FAILOVER_RATIO: ein Wert zwischen 0,0 und 1,0, der bestimmt, wann der Zielpool für fehlerhaft erklärt wird.

API

Für eine Anfrage zum Aktualisieren oder Löschen eines Sicherungspools durch die API, senden Sie eine POST-Anfrage an den folgenden URI:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/setBackup?failoverRatio=FAILOVER_RATIO

  {
    "target": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/BACKUP_POOL"
  }

Dabei gilt:

  • PROJECT_ID: die Google Cloud-Projekt-ID
  • TARGET_POOL: der Name des zu aktualisierenden Zielpools
  • REGION: die Region, in der sich der Zielpool befindet
  • BACKUP_POOL: der Name des Sicherungspools, der dem Zielpool zugeordnet werden soll
  • FAILOVER_RATIO: die Failover-Quote

Wenn Sie ein leeres Ziel oder kein Failover-Verhältnis definieren, dann ist das Verhalten des Sicherungspools für diesen Zielpool deaktiviert.

Nächste Schritte