Elimina la zona DNS del dominio.
DELETEhttps://console.icbs.it/api/v1/domains/{dominio}/dnsL'operazione è irreversibile e mette offline il dominio. Tutti i record vengono eliminati: il sito smette di rispondere, la posta smette di arrivare, e non esiste un cestino da cui recuperarli.
Per questo richiede un permesso dedicato, diverso da quello che serve a gestire i record. Una chiave creata per rinnovare i certificati non può eliminare la zona che contiene i record su cui lavora: sono due permessi separati proprio perché il primo non diventi per sbaglio il secondo.
Se ti serve solo smettere di gestire il DNS da qui senza perdere i record, non usare questa chiamata: cambia i nameserver del dominio.
Se l'eliminazione non va a buon fine la chiamata risponde con un errore: non dichiara un successo parziale.
| Parametro | Posizione | Obbligatorio | Descrizione |
|---|---|---|---|
dominio | indirizzo | sì | Il nome a dominio, per esempio esempio.it. |
curl -X DELETE \
-H "Authorization: Bearer $ICBS_API_KEY" \
https://console.icbs.it/api/v1/domains/esempio.it/dns
{ "domain": "esempio.it", "deleted": true }
| Codice | Causa |
|---|---|
401 | Chiave assente, non valida, scaduta o revocata. |
403 | Alla chiave manca il permesso DNS — eliminazione della zona. |
404 | Il dominio non esiste o la chiave non vi ha accesso. |
429 | Superato il limite di richieste. |