Skip to main content
POST
Criar um balanceador de carga
Requer a ação do IAM loadbalancer:CreateLoadBalancer. 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.

Cabeçalhos

Idempotency-Key
string

Chave opcional gerada pelo cliente que torna uma criação segura para reprodução. A reintentar uma solicitação com a mesma chave retorna o resultado original literalmente em vez de criar um recurso duplicado. A reutilização de uma chave com um corpo de solicitação diferente é rejeitada (422); uma solicitação cuja chave ainda está sendo processada retorna 409. Os registros são honrados por 24 horas. Use um UUID ou token exclusivo semelhante.

Maximum string length: 255

Corpo

application/json

Relações aceitam um UUID, CRN ou nome imutável exato, classificado por sintaxe. Os grupos de VPC, sub-rede e segurança devem pertencer à conta do chamador nesta região. Os nomes de sub-rede são escopo pelo vpc. Flavor é uma referência de catálogo regional. Referências IP flutuantes aceitam somente UUID ou CRN. Todas as referências são resolvidas antes de gravar. Os endereços são fixos na criação; atualizações não podem substituí-los.

name
string
obrigatório

1..127 caracteres de [A-Za-z0-9._-] Os nomes de recursos não devem começar com o prefixo literal crn: ou ser UUIDs (formas canônicas, compactas, entre colchetes ou urn:uuid:, em qualquer caso).

Exemplo:

"web-lb"

type
enum<string>
obrigatório
Opções disponíveis:
application,
network
Exemplo:

"application"

vpc
string
obrigatório

VPC o LB vai viver. Deve corresponder à VPC da sub-rede.

Exemplo:

"c3d4e5f6-a7b8-4901-c2d3-e4f5a6b7c8d9"

subnet
string
obrigatório

Sub-rede às quais as instâncias de LB se conectam. O IP virtual é alocado a partir desta sub-rede.

Exemplo:

"d4e5f6a7-b8c9-4012-d3e4-f5a6b7c8d9e0"

flavor
string
obrigatório

Calcule o tipo de instância para cada instância de LB.

Exemplo:

"e5f6a7b8-c9d0-4123-e4f5-a6b7c8d9e0f1"

security_groups
string[]
obrigatório

Grupos de segurança anexados a cada NIC de réplica (forma ALB da AWS). Uma placa de rede VPC sem grupo de segurança nega todo o tráfego de dados, portanto, as portas de ouvinte devem ser abertas por um grupo de segurança listado aqui. Reaplicado a réplicas de substituição. O caminho do plano de controle do LB (configuração do agente + heartbeat através do ponto de extremidade de metadados) é sempre permitido e não precisa de nenhum.

Exemplo:
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
padrão:1
obsoleto

Alias de entrada obsoleto de desired_count; envie apenas um. O padrão desejado é 1. Os limites omitidos são padrão para o desejado.

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

2

floating_ip
string
obsoleto

Public IPv4 abreviatura. Não pode ser combinado com floating_ips. Não aloca IPv6 público.

Exemplo:

"f6a7b8c9-d0e1-4234-f5a6-b7c8d9e0f1a2"

floating_ips
string[]

IPs flutuantes livres existentes desta conta e região, no máximo um por família e visibilidade (privado/público, IPv4/IPv6). Os endereços privados devem pertencer à sub-rede selecionada. As famílias privadas ausentes são alocadas automaticamente para cada família ativada nessa sub-rede. Os endereços públicos são opcionais e exigem uma rota padrão de família correspondente para um gateway da Internet; gateways NAT e somente de saída não se qualificam. O IPv6 requer uma sub-rede habilitada para IPv6. Endereços de propriedade ou anexados ao pool não estão disponíveis. Na exclusão, os endereços fornecidos são separados e retidos; as alocações privadas automáticas são liberadas. Não pode ser combinado com floating_ip.

Maximum array length: 4
Exemplo:
tags
object
Exemplo:

Resposta

Criado

load_balancer
object