Aggiorna i campi personalizzati e le finestre di manutenzione, esegui l'automazione e riprova le scritture in modo sicuro.
L'API e MCP supportano lavori in coda, alimentazione programmata, disinstallazione dell'agente, diagnostica degli endpoint, cancellazione dei comandi e policy di patch di terze parti. Riutilizzare le chiavi di idempotenza e verificare le ricevute. Le credenziali temporanee dell'amministratore vengono restituite una sola volta. Il monitoraggio del traffico richiede un diritto esistente; la fatturazione rimane nell'applicazione.
Verifica le autorizzazioni.
I preset selezionano singole funzionalità; non modificano il livello di accesso. Le nuove credenziali in Impostazioni utilizzano FullAccess per impostazione predefinita, ma sono consentite solo le funzionalità selezionate. Le credenziali precedenti ReadWrite consentono modifiche approvate ai campi personalizzati e alle finestre di manutenzione. L'automazione e il controllo dei dispositivi richiedono FullAccess più le relative funzionalità specifiche. Verifica GET e /v1/operations/capabilities prima di scrivere. L'ambito aziendale e le autorizzazioni del proprietario corrente rimangono valide.
Evita di sovrascrivere un'altra modifica.
Leggi il campo personalizzato e la sua versione. Invia il nuovo valore e la versione letta a PATCH /v1/custom-fields/{fieldId}.. Un codice di errore 409 version_conflict indica che qualcuno lo ha modificato in precedenza. Rileggilo e decidi se l'aggiornamento è ancora appropriato.
Riprova in modo sicuro
Per POST /v1/maintenance-windows, invia un'intestazione Idempotency-Key. In caso di risultato incerto, ripeti la stessa chiave e lo stesso corpo per recuperare la finestra originale anziché crearne una copia. Un corpo modificato con la stessa chiave viene rifiutato. DELETE /v1/maintenance-windows/{windowId} annulla una finestra.
Segui le ricevute delle azioni
Le scritture automatiche e di gestione utilizzano idempotencyKey nel corpo di JSON e restituiscono una ricevuta dell'operazione. Completed indica che il gestore della richiesta ha terminato; controllare il risultato o l'esecuzione del dominio per verificare se il dispositivo ha completato l'operazione. Per OutcomeUnknown, esaminare la ricevuta e lo stato corrente prima di decidere come procedere. Non inviare mai automaticamente una nuova chiave: l'azione potrebbe essere eseguita due volte.