Eliminare un record

Rimuove un record dalla zona DNS. L'operazione non è annullabile.

• Metodo: DELETE
• Indirizzo: https://console.icbs.it/api/v1/domains/{dominio}/dns/records/{id}
• Permesso: DNS — creazione, modifica ed eliminazione record

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
dominio	indirizzo	sì	Il nome a dominio, per esempio esempio.it.
id	indirizzo	sì	Identificativo del record, ottenuto da l'elenco dei record.

Nessun corpo della richiesta.

Esempio di richiesta

curl -X DELETE \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  https://console.icbs.it/api/v1/domains/esempio.it/dns/records/123456

Esempio di risposta

{
  "domain": "esempio.it",
  "deleted": {
    "id": "123456"
  }
}

Possibili errori

Codice	Causa
400	Il record è gestito automaticamente da un servizio attivo sul dominio e non è eliminabile.
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso di scrittura DNS, oppure il dominio è protetto o inattivo.
404	Il dominio non esiste o la chiave non vi ha accesso.
429	Superato il limite di richieste.

Attenzione

L'eliminazione è irreversibile: non esiste un cestino da cui recuperare un record cancellato per errore.

Prima di usarla in uno script:

• Rileggi l'elenco dei record subito prima di eliminare, invece di riusare un id salvato in precedenza. Gli identificativi cambiano quando un record viene ricreato, e cancellare quello sbagliato in una zona di produzione mette offline un servizio.
• Salta i record con managedBy: appartengono ai servizi attivi sul dominio e la chiamata verrebbe comunque rifiutata.
• Se lo script fa pulizia automatica, restringi il campo per tipo e per nome host — per esempio solo i TXT sotto _acme-challenge — invece di eliminare tutto ciò che non riconosce.