RemoteGymp · API v1

Halten Sie eine Kopie synchron.

Kopieren Sie Ihre Geräteliste in ein anderes System und rufen Sie dann nur die geänderten Daten ab.

  1. Vollständigen Snapshot erstellen

    POST /v1/sync/devices aufrufen, wobei previousSnapshotId auf null gesetzt ist. GET /v1/sync/devices/{snapshotId} lesen und jeden next-Wert als after übergeben, bis next null entspricht.

  2. Prüfpunkt nach jeder erfolgreichen Seite speichern

    Jede Seite anwenden und die Snapshot-ID speichern. Beim nächsten Mal diese ID als previousSnapshotId senden. upsert-Datensätze anwenden, indem das Gerät hinzugefügt oder aktualisiert wird; Datensätze mit der Markierung deleted entfernen, deren Gerätewert null ist. Jede Seite für die erneute Anwendung sichern. Behalten Sie Ihren alten Prüfpunkt bei, bis das gesamte Update erfolgreich abgeschlossen ist.

  3. Bei Bedarf neu starten

    Wenn der Prüfpunkt mit dem Statuscode 410 abläuft, erstellen Sie einen neuen vollständigen Snapshot und vergleichen Sie ihn mit Ihren gespeicherten Daten. Snapshots gehören zu den Anmeldeinformationen, die sie erstellt haben. Daher benötigt eine Ersatzanmeldeinformation eine eigene Baseline.

  4. Separate Prüfpunkte für andere Daten speichern

    Geräte-Snapshots enthalten Zusammenfassungen. Detaillierte Inventardaten, Software, Warnungen und benutzerdefinierte Felder verwenden jeweils POST und /v1/sync/{resource} und benötigen einen eigenen Prüfpunkt.

  5. Snapshot-Limits

    Snapshots laufen nach sieben Tagen ab und enthalten maximal 10.000 Geräte. Jede Anmeldeinformation kann vier Snapshots pro Ressource und Organisation pro Stunde erstellen. Jede Organisation kann maximal zwanzig Snapshots pro Stunde erstellen. Der komprimierte Snapshot-Speicher ist auf 256 MiB pro Organisation beschränkt.

API-Referenz →

Inhaltsüberarbeitung 3f225a253 · OpenAPI SHA-256: b12c42306a89