---
title: Quotas
description: Limite a criação de recursos para novos clientes até que financiem a carteira — níveis de VM, contagem de VMs e cotas.
url: https://nexcmp.com/pt/docs/billing/quotas/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Quotas {#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 {#what-it-does}

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 {#requirements}

| 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](https://nexcmp.com/pt/docs/catalog/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 {#how-the-basis-is-calculated}

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 {#vm-and-kubernetes-resources}

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 {#configure}

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.

![Aba de cotas com o botão de ativação, os limites de VMs e a tabela de cotas de serviço baseadas em níveis](https://nexcmp.com/pt/docs/images/billing/quotas-01-policy.webp)

### Tabela de cotas de serviço {#service-quota-table}

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 {#per-customer-overrides}

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.

![Cartão de cota do cliente com o nível, o uso de recursos e a tabela de cota de serviço com uma substituição](https://nexcmp.com/pt/docs/images/billing/quotas-02-customer.webp)

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

## O que o cliente vê {#what-the-customer-sees}

**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.

![Página Quotas do portal com o nível atual, o uso de recursos e as cotas de serviço](https://nexcmp.com/pt/docs/images/billing/quotas-03-portal.webp)

## Verificar {#verify}

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 {#limits-notes}

- **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](https://nexcmp.com/pt/docs/billing/promotions/)).
- **Os limites de nível são em centavos**, não em dólares.

## Resolução de problemas {#troubleshooting}

| 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. |