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. Marca de tiempo cuando se creó 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. 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 del recurso en formato de texto libre. Longitud máxima: 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 que quita automáticamente el tráfico para 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

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

Enums
LOAD_BALANCING_ALGORITHM_UNSPECIFIED El tipo de algoritmo de balanceo de cargas no se especifica.
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

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 “True”, se desviará un IG/NEG en mal estado. - 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

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. El umbral de porcentaje con 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, de ser 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 los demás.

Métodos

create

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

delete

Borra una sola ServiceLbPolicy.

get

Obtiene los detalles de un solo 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 un solo 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.