REST Resource: projects.locations.serviceLbPolicies

Recurso: ServiceLbPolicy

ServiceLbPolicy contiene la configuración global de balanceo de cargas y 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. Es el 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 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".

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. Es un conjunto de etiquetas 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 del recurso en formato de texto libre. La longitud máxima es de 1,024 caracteres.

loadBalancingAlgorithm

enum (LoadBalancingAlgorithm)

Opcional. Es 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 del IG/NEG en mal estado del servicio de backend asociado.

failoverConfig

object (FailoverConfig)

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

LoadBalancingAlgorithm

Es el algoritmo de balanceo de cargas global que se usará.

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

AutoCapacityDrain

Es una opción para especificar si se debe considerar un IG o 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 se establece en "True", un IG o NEG no en buen estado se establecerá como agotado. - Un IG o NEG se considera en mal estado si menos del 25% de las instancias o los extremos del IG o NEG están en buen estado. - Esta opción nunca agotará más del 50% de los IG o NEG configurados para el servicio de backend.

FailoverConfig

Es la opción para especificar el comportamiento de conmutación por error basado en el estado. Esto no se relaciona con FailoverPolicy del balanceador de cargas de red.

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

integer

Opcional. Es 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 una 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 debe establecerse 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 los demás.

Métodos

create

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

delete

Borra una sola ServiceLbPolicy.

get

Obtiene los detalles de una sola ServiceLbPolicy.

getIamPolicy

Permite obtener la política de control de acceso de un recurso.

list

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

patch

Actualiza los parámetros de una sola ServiceLbPolicy.

setIamPolicy

Permite configurar la política de control de acceso en el recurso especificado.

testIamPermissions

Permite mostrar los permisos que tiene un emisor para un recurso especificado.