Quote

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

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

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): 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

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

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

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.

Tabella delle quote di servizio

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

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.

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

Cosa vede il cliente

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.

Verifica

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

• 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)."),
• setItems("Le soglie dei livelli sono in centesimi, non in dollari."),

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."),