Modificare un controllo

Aggiorna un controllo di monitoraggio esistente: nome, intervallo di verifica o attivazione.

• Metodo: PATCH
• Indirizzo: https://console.icbs.it/api/v1/monitoring/{id}
• Permesso: Monitoraggio — creazione, modifica ed eliminazione controlli

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
id	indirizzo	sì	Identificativo del controllo, da l'elenco.
name	corpo	no	Nuovo nome.
period	corpo	no	Nuovo intervallo in minuti.
active	corpo	no	false sospende il controllo senza eliminarlo.

Esempio di richiesta

Sospendere un controllo durante una manutenzione programmata, senza perderne lo storico:

curl -X PATCH \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"active":false}' \
  https://console.icbs.it/api/v1/monitoring/51

Esempio di risposta

{ "updated": { "id": 51, "name": "Sito principale" } }

Possibili errori

Codice	Causa
400	Dati non validi, oppure intervallo non consentito dal tuo piano.
401	Chiave assente, non valida, scaduta o revocata.
403	Manca il permesso di scrittura sul monitoraggio.
404	Il controllo non esiste, oppure è su un dominio fuori da quelli assegnati alla chiave.
429	Superato il limite di richieste.