REST Resource: projects.locations.serviceLbPolicies

Ressource: ServiceLbPolicy

ServiceLbPolicy enthält die globale Load-Balancing- und Trafficverteilungskonfiguration, 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

ID. Name der „ServiceLbPolicy“-Ressource. 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.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Optional. Die Reihe an 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 Textbeschreibung 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, um Traffic für die zugehörigen Backend-Dienste automatisch aus fehlerhaften IG/NEG zu verschieben.
failoverConfig

object (FailoverConfig)

Optional. Konfiguration für das statusbasierte 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 alle Backends weltweit proportional zur Kapazität verteilen.
SPRAY_TO_REGION Leiten Sie den Traffic an die Region mit Endpunkten und Kapazität weiter, die am nächsten liegt, bevor er auf andere Regionen überläuft, und verteilen Sie den Traffic von jedem Client auf alle MIGs/NEGs in einer Region.
WATERFALL_BY_REGION Leiten Sie den Traffic zuerst an die nächstgelegene Region mit Endpunkten und Kapazität weiter, bevor er in andere Regionen überläuft. Alle MIGs/NEGs in einer Region werden gleichmäßig ausgelastet, 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 einzelnen Zone zu halten, die dem Client am nächsten ist, bevor er auf andere Zonen überläuft.

AutoCapacityDrain

Option zum Angeben, ob eine fehlerhafte IG/NEG für globales Load-Balancing und Traffic-Routing berücksichtigt werden soll.

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

boolean

Optional. Wenn auf „True“ gesetzt, wird ein fehlerhaftes IG/NEG als „drained“ festgelegt. – Eine IG/NEG gilt als fehlerhaft, wenn weniger als 25% der Instanzen/Endpunkte in der IG/NEG fehlerfrei sind. – Bei dieser Option werden nie mehr als 50% der konfigurierten IGs/NEGs für den Backend-Dienst geleert.

FailoverConfig

Option zur Angabe des Failover-Verhaltens basierend auf dem Zustand. Dies hat nichts mit der FailoverPolicy für Netzwerk-Load-Balancer zu tun.

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

integer

Optional. Der Schwellenwert in Prozent, ab dem ein Load Balancer den Traffic an die Failover-Backends sendet. 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. Für dieses Feld sollte ein Wert zwischen 1 und 99 festgelegt werden. Der Standardwert ist 50 für globale externe HTTP(S)-Load-Balancer (klassisch) und Proxyless 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 bestimmten Projekt und an einem bestimmten Standort auf

patch

 Aktualisiert die Parameter einer einzelnen „ServiceLbPolicy“.

setIamPolicy

 Legt die Zugriffssteuerungsrichtlinie für die angegebene Ressource fest.

testIamPermissions

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