---
title: Quote
description: Limita ciò che un nuovo cliente può creare prima di ricaricare il wallet: tier risorse VM, conteggio VM e quote per servizio, con override per cliente.
url: https://nexcmp.com/it/docs/billing/quotas/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Quote {#quotas}

> **Dove nell'admin:** Services › Virtual Machines › Policy › Quota tab (`/vm/policy?tab=quota`). Per cliente: Customers › List › a customer › Overview (`/customers/<id>`), card **Quota**. **Dove nel portale:** Client › Quotas (`/client/quotas`).

## Descrizione {#what-it-does}

Le quote proteggono dagli abusi da parte dei nuovi account: maggiore è il denaro reale inserito da un cliente nel portafoglio, maggiori saranno le risorse che potrà creare. Esistono due livelli:

- **Risorse per VM e Kubernetes**: vCPU, RAM e disco totali, e numero di VM. I livelli corrispondono ai tuoi piani fissi.
- **Quote di servizio**: quanti IP, cluster, VPC, GB di storage e così via, suddivisi in cinque livelli (da L0 a L4) in base ai fondi depositati.

Le quote vengono verificate **prima** di qualsiasi addebito. Una richiesta che supera il limite viene rifiutata con un errore HTTP 403 `quota_exceeded` e un messaggio che indica al cliente quanto ricaricare.

## Requisiti {#requirements}

| Elemento | Requisito |
|---|---|
| Ruolo | Un amministratore. |
| Interruttore | **Enable quota** (`quota_enabled`) è **disattivato** per impostazione predefinita. Nulla di quanto segue si applica finché non lo attivi. |
| Piani fissi | Almeno un piano non personalizzato (vedi [Plans](https://nexcmp.com/it/docs/catalog/plans/)): i livelli di risorsa sono i tuoi piani fissi. Senza alcun piano si applica solo la regola del numero di VM. |
| Dipendenze | Le righe delle quote di servizio esistono solo per i prodotti abilitati nella tua installazione (VPN, proxy IPv6, Kubernetes, Private Cloud, Immagini, Object Storage, Dedicated). |

## Come viene calcolata la base {#how-the-basis-is-calculated}

NexCMP non considera solo i pagamenti con carta. La **base** è il **saldo del portafoglio contabilizzato** del cliente: le ricariche tramite gateway, i crediti amministrativi (**Credit / debit**) e i voucher per il portafoglio riscattati concorrono una sola volta, tramite il registro del portafoglio. Gli sconti sugli ordini e i crediti di servizio derivanti da codici promozionali non costituiscono denaro del portafoglio e non vengono conteggiati. La base più alta raggiunta da un cliente viene **conservata** (per sito): la spesa o i rimborsi non abbassano mai un livello già sbloccato.

### Risorse per VM e Kubernetes {#vm-and-kubernetes-resources}

1. I livelli sono i piani fissi del sito, ordinati in base al costo di esecuzione per 24 ore.
2. Un cliente si trova nel livello più alto il cui costo sulle 24 ore non supera la sua base. Il limite è costituito da vCPU, RAM e disco di quel piano. Un cliente che non può permettersi nemmeno il piano più economico riceve comunque le risorse del piano più economico.
3. L'utilizzo conteggiato ai fini del limite comprende ogni VM attiva (incluse quelle bloccate), i volumi di dati acquistati (anche se scollegati) e i nodi worker e di controllo di Kubernetes (i worker contano anche come VM).
4. **Numero di VM:** fino a **Max VMs at 24h tier** (predefinito 2). Dalla VM successiva in poi, il saldo *attuale* del portafoglio del cliente deve coprire **30 giorni (720 ore)** di tutte le VM esistenti più quella nuova, fino a **Max VMs when meeting 30-day threshold** (predefinito 10).
5. **La creazione di una VM** richiede inoltre un saldo di almeno **N ore** di quella VM (**Create VM: balance ≥ N hours**, predefinito 2) e il saldo minimo della piattaforma.
6. La riduzione delle dimensioni di una VM non viene mai bloccata. Viene controllata solo la dimensione in crescita, quindi un cliente che supera il limite del disco può comunque aggiungere vCPU se il limite di vCPU lo consente.

## Configurazione {#configure}

1. Apri **Services › Virtual Machines › Policy** e seleziona la scheda **Quota**.
2. Attiva l'interruttore **Enable quota**.
3. Verifica i tre valori numerici (tutti modificabili):

   | Campo | Predefinito | Intervallo |
   |---|---|---|
   | Crea VM: saldo ≥ N ore | 2 | Da 1 a 720 |
   | Max VMs at 24h tier | 2 | Da 1 a 100 |
   | VM massime al raggiungimento della soglia di 30 giorni | 10 | Da 1 a 1000 (non inferiore al campo precedente) |

4. In **Tier-based service quotas** modifica la tabella sottostante.
5. Clicca su **Save**. NexCMP richiederà un **motivo**, che verrà registrato nel log di audit insieme ai valori vecchi e nuovi. La modifica si applica a tutti i clienti.

![Scheda Quota con l'interruttore di abilitazione, i limiti delle VM e la tabella delle quote di servizio basate sui livelli](https://nexcmp.com/it/docs/images/billing/quotas-01-policy.webp)

### Tabella delle quote di servizio {#service-quota-table}

La tabella ha cinque livelli. Le celle di intestazione da **L0** a **L4** contengono la **soglia di deposito in centesimi**: i valori predefiniti `0, 1000, 5000, 20000, 100000` significano L0 per un nuovo account, L1 da $10, L2 da $50, L3 da $200 e L4 da $1,000. La prima soglia deve rimanere `0`. Ogni riga definisce la quota di una chiave per livello; **-1 significa illimitato**.

| Key | Significato | L0 | L1 | L2 | L3 | L4 |
|---|---|---|---|---|---|---|
| `vpn.ips` | VPN IPs | 2 | 10 | 30 | 100 | 500 |
| `proxy6.ips` | IPv6 proxy IPs | 500 | 2000 | 10000 | 50000 | -1 |
| `dedicated.servers` | Bare-metal servers | 1 | 2 | 5 | 20 | 50 |
| `s3.storage_gb` | Object Storage GB allocated | 2048 | 4096 | 10240 | 51200 | -1 |
| `k8s.clusters` | Kubernetes clusters | 1 | 2 | 5 | 10 | 30 |
| `k8s.workers` | Kubernetes worker nodes | 3 | 9 | 18 | 50 | 200 |
| `vpc.count` | Private Cloud networks | 1 | 2 | 5 | 10 | 30 |
| `images.gb` | Spazio di archiviazione immagini personalizzate in GB | 50 | 100 | 200 | 500 | 2000 |

La tabella elenca anche alcune righe per prodotti non inclusi in questa versione; lasciale invariate. Una chiave il cui prodotto è disattivato viene nascosta e non viene mai applicata. Un valore deve essere `-1` o compreso tra `0` e `10,000,000`.

Le quote di servizio seguono la **base dei fondi**, come i livelli delle VM: il saldo del portafoglio più alto raggiunto, non il totale dei pagamenti con carta. I clienti rivenditori utilizzano le stesse impostazioni predefinite e il rivenditore può solo visualizzarle.

## Per-customer overrides {#per-customer-overrides}

1. Apri **Customers › List**, quindi il cliente. In **Overview** trova la scheda **Quota**.
2. **Risorse VM:** fai clic su **Quota override** e scegli una delle opzioni
   - **Per saldo di ricarica (rimuovi override)** — comportamento predefinito;
   - **Illimitato (incluso il conteggio delle VM)** — rimuove ogni limite per questo cliente;
   - **un livello del piano** — fissa il limite delle risorse a quel piano; la regola sul conteggio delle VM continua ad aplicarsi.

   Inserisci un motivo. Gli amministratori della piattaforma possono impostare qualsiasi livello; un override impostato da un rivenditore non può superare la base trattenuta del cliente.
3. **Servizi:** la tabella nella sezione *Service quotas* mostra ciascuna chiave con *In use*, il limite effettivo e la relativa *Source* (livello o override). Fai clic su **Edit** su una riga, digita il valore **New quota** (`-1` = illimitato, vuoto = torna al livello predefinito) e un motivo.

![Scheda della quota cliente con il livello, l'utilizzo delle risorse e la tabella delle quote di servizio con un override](https://nexcmp.com/it/docs/images/billing/quotas-02-customer.webp)

Ogni override viene registrato nel registro di audit con l'amministratore, il motivo e i valori precedenti/successivi.

## Cosa vede il cliente {#what-the-customer-sees}

**Client › Quotas** (`/client/quotas`) mostra il **livello attuale** del cliente, vCPU, RAM, disco e conteggio VM usati e totali (suddivisi tra VM e Kubernetes), il **saldo del portafoglio idoneo**, la **base di risorse trattenute** (che non diminuisce quando spendono) e quanto ricaricare per il livello successivo. Un cursore consente loro di scegliere un livello di destinazione e passare direttamente alla schermata di deposito. La scheda **Service Quotas** elenca ciascun servizio con la quota, la quantità utilizzata, il relativo livello (da L0 a L4), quanto altro depositare per il livello successivo e un pulsante **Request increase** che apre una bozza di ticket di supporto. Un pulsante **Quota policy** spiega le regole.

![Pagina delle quote del portale con il livello corrente, l'utilizzo delle risorse e le quote di servizio](https://nexcmp.com/it/docs/images/billing/quotas-03-portal.webp)

## Verifica {#verify}

1. Attiva **Enable quota** e usa un nuovo cliente di prova con un saldo di $0.
2. Prova a creare una VM più grande del tuo piano più economico. La richiesta viene rifiutata con `quota_exceeded` e il messaggio "Exceeds the resources of tier ... Top up $X more to unlock tier ...".
3. Ricarica l'importo indicato. Il livello cambia immediatamente e la stessa richiesta va a buon fine.
4. Acquista IP VPN oltre il limite L0: HTTP 403 `quota_exceeded` con `"scope":"service"` e un link a `/client/quotas`.
5. Nella scheda Quota del cliente, **Source** mostra *tier*; imposta un override e vedi che cambia in *override*.

## Limiti e note {#limits-notes}

- **Disattivato significa disattivato.** Con `quota_enabled` disattivato, la vecchia regola `new_account_max_vms` (**Services › Virtual Machines › Policy › Sales**) limita i nuovi account a 2 VM finché i loro depositi non raggiungono $10. Quando la quota è attiva, tale regola non si applica più.
- setItems("**Le macchine virtuali create dagli admin non sono bloccate.**"),
- setItems("**Gli errori bloccano il processo.** Se lo stato della quota non può essere letto, la richiesta viene rifiutata con `quota_unavailable` anziché essere consentita."),
- setItems("**Le richieste API, CLI e MCP** usano gli stessi gestori, quindi si applicano gli stessi limiti."),
- setItems("**Il credito promozionale** non fa salire di livello (vedi [Promotions](https://nexcmp.com/it/docs/billing/promotions/))."),
- setItems("**Le soglie dei livelli sono in centesimi**, non in dollari."),

## Troubleshooting {#troubleshooting}

| Sintomo | Causa | Soluzione |
|---|---|---|
| setItems("`quota_exceeded`, motivo `resources`"), | setItems("Il nuovo totale di vCPU/RAM/disco supera il livello"), | setItems("Ricarica l'importo indicato nel messaggio o imposta un override."), |
| setItems("`quota_exceeded`, motivo `vm_30d`"), | setItems("Superiore al conteggio VM del livello 24h e il portafoglio non copre ancora 30 giorni della flotta"), | setItems("Ricarica l'importo mostrato."), |
| setItems("`quota_exceeded`, motivo `vm_max`"), | setItems("Il limite massimo assoluto di VM è stato raggiunto"), | setItems("Aumenta **Max VMs when meeting 30-day threshold** o usa un override."), |
| `quota_exceeded`, `scope: service` | setItems("Un limite per servizio è stato raggiunto"), | setItems("Aumenta il valore nella tabella o sovrascrivi quella chiave per il cliente."), |
| `quota_unavailable` | setItems("Lo stato della quota non ha potuto essere verificato"), | setItems("Riprova; controlla il log del server se il problema persiste."), |
| setItems("\"quota_max_vms_30d must be >= quota_max_vms_24h\" al salvataggio"), | setItems("Valori invertiti"), | setItems("Rendi il numero a 30 giorni almeno pari a quello a 24 ore."), |
| setItems("Il cliente segnala che il livello è sceso"), | setItems("Non scende; confronta la **Held resource basis** con il costo del piano"), | setItems("Controlla il listino prezzi del piano: un aumento del prezzo può spostare le soglie."), |