Cambia i nameserver a cui il dominio è delegato.
PATCHhttps://console.icbs.it/api/v1/domains/{dominio}/nameservers| Parametro | Posizione | Obbligatorio | Descrizione |
|---|---|---|---|
nameservers | corpo | sì | L'elenco completo dei nameserver. |
L'elenco che invii sostituisce quello esistente, non vi si aggiunge: se ne mandi uno solo, quello diventa l'unico.
curl -X PATCH \
-H "Authorization: Bearer $ICBS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"nameservers":["ns1.icbs.it","ns2.icbs.it"]}' \
https://console.icbs.it/api/v1/domains/esempio.it/nameservers
{ "domain": "esempio.it", "nameservers": ["ns1.icbs.it", "ns2.icbs.it"] }
Spostare la delega significa cambiare chi risponde per il tuo dominio: se i nuovi nameserver non hanno già la zona configurata, il dominio smette di risolvere — sito e posta compresi — finché la situazione non viene sistemata.
L'ordine corretto è: prima configurare la zona sulla destinazione, poi spostare la delega. E tieni conto che il cambio non è istantaneo: gli altri server conservano l'informazione precedente per un po'.
| Codice | Causa |
|---|---|
400 | Elenco mancante, vuoto o con nomi non validi. |
401 | Chiave assente, non valida, scaduta o revocata. |
403 | Manca il permesso Domini — modifica, o il dominio è protetto. |
404 | Il dominio non esiste o la chiave non vi ha accesso. |
429 | Superato il limite di richieste. |