Quotas

Onde no admin: Services › Virtual Machines › Policy › Quota tab (/vm/policy?tab=quota). Por cliente: Customers › List › a customer › Overview (/customers/<id>), card Quota. Onde no portal: Client › Quotas (/client/quotas).

O que faz

As cotas protegem você contra abusos de novas contas: quanto mais dinheiro real um cliente tiver colocado na carteira, mais recursos ele poderá criar. Existem duas camadas:

• Recursos de VM e Kubernetes: total de vCPU, RAM e disco, e o número de VMs. Os tiers são seus planos fixos.
• Quotas de serviço: quantos IPs, clusters, VPCs, GB de armazenamento e assim por diante, em cinco tiers (de L0 a L4) impulsionados pelo dinheiro depositado.

As quotas são verificadas antes de qualquer cobrança. Uma solicitação acima do limite é recusada com HTTP 403 quota_exceeded e uma mensagem informando ao cliente quanto recarregar.

Requisitos

Item	Requisito
Função	Um administrador.
Alternar	Enable quota (quota_enabled) fica desativado por padrão. Nada abaixo se aplica até que você o ative.
Planos fixos	Pelo menos um plano não personalizado (consulte Plans) — os tiers de recursos são seus planos fixos. Sem nenhum plano, apenas a regra de contagem de VMs se aplica.
Dependências	As linhas de quota de serviço existem apenas para os produtos ativados em sua instalação (VPN, proxy IPv6, Kubernetes, Private Cloud, Images, Object Storage, Dedicated).

Como a base é calculada

O NexCMP não olha apenas para pagamentos com cartão. A base é o saldo da carteira lançado do cliente: recargas de gateway, créditos de administrador (Credit / debit) e vales de carteira resgatados contam uma vez, através do razão da carteira. Descontos de pedidos e créditos de serviço de códigos promocionais não são dinheiro de carteira e não contam. A maior base que um cliente já alcançou é mantida (por site) — gastos ou reembolsos nunca reduzem um tier já desbloqueado.

Recursos de VM e Kubernetes

1. Os tiers são os planos fixos do site, ordenados pelo custo de executá-los por 24 horas.
2. Um cliente está no tier mais alto cujo custo em 24 horas não excede sua base. O limite é a vCPU, RAM e o disco desse plano. Um cliente que não pode pagar nem pelo plano mais barato ainda recebe os recursos do plano mais barato.
3. O uso contabilizado no limite é toda VM ativa (incluindo as bloqueadas), volumes de dados adquiridos (mesmo quando desconectados) e workers e planos de controle do Kubernetes (os workers também contam como VMs).
4. Contagem de VMs: até Max VMs at 24h tier (padrão 2). A partir da próxima VM, o saldo atual da carteira do cliente deve cobrir 30 dias (720 horas) de todas as suas VMs existentes mais a nova, até Max VMs when meeting 30-day threshold (padrão 10).
5. Criar uma VM também exige um saldo de pelo menos N horas dessa VM (Create VM: balance ≥ N horas, padrão 2) e o saldo mínimo da plataforma.
6. Reduzir o tamanho de uma VM nunca é bloqueado. Apenas a dimensão que aumenta é verificada, portanto, um cliente que está acima do limite de disco ainda pode adicionar vCPU se o limite de vCPU permitir.

Configurar

1. Abra Services › Virtual Machines › Policy e selecione a aba Quota.

2. Ative Enable quota.

3. Revise os três números (todos editáveis):

   Campo	Padrão	Intervalo
   Create VM: balance ≥ N horas	2	1 a 720
   Max VMs at 24h tier	2	1 a 100
   Máx. de VMs ao atingir o limite de 30 dias	10	1 a 1000 (não abaixo do campo anterior)

4. Em Tier-based service quotas, edite a tabela (abaixo).

5. Clique em Save. O NexCMP solicitará um motivo, que é gravado no log de auditoria junto com os valores antigo e novo. A alteração se aplica a todos os clientes.

Tabela de cotas de serviço

A tabela possui cinco níveis. As células de cabeçalho L0 a L4 contêm o limite de depósito em centavos: os padrões 0, 1000, 5000, 20000, 100000 significam L0 para uma nova conta, L1 a partir de $10, L2 a partir de $50, L3 a partir de $200 e L4 a partir de $1,000. O primeiro limite deve permanecer 0. Cada linha define a cota de uma chave por nível; -1 significa ilimitado.

Chave	Significado	L0	L1	L2	L3	L4
vpn.ips	IPs de VPN	2	10	30	100	500
proxy6.ips	IPs de proxy IPv6	500	2000	10000	50000	-1
dedicated.servers	Servidores dedicados	1	2	5	20	50
s3.storage_gb	Object Storage GB allocated	2048	4096	10240	51200	-1
k8s.clusters	Clusters Kubernetes	1	2	5	10	30
k8s.workers	Nós de trabalho do Kubernetes	3	9	18	50	200
vpc.count	Redes de Cloud Privada	1	2	5	10	30
images.gb	Armazenamento de imagens personalizadas (GB)	50	100	200	500	2000

A tabela também lista algumas linhas para produtos que não fazem parte desta versão; deixe-as inalteradas. Uma chave cujo produto está desativado fica oculta e nunca é aplicada. Um valor deve ser -1 ou estar entre 0 e 10,000,000.

As cotas de serviço seguem a base de fundos, assim como os níveis de VM: o maior saldo de carteira alcançado, não o total de pagamentos com cartão. Clientes de revendedores usam os mesmos padrões e o revendedor só pode visualizá-los.

Substituições por cliente

1. Abra Customers › List, depois o cliente. Em Overview localize o card Quota.

2. Recursos da VM: clique em Quota override e escolha uma das opções

   • Por saldo de recarga (remover substituição) — comportamento padrão;
   • Ilimitado (incluindo contagem de VMs) — remove todos os limites para este cliente;
   • um nível de plano — fixa o teto de recursos nesse plano; a regra de contagem de VMs ainda se aplica.

   Insira um motivo. Os administradores da plataforma podem definir qualquer nível; uma substituição definida por um revendedor não pode exceder a base retida do cliente.

3. Serviços: a tabela em Service quotas mostra cada chave com In use, o limite efetivo e sua Source (nível ou substituição). Clique em Edit em uma linha, digite o New quota (-1 = ilimitado, vazio = retorna ao padrão do nível) e um motivo.

Cada substituição é registrada no log de auditoria com o administrador, o motivo e os valores antes/depois.

O que o cliente vê

Client › Quotas (/client/quotas) mostra o nível atual do cliente, a quantidade usada e total de vCPUs, RAM, disco e contagem de VMs (dividida entre VMs e Kubernetes), o saldo de carteira elegível, a base de recursos retida (que não diminui quando eles gastam) e quanto falta recarregar para o próximo nível. Um controle deslizante permite que eles escolham um nível de destino e vão direto para a tela de depósito. O cartão Service Quotas lista cada serviço com a cota, a quantidade usada, o nível deles (de L0 a L4), quanto mais depositar para o próximo nível e um botão Request increase que abre um rascunho de ticket de suporte. Um botão Quota policy explica as regras.

Verificar

1. Ative Enable quota e use um novo cliente de teste com saldo de $0.
2. Tente criar uma VM maior do que o seu plano mais barato. A solicitação é recusada com quota_exceeded e a mensagem "Exceeds the resources of tier ... Top up $X more to unlock tier ...".
3. Recarregue o valor exibido. O nível muda imediatamente e a mesma solicitação é concluída com sucesso.
4. Compre IPs de VPN acima do limite de L0: HTTP 403 quota_exceeded com "scope":"service" e um link para /client/quotas.
5. No cartão de cota do cliente, Source mostra tier; defina uma substituição e veja-a mudar para override.

Limites e notas

• Desligado significa desligado. Com quota_enabled desativado, a regra antiga new_account_max_vms (Services › Virtual Machines › Policy › Sales) limita novas contas a 2 VMs até que seus depósitos atinjam $10. Quando a cota está ativada, essa regra deixa de se aplicar.
• VMs criadas por administradores não são bloqueadas.
• Erros falham fechados. Se o estado da cota não puder ser lido, a solicitação será recusada com quota_unavailable em vez de permitida.
• Solicitações de API, CLI e MCP usam os mesmos manipuladores, portanto, aplicam-se os mesmos limites.
• O crédito de promoção não eleva um nível (consulte Promotions).
• Os limites de nível são em centavos, não em dólares.

Resolução de problemas

Sintoma	Causa	Correção
quota_exceeded, motivo resources	O novo total de vCPU/RAM/disco está acima do nível	Adicione saldo no valor da mensagem ou defina uma substituição.
quota_exceeded, motivo vm_30d	Mais do que a contagem de VMs do nível de 24h e a carteira ainda não cobre 30 dias da frota	Adicione saldo no valor exibido.
quota_exceeded, motivo vm_max	O limite absoluto de VMs foi atingido	Aumente Max VMs when meeting 30-day threshold ou use uma substituição.
quota_exceeded, scope: service	Um limite por serviço foi atingido	Aumente o valor da tabela ou substitua essa chave para o cliente.
quota_unavailable	Não foi possível verificar o estado da cota	Tente novamente; verifique o log do servidor se o problema persistir.
"quota_max_vms_30d must be >= quota_max_vms_24h" ao salvar	Valores invertidos	Faça com que o número de 30 dias seja pelo menos o número de 24 horas.
O cliente relata que o nível caiu	Ele não cai; compare Held resource basis com o custo do plano	Verifique a lista de preços do plano: um aumento no preço do plano pode mover os limites.