Modificare il record SOA

Aggiorna i valori del record SOA della zona.

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

Parametri

I valori vanno nel corpo della richiesta in formato JSON.

Parametro	Descrizione
primary-ns	Il server DNS considerato autorevole per la zona.
admin-mail	Indirizzo email dell'amministratore della zona.
refresh	Ogni quanti secondi gli altri server ricontrollano la zona.
retry	Dopo quanti secondi riprovare se il controllo non riesce.
expire	Dopo quanti secondi una copia non aggiornata smette di essere considerata valida.
default-ttl	Per quanti secondi conservare una risposta negativa.

Esempio di richiesta

curl -X PATCH \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"refresh":7200,"retry":1800,"expire":1209600,"default-ttl":3600}' \
  https://console.icbs.it/api/v1/domains/esempio.it/dns/soa

Esempio di risposta

{ "domain": "esempio.it", "updated": true }

Prima di cambiarli

I valori predefiniti vanno bene nella quasi totalità dei casi. Sono tempi che riguardano la propagazione: abbassarli troppo aumenta il traffico verso i server DNS senza vantaggi reali, alzarli troppo fa sì che una modifica impieghi molto più tempo a diffondersi.

Se non hai un motivo preciso per toccarli, leggi i valori attuali e lasciali come sono.

Possibili errori

Codice	Causa
400	Valori non validi o corpo non in JSON valido.
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso di scrittura DNS, o il dominio è protetto.
404	Il dominio non esiste o la chiave non vi ha accesso.
429	Superato il limite di richieste.