RemoteGymp · API v1

同期コピーを保持してください。

デバイスリストを別のシステムにコピーし、変更された部分のみを取得してください。

  1. 完全なスナップショットを取得します。

    POST /v1/sync/devices を呼び出し、previousSnapshotId を null に設定します。GET /v1/sync/devices/{snapshotId} を読み込み、next の各値を after として渡します。next が null になるまでこの処理を繰り返します。

  2. 各ページが正常に処理されたら、チェックポイントを保存します。

    各ページを適用し、スナップショット ID を保存します。次回は、その ID を previousSnapshotId として送信します。upsert レコードをデバイスの追加または更新によって適用します。デバイス値が null である deleted とマークされたレコードを削除します。各ページを再度適用できるように安全にします。アップデートが完全に完了するまで、古いチェックポイントを保持してください。

  3. 必要に応じて再度開始してください。

    チェックポイントがエラーコード410で期限切れになった場合は、新しいフルスナップショットを作成し、保存済みのデータと比較してください。スナップショットは作成元の認証情報に紐づいているため、新しい認証情報を使用する場合は、独自のベースラインが必要です。

  4. その他のデータについては、別途チェックポイントを保持してください。

    デバイスのスナップショットには概要が含まれます。詳細なインベントリ、ソフトウェア、アラート、カスタムフィールドはそれぞれPOST /v1/sync/{resource}を使用し、独自のチェックポイントが必要です。

  5. スナップショットの制限

    スナップショットは7日後に期限切れとなり、最大10,000台のデバイスを保持できます。各認証情報につき、リソースおよび組織ごとに1時間あたり4つのスナップショットを作成できます。組織全体では、1時間あたり合計20個のスナップショットを作成できます。圧縮スナップショットの保存容量は、組織ごとに256 MiBに制限されています。

APIリファレンス →

内容改訂3f225a253 · OpenAPI SHA-256: b12c42306a89