Creare o modificare un child nameserver

Registra l'indirizzo IP di un child nameserver, o ne aggiorna uno esistente.

• Metodo: PUT
• Indirizzo: https://console.icbs.it/api/v1/domains/{dominio}/glue/{host}
• Permesso: Domini — modifica

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
dominio	indirizzo	sì	Il nome a dominio.
host	indirizzo	sì	Il nome completo, per esempio ns1.esempio.it.
ip	corpo	sì	Indirizzo IPv4.
ip6	corpo	no	Indirizzo IPv6.

Una sola chiamata per creare e per aggiornare: non devi sapere in anticipo se l'host esiste già.

Esempio di richiesta

curl -X PUT \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ip":"93.184.216.34"}' \
  https://console.icbs.it/api/v1/domains/esempio.it/glue/ns1.esempio.it

Esempio di risposta

{ "domain": "esempio.it", "host": "ns1.esempio.it", "saved": true }

Il nome deve stare dentro il dominio

ns1.altro-dominio.it non è un child nameserver di esempio.it: la richiesta viene rifiutata. Solo i nomi sotto il dominio stesso hanno bisogno di questa registrazione.

Possibili errori

Codice	Causa
400	Indirizzo IP mancante o non valido, oppure il nome non appartiene al dominio.
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.