Aggiunge un controllo di monitoraggio. Permette di attivare la sorveglianza contestualmente alla pubblicazione di un sito, invece di doverla aggiungere a mano dopo.
POSThttps://console.icbs.it/api/v1/monitoringI parametri vanno nel corpo della richiesta in formato JSON e dipendono dal tipo di controllo.
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
name | sì | Nome con cui riconoscere il controllo. |
type | sì | Tipo: web, ping, dns e gli altri disponibili. |
domainId | no | Dominio a cui associarlo, da l'elenco dei domini. |
period | no | Ogni quanti minuti eseguire la verifica. |
curl -X POST \
-H "Authorization: Bearer $ICBS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Sito principale","type":"web","domainId":318,"period":5}' \
https://console.icbs.it/api/v1/monitoring
{ "created": { "id": 51, "name": "Sito principale", "type": "web" } }
Il numero di controlli è limitato dal tuo piano di monitoraggio. Superato il numero incluso la chiamata viene rifiutata con un errore, non ignorata silenziosamente: uno script che ne crea in serie se ne accorge subito invece di credere che siano stati creati tutti.
Anche l'intervallo di verifica dipende dal piano: un valore non consentito viene rifiutato.
| 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, o è stata raggiunta la quota del piano. |
429 | Superato il limite di richieste. |