Guida · Per gli amministratori
Self-service e uso a ore
Dalla 0.12, oltre alle VPS dei piani, puoi vendere un pacchetto di risorse: il cliente crea, cambia piano e cancella da solo le sue VPS, fino ai limiti del pacchetto. Il self-service è spento finché non lo accendi: se vendi solo VPS predefinite non cambia niente, né per te né per i clienti.
Accenderlo
- Impostazioni › Self-service: spunta «I clienti con un pacchetto creano da soli le loro VPS».
- Clienti e piani › piano: spunta «Offerto nel self-service» sui piani che i clienti possono scegliere. Gli altri piani restano solo per le VPS che vendi tu.
- Clienti e piani › cliente › Self-service: i limiti del pacchetto (VPS, vCPU, RAM, disco; 0 = senza limite), i piani compresi (nessuno = tutti quelli offerti nel self-service) e i nodi (nessuno = tutti i nodi del pannello). Il cliente sceglie la città, non il nodo.
Nell'elenco dei clienti chi ha un pacchetto ha l'etichetta «Self-service» con il numero di VPS; i piani offerti hanno l'etichetta «self-service».
Cosa fa il cliente
- In Servizi vede il pacchetto, quanto ne ha usato e Crea VPS: piano, città, sistema, applicazione al primo avvio, password, chiavi SSH salvate, script al primo avvio, rete privata. I piani che non ci stanno nel pacchetto restano visibili ma spenti, con il motivo.
- Nella pagina di una VPS del pacchetto: Cambia piano (solo i piani del pacchetto; il disco non si riduce) ed Elimina VPS (scrivendo il nome host).
- Le VPS vendute a parte (da te, da WHMCS o da KoaBilling) non contano nel pacchetto e il cliente non le può cambiare né cancellare.
- I volumi staccati del cliente contano nel disco del pacchetto (occupano ancora spazio).
- Le VPS del pacchetto vanno solo sui nodi del pannello, non sulle zone dei fornitori.
Nella pagina della VPS, riquadro Amministrazione, una VPS del pacchetto ha «Origine: creata dal cliente nel pacchetto self-service».
Sospendere e togliere il pacchetto
- Sospeso (nel pacchetto): le VPS del pacchetto si spengono con il motivo «fatturazione» e non se ne creano di nuove; togliendo la spunta si riaccendono.
- Togli il pacchetto: scegli se tenere le VPS (diventano VPS normali, il cliente non le può più cambiare) o cancellarle (con i dischi, gli snapshot e i backup; va confermato scrivendo l'email del cliente).
- I rivenditori non hanno un pacchetto: creano già le VPS dalla loro pagina, dentro i loro limiti. Il cliente di un rivenditore può avere un pacchetto: valgono anche i limiti, i piani e i nodi del rivenditore.
Chiavi SSH e script al primo avvio
Valgono per tutti, anche per le VPS che crei tu:
- Il mio account › Chiavi SSH: le chiavi pubbliche salvate si scelgono con un clic quando crei o reinstalli una VPS.
- Script al primo avvio (Linux, al massimo 64 KB): gira una volta come root, dopo la rete e dopo l'applicazione scelta (se c'è). Il registro è in
/var/log/koavm-script.log, il codice di uscita in/var/lib/koavm-script/exit. Dall'API:user_scriptnella creazione.
Uso a ore
Ogni ora il pannello conta, per ogni VPS (anche quelle vendute a parte) e per ogni volume staccato, le risorse assegnate: ore, vCPU-ore, RAM-ore, disco-ore (con i dischi collegati) e ore di IPv4. Le righe sono per mese e si tengono 24 mesi; le ore in cui il pannello è spento non si contano. Una VPS cancellata resta nell'uso del mese.
- Il pacchetto mostra l'uso del mese al cliente e a te.
GET /usage?month=AAAA-MMdell'API dà il dettaglio riga per riga (client_idper un cliente,self_service=1per le sole VPS dei pacchetti): KoaBilling lo legge per fatturare a ore.- Il modulo WHMCS (1.5) ha il tipo di prodotto «pacchetto»: crea il cliente e il pacchetto, sospende, riattiva, cambia i limiti e cancella; in più offre all'Usage Billing di WHMCS le ore del mese (VPS, vCPU, RAM, disco) da mettere a prezzo nel prodotto.
Dall'API
| Chiamata | Cosa fa |
|---|---|
GET /clients/{id}/quota | pacchetto del cliente, uso e ore del mese |
PUT /clients/{id}/quota | dà o cambia il pacchetto: max_vps, max_vcpu, max_ram_mb, max_disk_gb, plans, nodes, suspended, external_id |
DELETE /clients/{id}/quota | toglie il pacchetto; con ?delete_vps=1&confirm=<email> cancella anche le sue VPS |
GET /usage?month=AAAA-MM | uso a ore del mese (client_id, self_service=1) |
POST /vps | anche ssh_key_ids (chiavi salvate di chi ha la chiave API) e user_script |
Vedi anche Clienti e VPS e API e integrazioni.