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 schéma 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 en texte 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 des IG/NEG non opérationnels pour le service 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 de l'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 répartissez le trafic de chaque client entre tous les MIG/NEG d'une région.
WATERFALL_BY_REGION Dirigez le trafic vers la région la plus proche disposant de points de terminaison et de capacités avant de le déborder 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 entre 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 la valeur est définie sur "True", un IG/NEG non opérationnel est défini comme drainé. - Un IG/NEG est considéré comme non opérationnel si moins de 25 % des instances/points de terminaison de l'IG/NEG 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 d'un MIG/NEG est inférieur à cette valeur, le trafic est envoyé aux backends de basculement, si possible. La valeur de ce champ doit être 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 objet ServiceLbPolicy dans un projet et un emplacement donnés.

delete

Supprime une seule stratégie ServiceLbPolicy.

get

Récupère les informations d'un seul 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.