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. Sie stimmt mit dem Muster projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name} überein.

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 Typ des zu verwendenden Load-Balancing-Algorithmus. Das Standardverhalten ist WATERFALL_BY_REGION.

autoCapacityDrain

object (AutoCapacityDrain)

Optional. Konfiguration, um Traffic bei einer fehlerhaften IG/NEG für den zugehörigen Back-End-Dienst automatisch zu einem anderen Ziel zu leiten.

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 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 an die nächstgelegene Region mit Endpunkten und Kapazität weiter, bevor er in andere Regionen überläuft. 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 Versuchen Sie, den Traffic in einer einzelnen Zone zu halten, die dem Client am nächsten ist, bevor er in andere Zonen fließt.

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 unter diesem Wert liegt, wird der Traffic nach Möglichkeit an Failover-Backends 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.