Aggiorna la configurazione del firewall applicativo del sito.
PATCHhttps://console.icbs.it/api/v1/hosting/{hostname}/wafInvia la configurazione completa, come la leggi da Firewall applicativo: i campi omessi tornano al valore predefinito, non restano com'erano.
| Parametro | Posizione | Obbligatorio | Descrizione |
|---|---|---|---|
hostname | indirizzo | sì | Il nome del sito, per esempio esempio.it. |
enabled | corpo | sì | true o false. |
mode | corpo | no | detection oppure blocking. |
ruleSet | corpo | no | crs oppure icbs. |
pathExceptions | corpo | no | Elenco di { "path": "/percorso/", "note": "..." }. |
ipWhitelist | corpo | no | Elenco di indirizzi IP o reti in notazione CIDR. |
curl -X PATCH \
-H "Authorization: Bearer $ICBS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"enabled":true,"mode":"blocking","ruleSet":"crs","pathExceptions":[],"ipWhitelist":[]}' \
https://console.icbs.it/api/v1/hosting/esempio.it/waf
{
"job": {
"id": "wj_8f3k2m",
"hostname": "esempio.it",
"type": "web.cron",
"status": "pending",
"error": null,
"createdAt": "2026-10-01T10:00:00.000Z",
"updatedAt": "2026-10-01T10:00:00.000Z"
}
}
La risposta contiene un job: la modifica viene applicata entro pochi minuti. Per sapere quando è conclusa, interroga lo stato dell'operazione.
| Codice | Causa |
|---|---|
400 | Dati non validi. |
401 | Chiave assente, non valida, scaduta o revocata. |
403 | Alla chiave manca il permesso Hosting — configurazione siti. |
404 | Il sito non esiste o la chiave non vi ha accesso. |
409 | Un'altra operazione è ancora in corso sul sito: riprova tra qualche minuto. |
429 | Superato il limite di richieste. |