REST Resource: projects.locations.serviceLbPolicies

Recurso: ServiceLbPolicy

ServiceLbPolicy contiene el balanceo de cargas global y la configuración de distribución de tráfico que se puede aplicar a un BackendService.

Representación JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "loadBalancingAlgorithm": enum (LoadBalancingAlgorithm),
  "autoCapacityDrain": {
    object (AutoCapacityDrain)
  },
  "failoverConfig": {
    object (FailoverConfig)
  }
}
Campos
name

string

Obligatorio. Nombre del recurso ServiceLbPolicy. Coincide con el patrón projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}.

createTime

string (Timestamp format)

Solo salida. La marca de tiempo de la creación del recurso.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo salida. La marca de tiempo de la última actualización de este recurso.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

Opcional. Conjunto de etiquetas de etiqueta asociadas con el recurso ServiceLbPolicy.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

description

string

Opcional. Es una descripción de texto libre del recurso. La longitud máxima es de 1,024 caracteres.

loadBalancingAlgorithm

enum (LoadBalancingAlgorithm)

Opcional. El tipo de algoritmo de balanceo de cargas que se usará. El comportamiento predeterminado es WATERFALL_BY_REGION.

autoCapacityDrain

object (AutoCapacityDrain)

Opcional. Configuración para alejar automáticamente el tráfico de IG/NEG en mal estado para el servicio de backend asociado.

failoverConfig

object (FailoverConfig)

Opcional. Configuración relacionada con la conmutación por error basada en el estado.

LoadBalancingAlgorithm

El algoritmo de balanceo de cargas global que se usará.

Enums
LOAD_BALANCING_ALGORITHM_UNSPECIFIED No se especifica el tipo de algoritmo de balanceo de cargas.
SPRAY_TO_WORLD Equilibra el tráfico entre todos los backends del mundo de forma proporcional según la capacidad.
SPRAY_TO_REGION Dirigir el tráfico a la región más cercana con extremos y capacidad antes de extenderse a otras regiones y distribuir el tráfico de cada cliente a todos los MIG/NEG de una región.
WATERFALL_BY_REGION Dirigir el tráfico a la región más cercana con extremos y capacidad antes de extenderse a otras regiones. Todos los MIG/NEG dentro de una región se cargan de forma uniforme, pero es posible que cada cliente no distribuya el tráfico a todos los MIG/NEG de la región.
WATERFALL_BY_ZONE Intenta mantener el tráfico en una sola zona más cercana al cliente antes de extenderse a otras zonas.

AutoCapacityDrain

Opción para especificar si se debe considerar un IG/NEG en mal estado para el balanceo de cargas global y el enrutamiento de tráfico.

Representación JSON
{
  "enable": boolean
}
Campos
enable

boolean

Opcional. Si la estableces como verdadera, un IG/NEG en mal estado se establecerá como vaciado. - Un IG/NEG se considera en mal estado si menos del 25% de las instancias o extremos en el IG/NEG están en buen estado. - Esta opción nunca tendrá como resultado el desvío de más del 50% de los IG/NEG configurados para el servicio de backend.

FailoverConfig

Opción para especificar el comportamiento de conmutación por error basado en el estado. Esto no está relacionado con FailoverPolicy del balanceador de cargas de red.

Representación JSON
{
  "failoverHealthThreshold": integer
}
Campos
failoverHealthThreshold

integer

Opcional. El umbral de porcentaje en el que un balanceador de cargas comenzará a enviar tráfico a los backends de conmutación por error. Si el porcentaje de extremos en un MIG/NEG es menor que este valor, el tráfico se enviará a los backends de conmutación por error, si es posible. Este campo se debe establecer en un valor entre 1 y 99. El valor predeterminado es 50 para el balanceador de cargas HTTP(S) externo global (clásico) y la malla de servicios sin proxy, y 70 para otros.

Métodos

create

Crea una ServiceLbPolicy nueva en un proyecto y una ubicación determinados.

delete

Borra una sola ServiceLbPolicy.

get

Obtiene detalles de una sola ServiceLbPolicy.

list

Enumera las ServiceLbPolicies en un proyecto y una ubicación determinados.

patch

Actualiza los parámetros de una sola ServiceLbPolicy.