REST Resource: projects.locations.serviceLbPolicies

Ressource : ServiceLbPolicy

ServiceLbPolicy contient une configuration globale d'équilibrage de charge et de distribution du trafic pouvant être appliquée à un BackendService.

Représentation JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "loadBalancingAlgorithm": enum (LoadBalancingAlgorithm),
  "autoCapacityDrain": {
    object (AutoCapacityDrain)
  },
  "failoverConfig": {
    object (FailoverConfig)
  }
}
Champs
name

string

Obligatoire. Nom de la ressource ServiceLbPolicy. Il correspond au modèle projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}.

createTime

string (Timestamp format)

Uniquement en sortie. Horodatage de la création de cette ressource.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière mise à jour de cette ressource.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

Facultatif. Ensemble de tags d'étiquettes associés à la ressource ServiceLbPolicy.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

description

string

Facultatif. Description libre de la ressource. Longueur maximale : 1 024 caractères.

loadBalancingAlgorithm

enum (LoadBalancingAlgorithm)

Facultatif. Type d'algorithme d'équilibrage de charge à utiliser. Le comportement par défaut est WATERFALL_BY_REGION.

autoCapacityDrain

object (AutoCapacityDrain)

Facultatif. Configuration permettant d'éloigner automatiquement le trafic en cas d'IG/NEG non opérationnel pour le service de backend associé.

failoverConfig

object (FailoverConfig)

Facultatif. Configuration liée au basculement basé sur l'état.

LoadBalancingAlgorithm

Algorithme d'équilibrage de charge global à utiliser.

Enums
LOAD_BALANCING_ALGORITHM_UNSPECIFIED Le type d'algorithme d'équilibrage de charge n'est pas spécifié.
SPRAY_TO_WORLD Équilibrez le trafic sur tous les backends du monde entier proportionnellement à leur capacité.
SPRAY_TO_REGION Dirigez le trafic vers la région la plus proche disposant de points de terminaison et de capacité avant de le déverser vers d'autres régions et de répartir le trafic de chaque client sur tous les MIG/NEG d'une région.
WATERFALL_BY_REGION Rediriger le trafic vers la région la plus proche disposant de points de terminaison et de capacité avant de le déverser vers d'autres régions. Tous les MIG/NEG d'une région sont chargés de manière uniforme, mais il est possible que chaque client ne répartisse pas le trafic sur tous les MIG/NEG de la région.
WATERFALL_BY_ZONE Essayez de maintenir le trafic dans une seule zone la plus proche du client, avant de le répartir sur d'autres zones.

AutoCapacityDrain

Option permettant de spécifier si un IG/NEG non opérationnel doit être pris en compte pour l'équilibrage de charge global et le routage du trafic.

Représentation JSON
{
  "enable": boolean
}
Champs
enable

boolean

Facultatif. Si cette valeur est définie sur "True", un IG/NEG non sain sera défini comme épuisé. - Un IG/NEG est considéré comme non opérationnel si moins de 25% des instances/points de terminaison qu'il contient sont opérationnels. - Cette option n'entraînera jamais le drainage de plus de 50% des IG/NEG configurés pour le service de backend.

FailoverConfig

Option permettant de spécifier un comportement de basculement basé sur l'état. Cela n'a rien à voir avec la stratégie de basculement de l'équilibreur de charge réseau.

Représentation JSON
{
  "failoverHealthThreshold": integer
}
Champs
failoverHealthThreshold

integer

Facultatif. Seuil de pourcentage à partir duquel un équilibreur de charge commencera à envoyer du trafic aux backends de basculement. Si le pourcentage de points de terminaison dans un MIG/NEG est inférieur à cette valeur, le trafic est envoyé aux backends de basculement si possible. Ce champ doit être défini sur une valeur comprise entre 1 et 99. La valeur par défaut est 50 pour l'équilibreur de charge HTTP(S) externe global (classique) et le maillage de services sans proxy, et 70 pour les autres.

Méthodes

create

Crée un ServiceLbPolicy dans un projet et un emplacement donnés.

delete

Supprime une seule stratégie ServiceLbPolicy.

get

Récupère les détails d'une seule règle ServiceLbPolicy.

getIamPolicy

Récupère la stratégie de contrôle d'accès d'une ressource.

list

Répertorie les ServiceLbPolicies dans un projet et un emplacement donnés.

patch

Met à jour les paramètres d'une seule règle ServiceLbPolicy.

setIamPolicy

Définit la stratégie de contrôle d'accès de la ressource spécifiée.

testIamPermissions

Renvoie les autorisations qu'un appelant a sur la ressource spécifiée.