Leggere il record SOA

Restituisce il record SOA della zona: il record che descrive chi è l'autorità per il dominio e con quale frequenza gli altri server devono aggiornare la propria copia.

• Metodo: GET
• Indirizzo: https://console.icbs.it/api/v1/domains/{dominio}/dns/soa
• Permesso: DNS — lettura

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
dominio	indirizzo	sì	Il nome a dominio, per esempio esempio.it.

Esempio di richiesta

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

Esempio di risposta

{
  "domain": "esempio.it",
  "soa": {
    "primaryNS": "ns1.icbs.it",
    "adminMail": "admin@esempio.it",
    "refresh": 7200,
    "retry": 1800,
    "expire": 1209600,
    "defaultTTL": 3600
  }
}

Per modificarlo vedi Modificare il record SOA.

Possibili errori

Codice	Causa
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso DNS — lettura.
404	Il dominio non esiste o la chiave non vi ha accesso.
429	Superato il limite di richieste.