REST Resource: projects.locations.serviceLbPolicies

Recurso: ServiceLbPolicy

ServiceLbPolicy contém a configuração de equilíbrio 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)
  },
  "isolationConfig": {
    object (IsolationConfig)
  }
}
Campos
name

string

Identificador. Nome do recurso ServiceLbPolicy. Corresponde ao padrão projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}.
createTime

string (Timestamp format)

Apenas saída. A data/hora em que este recurso foi criado.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. A data/hora em que este recurso foi atualizado pela última vez.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Opcional. Conjunto de etiquetas associadas ao recurso ServiceLbPolicy.

Um objeto que contém uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
description

string

Opcional. Uma descrição de texto livre do recurso. Comprimento máximo de 1024 carateres.
loadBalancingAlgorithm

enum (LoadBalancingAlgorithm)

Opcional. O tipo de algoritmo de balanceamento de carga a usar. O comportamento predefinido é WATERFALL_BY_REGION.
autoCapacityDrain

object (AutoCapacityDrain)

Opcional. Configuração para afastar automaticamente o tráfego de IG/NEG não íntegros para o serviço de back-end associado.
failoverConfig

object (FailoverConfig)

Opcional. Configuração relacionada com a comutação por falha baseada no estado de saúde.
isolationConfig

object (IsolationConfig)

Opcional. Configuração para fornecer apoio técnico de isolamento para o serviço de back-end associado.

LoadBalancingAlgorithm

O algoritmo de balanceamento de carga global a usar.

Enumerações
LOAD_BALANCING_ALGORITHM_UNSPECIFIED O tipo de algoritmo de equilíbrio de carga não foi especificado.
SPRAY_TO_WORLD Equilibre o tráfego em todos os back-ends em todo o mundo proporcionalmente com base na capacidade.
SPRAY_TO_REGION Direcionar o tráfego para a região mais próxima com pontos finais e capacidade antes de transbordar para outras regiões e distribuir o tráfego de cada cliente para todos os MIGs/NEGs numa região.
WATERFALL_BY_REGION Direcionar o tráfego para a região mais próxima com pontos finais e capacidade antes de transbordar para outras regiões. Todos os MIGs/NEGs numa região são carregados uniformemente, mas cada cliente pode não distribuir o tráfego por todos os MIGs/NEGs na região.
WATERFALL_BY_ZONE Tentar manter o tráfego numa única zona mais próxima do cliente antes de se expandir para outras zonas.

AutoCapacityDrain

Opção para especificar se um IG/NEG não saudável deve ser considerado para o equilíbrio de carga global e o encaminhamento de tráfego.

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

boolean

Opcional. Se estiver definida como "True", um IG/NEG não saudável é definido como esgotado. – Um IG/NEG é considerado não saudável se menos de 25% das instâncias/pontos finais no IG/NEG estiverem saudáveis. – Esta opção nunca resulta no esgotamento de mais de 50% dos GIs/GNs configurados para o serviço de back-end.

FailoverConfig

Opção para especificar o comportamento de comutação por falha com base no estado. Isto não está relacionado com a FailoverPolicy do balanceador de carga de rede.

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

integer

Opcional. A percentagem limite a partir da qual um balanceador de carga começa a enviar tráfego para back-ends de alternativa. Se a percentagem de pontos finais num MIG/NEG for inferior a este valor, o tráfego é enviado para back-ends de alternativa, se possível. Este campo deve ser definido com um valor entre 1 e 99. O valor predefinido é 50 para o balanceador de carga HTTP(S) externo global (clássico) e a malha de serviços sem proxy, e 70 para outros.

IsolationConfig

Configuração para fornecer apoio técnico de isolamento para o serviço de back-end associado.

Representação JSON 
{
  "isolationGranularity": enum (IsolationGranularity)
}
Campos
isolationGranularity

enum (IsolationGranularity)

Opcional. O nível de detalhe do isolamento do balanceador de carga.

IsolationGranularity

A granularidade desta restrição de isolamento.

Enumerações
ISOLATION_GRANULARITY_UNSPECIFIED Não está configurado nenhum isolamento para o serviço de back-end. O tráfego pode transbordar com base no algoritmo de balanceamento de carga.
REGION O tráfego deste serviço vai ser isolado na região da nuvem mais próxima.

Métodos

create

 Cria uma nova ServiceLbPolicy num determinado projeto e localização.

delete

 Elimina uma única ServiceLbPolicy.

get

 Obtém detalhes de uma única ServiceLbPolicy.

getIamPolicy

 Obtém a política de controlo de acesso para um recurso.

list

 Apresenta ServiceLbPolicies num determinado projeto e localização.

patch

 Atualiza os parâmetros de uma única ServiceLbPolicy.

setIamPolicy

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

testIamPermissions

 Devolve as autorizações que um autor da chamada tem no recurso especificado.