Actualizați câmpurile personalizate și ferestrele de întreținere, rulați automatizarea și reîncercați scrierile în siguranță.
API-ul și MCP acceptă lucrări în coadă, programarea alimentării, dezinstalarea agentului, diagnosticele endpoint-ului, anularea comenzilor și politicile de patch-uri terță parte. Reutilizați cheile de idempotenta și inspectați chitanțele. Credențialele temporare de administrator sunt returnate o singură dată. Monitorizarea traficului necesită un drept existent; facturarea rămâne în aplicație.
Verificați permisiunile
Presetările selectează capabilități individuale; acestea nu modifică nivelul de acces. Noile acreditări din Setări utilizează FullAccess în mod implicit, dar sunt permise doar capabilitățile selectate. Acreditările ReadWrite mai vechi permit modificări aprobate ale câmpurilor personalizate și ale întreținerii. Automatizarea și controlul dispozitivelor necesită FullAccess plus capabilitățile lor specifice. Verificați GET și /v1/operations/capabilities înainte de a scrie. Domeniul de aplicare al companiei și permisiunile proprietarului actual se aplică în continuare.
Evitați suprascrierea unei alte modificări
Citiți câmpul personalizat și versiunea acestuia. Trimiteți noua valoare și versiunea citită către PATCH /v1/custom-fields/{fieldId}. Un cod 409 version_conflict înseamnă că cineva a modificat-o mai întâi. Citiți-o din nou și decideți dacă actualizarea este încă corespunzătoare.
Reîncercați în siguranță
Pentru POST /v1/maintenance-windows, trimiteți un antet Idempotency-Key. După un rezultat incert, repetați aceeași cheie și corp pentru a recupera fereastra originală în loc să creați un duplicat. Un corp modificat cu aceeași cheie este respins. DELETE /v1/maintenance-windows/{windowId} anulează o fereastră.
Primiri de acțiune
Scrierile de automatizare și gestionare utilizează idempotencyKey în corpul JSON și returnează o confirmare de operațiune. Completed înseamnă că handler-ul de solicitare a terminat; verificați rezultatul sau rularea domeniului pentru a afla dacă dispozitivul a terminat lucrarea. Pentru OutcomeUnknown, inspectați chitanța și starea curentă înainte de a decide ce să faceți. Nu retrimiteți niciodată automat sub o cheie nouă: acțiunea s-ar putea executa de două ori.