REST Resource: projects.locations.serviceLbPolicies

Ressource: ServiceLbPolicy

„ServiceLbPolicy“ enthält die globale Konfiguration für Load Balancing und Traffic Distribution, die auf einen Backend-Dienst angewendet werden kann.

JSON-Darstellung 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "loadBalancingAlgorithm": enum (LoadBalancingAlgorithm),
  "autoCapacityDrain": {
    object (AutoCapacityDrain)
  },
  "failoverConfig": {
    object (FailoverConfig)
  }
}
Felder
name

string

Erforderlich. Name der ServiceLbPolicy-Ressource. Er entspricht dem Muster projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann die Ressource erstellt wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann diese Ressource zuletzt aktualisiert wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Optional. Label-Tags, die mit der Ressource „ServiceLbPolicy“ verknüpft sind.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
description

string

Optional. Eine Freitextbeschreibung der Ressource. Maximale Länge: 1.024 Zeichen.
loadBalancingAlgorithm

enum (LoadBalancingAlgorithm)

Optional. Der zu verwendende Load Balancing-Algorithmus. Das Standardverhalten ist WATERFALL_BY_REGION.
autoCapacityDrain

object (AutoCapacityDrain)

Optional. Konfiguration zum automatischen Umleiten von Traffic für fehlerhafte IG/NEGs für den zugeordneten Back-End-Dienst.
failoverConfig

object (FailoverConfig)

Optional. Konfiguration für den zustandsbasierten Failover.

LoadBalancingAlgorithm

Der zu verwendende globale Load Balancing-Algorithmus.

Enums
LOAD_BALANCING_ALGORITHM_UNSPECIFIED Der Typ des Load-Balancing-Algorithmus ist nicht angegeben.
SPRAY_TO_WORLD Traffic auf allen Back-Ends weltweit gleichmäßig auf Grundlage der Kapazität ausgleichen.
SPRAY_TO_REGION Leiten Sie den Traffic mit Endpunkten und Kapazität in die nächste Region weiter, bevor er in andere Regionen übertragen wird, und verteilen Sie den Traffic von jedem Client auf alle MIGs/NEGs in einer Region.
WATERFALL_BY_REGION Leiten Sie Traffic mit Endpunkten und Kapazität an die nächstgelegene Region weiter, bevor Sie ihn in andere Regionen übertragen. Alle MIGs/NEGs innerhalb einer Region werden gleichmäßig geladen, aber möglicherweise wird der Traffic nicht von jedem Client auf alle MIGs/NEGs in der Region verteilt.
WATERFALL_BY_ZONE Der Traffic wird in einer einzigen Zone gehalten, die dem Client am nächsten ist, bevor er auf andere Zonen überläuft.

AutoCapacityDrain

Option zum Angeben, ob ein fehlerhafter IG/NEG für das globale Load-Balancing und das Traffic-Routing in Betracht gezogen werden soll.

JSON-Darstellung 
{
  "enable": boolean
}
Felder
enable

boolean

Optional. Wenn die Richtlinie auf „True“ gesetzt ist, wird ein fehlerhafter IG/NEG als Draining festgelegt. – Ein IG/NEG gilt als fehlerhaft, wenn weniger als 25 % der Instanzen/Endpunkte im IG/NEG fehlerfrei sind. – Diese Option führt niemals dazu, dass mehr als 50% der konfigurierten IGs/NEGs für den Back-End-Dienst per Drain beendet werden.

FailoverConfig

Option zum Angeben des zustandsbasierten Failover-Verhaltens. Dies hat nichts mit der FailoverPolicy des Netzwerk-Load Balancers zu tun.

JSON-Darstellung 
{
  "failoverHealthThreshold": integer
}
Felder
failoverHealthThreshold

integer

Optional. Der prozentuale Grenzwert, ab dem ein Load-Balancer beginnt, Traffic an Failover-Back-Ends zu senden. Wenn der Prozentsatz der Endpunkte in einer MIG/NEG kleiner als dieser Wert ist, wird der Traffic nach Möglichkeit an Failover-Back-Ends gesendet. Dieses Feld sollte auf einen Wert zwischen 1 und 99 festgelegt werden. Der Standardwert ist 50 für den globalen externen HTTP(S)-Load-Balancer (klassisch) und das proxylose Service Mesh und 70 für andere.

Methoden

create

 Erstellt eine neue ServiceLbPolicy in einem bestimmten Projekt und an einem bestimmten Standort.

delete

 Löscht eine einzelne ServiceLbPolicy.

get

 Ruft Details zu einer einzelnen ServiceLbPolicy ab.

getIamPolicy

 Ruft die Zugriffssteuerungsrichtlinie für eine Ressource ab.

list

 Listet ServiceLbPolicies in einem angegebenen Projekt und an einem angegebenen Standort auf.

patch

 Aktualisiert die Parameter einer einzelnen ServiceLbPolicy.

setIamPolicy

 Legt die Zugriffskontrollrichtlinie für die angegebene Ressource fest.

testIamPermissions

 Gibt die Berechtigungen des Aufrufers für die angegebene Ressource zurück.