Aktualizuj pola niestandardowe i okna konserwacyjne, uruchamiaj automatyzację i ponawiaj próby bezpiecznego zapisu.
API i MCP obsługują zadania w kolejce, zaplanowane włączanie/wyłączanie zasilania, odinstalowywanie agenta, diagnostykę punktu końcowego, anulowanie poleceń oraz polityki poprawek od strony trzeciej. Ponownie używaj kluczy idempotentności i sprawdzaj potwierdzenia. Tymczasowe dane administratora są zwracane jednokrotnie. Monitorowanie ruchu wymaga istniejącego uprawnienia; rozliczenia pozostają w aplikacji.
Sprawdź swoje uprawnienia
Predefiniowane ustawienia wybierają poszczególne uprawnienia; nie zmieniają one poziomu dostępu. Nowe dane uwierzytelniające w Ustawieniach domyślnie używają FullAccess, ale dozwolone są tylko wybrane uprawnienia. Starsze dane uwierzytelniające ReadWrite umożliwiają zatwierdzone zmiany w polach niestandardowych i w konserwacji. Automatyzacja i sterowanie urządzeniami wymagają FullAccess oraz ich określonych uprawnień. Przed zapisem sprawdź GET /v1/operations/capabilities. Zakres firmy i uprawnienia obecnego właściciela nadal obowiązują.
Unikaj nadpisywania kolejnych zmian
Odczytaj pole niestandardowe i jego wersję. Wyślij nową wartość i odczytaną wersję do PATCH /v1/custom-fields/{fieldId}.. Kod 409 dla version_conflict oznacza, że ktoś zmienił ją pierwszy. Przeczytaj ją ponownie i zdecyduj, czy aktualizacja jest nadal prawidłowa.
Spróbuj ponownie bezpiecznie
Dla POST /v1/maintenance-windows wyślij nagłówek Idempotency-Key. Po uzyskaniu niepewnego wyniku powtórz ten sam klucz i treść, aby przywrócić oryginalne okno zamiast tworzyć duplikat. Zmieniona treść z tym samym kluczem jest odrzucana. DELETE /v1/maintenance-windows/{windowId} anuluje okno.
Potwierdzenia wykonania akcji
Zapisy automatyzacji i zarządzania używają idempotencyKey w treści JSON i zwracają potwierdzenie operacji. Completed oznacza, że obsługa żądania została zakończona; sprawdź wynik lub przebieg domeny, aby dowiedzieć się, czy urządzenie zakończyło pracę. W przypadku OutcomeUnknown sprawdź potwierdzenie i aktualny stan przed podjęciem decyzji. Nigdy nie wysyłaj ponownie automatycznie z nowym kluczem: akcja może zostać wykonana dwukrotnie.