REST Resource: projects.locations.serviceLbPolicies

Ressource: ServiceLbPolicy

ServiceLbPolicy enthält eine globale Load-Balancing-Konfiguration und eine Konfiguration für die Trafficverteilung, die auf einen BackendService 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. Sie entspricht dem Muster projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}.

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel für den Zeitpunkt, zu dem diese 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 für den Zeitpunkt, zu dem 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. Satz von Label-Tags, die mit der ServiceLbPolicy-Ressource 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 Typ des zu verwendenden Load-Balancing-Algorithmus. Das Standardverhalten ist WATERFALL_BY_REGION.

autoCapacityDrain

object (AutoCapacityDrain)

Optional. Konfiguration zum automatischen Weiterleiten von Traffic für fehlerhafte IG/NEG für den verknüpften Backend-Dienst.

failoverConfig

object (FailoverConfig)

Optional. Konfiguration im Zusammenhang mit zustandsbasiertem 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 proportional nach Kapazität ausgleichen.
SPRAY_TO_REGION Leiten Sie den Traffic an die nächstgelegene Region mit Endpunkten und Kapazität 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 den Traffic an die nächstgelegene Region mit Endpunkten und Kapazität weiter, bevor er auf andere Regionen übertragen wird. Alle MIGs/NEGs innerhalb einer Region werden gleichmäßig geladen, aber jeder Client verteilt den Traffic möglicherweise nicht auf alle MIGs/NEGs in der Region.
WATERFALL_BY_ZONE Versuchen Sie, den Traffic in einer Zone zu halten, die dem Client am nächsten liegt, bevor Sie ihn auf andere Zonen übertragen.

AutoCapacityDrain

Option zur Angabe, ob eine fehlerhafte IG/NEG für globales Load-Balancing und Traffic-Routing in Betracht gezogen werden soll.

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

boolean

Optional. Wenn diese 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 nie dazu, dass mehr als 50% der konfigurierten IGs/NEGs für den Back-End-Dienst per Drain beendet werden.

FailoverConfig

Option zur Angabe des zustandsbasierten Failover-Verhaltens. Dies hängt nicht mit der FailoverPolicy des Netzwerk-Load-Balancers zusammen.

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

integer

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

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.

list

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

patch

Aktualisiert die Parameter einer einzelnen ServiceLbPolicy.