REST Resource: projects.locations.serviceLbPolicies

Ressource : ServiceLbPolicy

ServiceLbPolicy contient la configuration globale de l'équilibrage de charge et de la distribution du trafic qui peut ê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

Identifiant. 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.

Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

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

Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

labels

map (key: string, value: string)

Facultatif. Ensemble de tags de libellé 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 de backend associé.

failoverConfig

object (FailoverConfig)

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

LoadBalancingAlgorithm

Algorithme d'équilibrage de charge global à utiliser.

Énumérations
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 de manière proportionnelle en fonction de la 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 répartir vers d'autres régions. Répartissez le trafic de chaque client sur 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é avant de le déborder vers d'autres régions. Tous les groupes d'instances gérés/groupes d'endpoints réseau d'une région sont chargés de manière égale, mais chaque client peut ne pas répartir le trafic sur tous les groupes d'instances gérés/groupes d'endpoints réseau de la région.
WATERFALL_BY_ZONE Tentez de conserver le trafic dans une seule zone, la plus proche du client, avant de le répartir dans d'autres zones.

AutoCapacityDrain

Option permettant d'indiquer si un groupe d'instances/un NEG non opérationnel doit être pris en compte pour l'équilibrage de charge et le routage du trafic au niveau mondial.

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

boolean

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

FailoverConfig

Option permettant de spécifier le comportement de basculement basé sur l'état. Cela n'est pas lié à la FailoverPolicy 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 secours si possible. La valeur de ce champ doit être comprise entre 1 et 99. La valeur par défaut est de 50 pour l'équilibreur de charge HTTP(S) externe global (classique) et le maillage de services sans proxy, et de 70 pour les autres.

Méthodes

create

Crée une ressource 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 ressource ServiceLbPolicy.

getIamPolicy

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

list

Répertorie les ressources ServiceLbPolicies d'un projet et d'un emplacement donnés.

patch

Mettre à jour les paramètres d'un seul objet 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.