RemoteGymp · API v1

Mantieni una copia sincronizzata

Copia l'elenco dei dispositivi in ​​un altro sistema, quindi recupera solo le modifiche.

  1. Crea un'istantanea completa

    Chiama POST a /v1/sync/devices con previousSnapshotId impostato a null. Leggi GET a /v1/sync/devices/{snapshotId}, passando ogni valore di next come after, finché next non diventa null.

  2. Salva il checkpoint dopo che ogni pagina è stata elaborata correttamente.

    Applica ogni pagina, quindi salva l'ID dell'istantanea. La prossima volta, invia quell'ID come previousSnapshotId. Applica i record di upsert aggiungendo o aggiornando il dispositivo; rimuovi i record contrassegnati con deleted, il cui valore del dispositivo è null. Rendi ogni pagina sicura per una nuova applicazione. Conserva il checkpoint precedente fino al completamento dell'aggiornamento.

  3. Ricomincia quando necessario.

    Se il checkpoint scade con codice 410, crea un nuovo snapshot completo e confrontalo con i dati salvati. Gli snapshot appartengono alle credenziali che li hanno creati, quindi una credenziale sostitutiva necessita di una propria baseline.

  4. Conserva checkpoint separati per gli altri dati.

    Gli snapshot dei dispositivi contengono riepiloghi. Inventario dettagliato, software, avvisi e campi personalizzati utilizzano ciascuno le credenziali POST e /v1/sync/{resource} e necessitano di un proprio checkpoint.

  5. Limiti degli snapshot

    Gli snapshot scadono dopo sette giorni e possono contenere al massimo 10.000 dispositivi. Ogni credenziale può creare quattro snapshot per risorsa e organizzazione all'ora; Ogni organizzazione può crearne un totale di venti all'ora. Lo spazio di archiviazione per gli snapshot compressi è limitato a 256 MiB per organizzazione.

Riferimento API →

Revisione dei contenuti 3f225a253 · OpenAPI SHA-256: b12c42306a89