Skip to main content
PATCH
Escalar ou redimensionar um balanceador de carga
Requer a ação do IAM loadbalancer:UpdateLoadBalancer. Consulte permissões de balanceadores de carga para obter a lista completa, o que cada uma abrange e um exemplo de política.

Autorizações

Authorization
string
header
obrigatório

Um token bearer OAuth 2.0, enviado como Authorization: Bearer <token>. Esta é a forma recomendada de autenticação.

Obtenha o token trocando o par de chaves de acesso de uma conta de serviço em POST /v1/oauth/token com grant_type=client_credentials. Esse é o fluxo padrão de credenciais de cliente; bibliotecas compatíveis com OAuth podem obter e renovar o token para você.

Os tokens duram uma hora por padrão. O mesmo par de chaves de acesso também serve como credencial AWS SigV4 para o endpoint de objetos compatível com S3, que aceita somente esse método de autenticação.

Parâmetros de caminho

id
string
obrigatório
Exemplo:

"4e1f8c2a-9b3d-4f6e-8a1c-2d5e7f9a0b3c"

Corpo

application/json

Os nomes são fixos na criação porque formam o CRN usado pelas políticas do IAM. Enviar nome em uma atualização, incluindo um valor inalterado, vazio ou nulo, retorna um erro de validação.

desired_count
integer

Alvo estável dentro de min_count e max_count.

Intervalo obrigatório: 1 <= x <= 10
Exemplo:

2

min_count
integer

Capacidade mais baixa vinculada.

Intervalo obrigatório: 1 <= x <= 10
Exemplo:

1

max_count
integer

Capacidade superior limitada, incluindo aumento de lançamento.

Intervalo obrigatório: 1 <= x <= 10
Exemplo:

5

autoscaling
object

Rastreamento de destino compartilhado por pools de instâncias e balanceadores de carga. As atualizações substituem a política. Defina enabled=false para manter as configurações e usar o dimensionamento manual. Cada métrica recomenda uma contagem desejada; a maior recomendação vence. Observações ausentes, obsoletas ou incompletas impedem o dimensionamento, mas não bloqueiam o dimensionamento recomendado por outra métrica válida. As decisões obedecem aos recursos min_count/max_count, warmup, cooldown, estabilização, limites de passo e cotas. O estado sobrevive às reinicializações do controlador. As políticas ativas possuem desired_count; as alterações manuais são aceitas e a avaliação automática é retomada após o tempo de espera. A telemetria personalizada requer telemetria:ReadMetrics na mesma conta.

replica_count
integer
obsoleto

Alias obsoleto de desired_count; envie apenas um. Os limites são preservados. Com desired_count omitido, ele é fixado nos limites resultantes. O dimensionamento interno retira e drena membros antes da exclusão.

Intervalo obrigatório: 1 <= x <= 10
Exemplo:

3

flavor
string

Redimensione cada réplica para um tipo de computação diferente. Deve ser um loadbalancer-family flavor.

Uma instância em execução não pode mudar de tamanho no local, então a solicitação registra o novo tamanho e retorna; as réplicas já em execução são substituídas uma por vez em segundo plano. O balanceador de carga executa temporariamente uma réplica sobre desired_count, dentro de max_count enquanto isso: a réplica extra aparece no novo tipo de instância e começa a servir antes que qualquer réplica na antiga seja aposentada, para que o número de serviços nunca fique abaixo de desired_count — um redimensionamento não custa capacidade, em qualquer contagem de réplicas.

Espere que isso leve vários minutos e faça a consulta GET /v1/load-balancers/{id}/replicas para observar: uma réplica foi substituída quando seu instance_id mudou e o redimensionamento foi feito quando todos os flavors corresponderam a ela.

Um redimensionamento requer max_count acima de desired_count para aumento de espaço. Uma implementação aguarda se o espaço for removido enquanto estiver em andamento.

Rejeitado antecipadamente se a conta não tiver a cota de computação para a réplica de substituição, de modo que um redimensionamento não possa ser aplicado parcialmente e deixar o balanceador de carga curto.

Exemplo:

"e5f6a7b8-c9d0-4123-e4f5-a6b7c8d9e0f1"

tags
object
Exemplo:

Resposta

OK

load_balancer
object