REST Resource: projects.locations.serviceLbPolicies

Recurso: ServiceLbPolicy

ServiceLbPolicy contiene la configuración del balanceo de carga global y la distribución del 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 de salida. Marca de tiempo de creación de este recurso.

Marca de tiempo en formato RFC3339 UTC "Zulu", 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 de salida. Marca de tiempo de la última actualización de este recurso.

Marca de tiempo en formato RFC3339 UTC "Zulu", 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 asociadas al recurso ServiceLbPolicy.

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

description

string

Opcional. Descripción de texto libre del recurso. La longitud máxima es de 1024 caracteres.

loadBalancingAlgorithm

enum (LoadBalancingAlgorithm)

Opcional. El tipo de algoritmo de balanceo de carga que se va a usar. El comportamiento predeterminado es WATERFALL_BY_REGION.

autoCapacityDrain

object (AutoCapacityDrain)

Opcional. Configuración para desviar automáticamente el tráfico de los IG o NEG que no estén en buen 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 carga global que se va a usar.

Enumeraciones
LOAD_BALANCING_ALGORITHM_UNSPECIFIED No se ha especificado el tipo de algoritmo de balanceo de carga.
SPRAY_TO_WORLD Balancea el tráfico entre todos los backends del mundo de forma proporcional en función de la capacidad.
SPRAY_TO_REGION Dirige el tráfico a la región más cercana con endpoints y capacidad antes de derivarlo a otras regiones y distribuye el tráfico de cada cliente a todos los MIGs o NEGs de una región.
WATERFALL_BY_REGION Dirige el tráfico a la región más cercana con endpoints y capacidad antes de derivarlo a otras regiones. Todas las MIGs o NEGs de una región tienen una carga equilibrada, pero es posible que cada cliente no distribuya el tráfico a todas las MIGs o NEGs de la región.
WATERFALL_BY_ZONE Intenta mantener el tráfico en una sola zona, la más cercana al cliente, antes de que se extienda a otras zonas.

AutoCapacityDrain

Opción para especificar si se debe tener en cuenta un IG o NEG en mal estado para el balanceo de carga global y el enrutamiento del tráfico.

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

boolean

Opcional. Si se le asigna el valor "True", se considerará que un IG o NEG no está en buen estado. - Un IG o NEG se considera en mal estado si menos del 25% de las instancias o los endpoints del IG o NEG están en buen estado. - Esta opción nunca provocará que se agote más del 50% de los grupos de instancias o los 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 de los balanceadores de carga de red.

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

integer

Opcional. Umbral de porcentaje a partir del cual un balanceador de carga empezará a enviar tráfico a los back-ends de conmutación por error. Si el porcentaje de endpoints de un MIG o NEG es inferior a este valor, el tráfico se enviará a los backends de failover, si es posible. Este campo debe tener un valor entre 1 y 99. El valor predeterminado es 50 para el balanceador de carga HTTP(S) externo global (clásico) y la malla de servicios sin proxy, y 70 para el resto.

Métodos

create

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

delete

Elimina un único ServiceLbPolicy.

get

Obtiene los detalles de un solo ServiceLbPolicy.

getIamPolicy

Obtiene la política de control de acceso de un recurso.

list

Muestra las ServiceLbPolicies de un proyecto y una ubicación determinados.

patch

Actualiza los parámetros de un solo ServiceLbPolicy.

setIamPolicy

Aplica la política de control de acceso del recurso especificado.

testIamPermissions

Devuelve los permisos que tiene una sobre el recurso especificado.