RemoteGymp · API v1

Zachowaj kopię w synchronizacji

Skopiuj listę urządzeń do innego systemu, a następnie pobierz tylko to, co uległo zmianie.

  1. Wykonaj pełną migawkę

    Wywołaj POST /v1/sync/devices z wartością previousSnapshotId ustawioną na null. Odczytaj GET /v1/sync/devices/{snapshotId}, przekazując każdą wartość next jako after, aż wartość next będzie równa null.

  2. Zapisz punkt kontrolny po pomyślnym wykonaniu każdej strony.

    Zastosuj każdą stronę, a następnie zapisz identyfikator migawki. Następnym razem wyślij ten identyfikator jako previousSnapshotId. Zastosuj rekordy upsert, dodając lub aktualizując urządzenie; usuń rekordy oznaczone jako deleted, których wartość urządzenia to null. Przygotuj każdą stronę do ponownego zastosowania. Zachowaj stary punkt kontrolny, aż cała aktualizacja zakończy się powodzeniem.

  3. Uruchom ponownie w razie potrzeby

    Jeśli punkt kontrolny wygaśnie z kodem 410, wykonaj nową pełną migawkę i porównaj ją z zapisanymi danymi. Migawki należą do poświadczeń, które je utworzyły, więc zastępcze poświadczenia wymagają własnej linii bazowej.

  4. Zachowaj oddzielne punkty kontrolne dla innych danych

    Migawki urządzeń zawierają podsumowania. Szczegółowy inwentarz, oprogramowanie, alerty i pola niestandardowe używają POST /v1/sync/{resource} i wymagają własnego punktu kontrolnego.

  5. Limity migawek

    Migawki wygasają po siedmiu dniach i zawierają maksymalnie 10 000 urządzeń. Każde poświadczenie może utworzyć cztery migawki dla zasobu i organizacji na godzinę; każda organizacja może utworzyć łącznie dwadzieścia na godzinę. Skompresowane miejsce na migawki jest ograniczone do 256 MiB na organizację.

Referencje API →

Zmiany treści 3f225a253 · OpenAPI SHA-256: b12c42306a89