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

Kennung. Name der ServiceLbPolicy-Ressource. Sie stimmt mit dem Muster projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name} überein.
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. Eine Reihe von Label-Tags, die der ServiceLbPolicy-Ressource zugeordnet 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 Load-Balancing-Algorithmus, der verwendet werden soll. 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 zustandsbasierte Failover.

LoadBalancingAlgorithm

Der globale Load-Balancing-Algorithmus, der verwendet werden soll.

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 nächstgelegene Region mit Endpunkten und Kapazität weiter, bevor er in 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 sind gleichmäßig ausgelastet, aber jeder Client verteilt den Traffic möglicherweise nicht auf alle MIGs/NEGs in der Region.
WATERFALL_BY_ZONE Der Traffic sollte möglichst in einer einzelnen Zone in der Nähe des Clients verbleiben, bevor er auf andere Zonen verteilt wird.

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 eine fehlerhafte IG/NEG als „entleert“ 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. Dieses Feld sollte auf einen 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 angegebenen Projekt und an einem angegebenen Ort.

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.