Aggiorna un record esistente della zona DNS.
PATCHhttps://console.icbs.it/api/v1/domains/{dominio}/dns/records/{id}| Parametro | Posizione | Obbligatorio | Descrizione |
|---|---|---|---|
dominio | indirizzo | sì | Il nome a dominio, per esempio esempio.it. |
id | indirizzo | sì | Identificativo del record, ottenuto da l'elenco dei record. |
type | corpo | sì | Tipo del record. |
host | corpo | sì | Il sottodominio. Stringa vuota per il dominio principale. |
record | corpo | sì | Il nuovo valore. |
ttl | corpo | no | Nuovo tempo di vita in secondi. |
I tipi che hanno campi propri — MX, SRV, CAA, SSHFP, HINFO, RP, HTTPS, SVCB — li richiedono anche in modifica: vedi la tabella in Creare un record.
Invia sempre tutti i campi del record, non solo quelli che cambiano. Nonostante il metodo PATCH, il record viene riscritto per intero: un campo omesso viene perso, non conservato.
Cambiare l'indirizzo IP di www:
curl -X PATCH \
-H "Authorization: Bearer $ICBS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "A",
"host": "www",
"record": "93.184.216.35",
"ttl": 3600
}' \
https://console.icbs.it/api/v1/domains/esempio.it/dns/records/123457
{
"domain": "esempio.it",
"updated": {
"id": "123457",
"type": "A"
}
}
| Codice | Causa |
|---|---|
400 | Dati non validi, oppure il record è gestito automaticamente da un servizio attivo sul dominio e non è modificabile. |
401 | Chiave assente, non valida, scaduta o revocata. |
403 | Alla chiave manca il permesso di scrittura DNS, oppure il dominio è protetto o inattivo. |
404 | Il dominio non esiste o la chiave non vi ha accesso. |
429 | Superato il limite di richieste. |
Se ricevi 400 su un record che nell'interfaccia risulta bloccato, controlla il campo managedBy nell'elenco dei record: i record creati automaticamente dai servizi attivi non sono modificabili né da qui né dall'interfaccia.