Applicare un template

Configura una zona applicando un template DNS: una chiamata al posto di molte creazioni record.

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

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
dominio	indirizzo	sì	Il nome a dominio.
templateId	corpo	sì	Identificativo del template, da l'elenco.
dryRun	corpo	no	Con true calcola le differenze senza applicarle.

Provalo prima di applicarlo

Su una zona di produzione conviene sempre una passata con dryRun prima di quella vera: restituisce le stesse differenze che verrebbero applicate, senza toccare nulla.

curl -X POST \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"templateId":4,"dryRun":true}' \
  https://console.icbs.it/api/v1/domains/esempio.it/dns/apply-template

Esempio di richiesta

curl -X POST \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"templateId":4}' \
  https://console.icbs.it/api/v1/domains/esempio.it/dns/apply-template

Esempio di risposta

{
  "domain": "esempio.it",
  "template": { "id": 4, "name": "Sito WordPress + posta" },
  "dryRun": false,
  "preview": { "ns": { "desired": ["ns1.icbs.it", "ns2.icbs.it"] } },
  "applied": { "created": 5, "updated": 2, "deleted": 0 }
}

preview descrive le differenze calcolate, applied cosa è stato effettivamente scritto — assente quando dryRun è true.

Possibili errori

Codice	Causa
400	templateId mancante 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	Dominio o template inesistente, oppure non accessibile alla chiave.
429	Superato il limite di richieste.