REST Resource: projects.locations.serviceLbPolicies

Recurso: ServiceLbPolicy

A ServiceLbPolicy contém a configuração de balanceamento de carga global e distribuição de tráfego que pode ser aplicada a um BackendService.

Representação JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "loadBalancingAlgorithm": enum (LoadBalancingAlgorithm),
  "autoCapacityDrain": {
    object (AutoCapacityDrain)
  },
  "failoverConfig": {
    object (FailoverConfig)
  }
}
Campos
name

string

Obrigatório. Nome do recurso ServiceLbPolicy. Ele corresponde ao padrão projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}.

createTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o recurso foi criado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora da última atualização do recurso.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

Opcional. Conjunto de tags de rótulo associadas ao recurso ServiceLbPolicy.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

description

string

Opcional. Uma descrição em texto livre do recurso. Comprimento máximo de 1.024 caracteres.

loadBalancingAlgorithm

enum (LoadBalancingAlgorithm)

Opcional. O tipo de algoritmo de balanceamento de carga a ser usado. O comportamento padrão é WATERFALL_BY_REGION.

autoCapacityDrain

object (AutoCapacityDrain)

Opcional. Configuração para desviar automaticamente o tráfego de IGs/NEGs não íntegros do serviço de back-end associado.

failoverConfig

object (FailoverConfig)

Opcional. Configuração relacionada ao failover com base na integridade.

LoadBalancingAlgorithm

O algoritmo de balanceamento de carga global a ser usado.

Enums
LOAD_BALANCING_ALGORITHM_UNSPECIFIED O tipo do algoritmo de balanceamento de carga não foi especificado.
SPRAY_TO_WORLD Equilibrar o tráfego entre todos os back-ends do mundo proporcionalmente com base na capacidade.
SPRAY_TO_REGION Direcione o tráfego para a região mais próxima com endpoints e capacidade antes de transbordar para outras regiões e espalhar o tráfego de cada cliente para todos os MIGs/NEGs em uma região.
WATERFALL_BY_REGION Direcione o tráfego para a região mais próxima com endpoints e capacidade antes de transbordar para outras regiões. Todos os MIGs/NEGs em uma região são carregados de maneira uniforme, mas cada cliente pode não distribuir o tráfego para todos os MIGs/NEGs na região.
WATERFALL_BY_ZONE Tente manter o tráfego em uma única zona mais próxima ao cliente antes de transbordar para outras zonas.

AutoCapacityDrain

Opção para especificar se um IG/NEG não íntegro precisa ser considerado para o balanceamento de carga global e o roteamento de tráfego.

Representação JSON
{
  "enable": boolean
}
Campos
enable

boolean

Opcional. Se definido como "True", um IG/NEG inativo será definido como drenado. - Um IG/NEG é considerado não íntegro se menos de 25% das instâncias/endpoints no IG/NEG estiverem íntegros. - Essa opção nunca vai resultar em esgotar mais de 50% dos IGs/NEGs configurados para o serviço de back-end.

FailoverConfig

Opção para especificar o comportamento de failover com base na integridade. Isso não está relacionado à FailoverPolicy do balanceador de carga de rede.

Representação JSON
{
  "failoverHealthThreshold": integer
}
Campos
failoverHealthThreshold

integer

Opcional. O limite percentual em que um balanceador de carga começa a enviar tráfego para back-ends de failover. Se a porcentagem de endpoints em um MIG/NEG for menor que esse valor, o tráfego será enviado para back-ends de failover, se possível. Esse campo precisa ser definido como um valor entre 1 e 99. O valor padrão é 50 para o balanceador de carga HTTP(S) externo global (clássico) e a malha de serviços sem proxy e 70 para os outros.

Métodos

create

Cria uma nova ServiceLbPolicy em um determinado projeto e local.

delete

Exclui uma única ServiceLbPolicy.

get

Recebe detalhes de uma única ServiceLbPolicy.

getIamPolicy

Busca a política de controle de acesso de um recurso.

list

Lista as políticas de balanceamento de carga de serviço em um determinado projeto e local.

patch

Atualiza os parâmetros de uma única ServiceLbPolicy.

setIamPolicy

Define a política de controle de acesso no recurso especificado.

testIamPermissions

Retorna permissões do autor da chamada no recurso especificado.