RemoteGymp · API v1

یک کپی را در همگام‌سازی نگه دارید

لیست دستگاه خود را در سیستم دیگری کپی کنید، سپس فقط آنچه را که تغییر کرده است، دریافت کنید.

  1. یک اسنپ‌شات کامل بگیرید

    با POST با /v1/sync/devices تماس بگیرید و previousSnapshotId را روی null تنظیم کنید. GET /v1/sync/devices/{snapshotId} را بخوانید و هر مقدار next را به عنوان after عبور دهید، تا next برابر null شود.

  2. پس از موفقیت هر صفحه، چک‌پوینت خود را ذخیره کنید.

    هر صفحه را اعمال کنید، سپس شناسه اسنپ‌شات را ذخیره کنید. دفعه بعد، آن شناسه را به صورت previousSnapshotId ارسال کنید. رکوردهای upsert را با اضافه کردن یا به‌روزرسانی دستگاه اعمال کنید؛ رکوردهای مشخص شده با deleted را که مقدار دستگاه آنها null است، حذف کنید. هر صفحه را برای اعمال مجدد ایمن کنید. چک‌پوینت قدیمی خود را تا زمانی که کل به‌روزرسانی با موفقیت انجام شود، نگه دارید.

  3. در صورت نیاز دوباره شروع کنید

    اگر چک‌پوینت با ۴۱۰ منقضی شد، یک اسنپ‌شات کامل جدید بگیرید و آن را با داده‌های ذخیره شده خود مقایسه کنید. اسنپ‌شات‌ها متعلق به اعتبارنامه‌ای هستند که آنها را ایجاد کرده است، بنابراین یک اعتبارنامه جایگزین به خط پایه خاص خود نیاز دارد.

  4. چک‌پوینت‌های جداگانه‌ای برای سایر داده‌ها نگه دارید.

    اسنپ‌شات‌های دستگاه حاوی خلاصه‌هایی هستند. موجودی دقیق، نرم‌افزار، هشدارها و فیلدهای سفارشی هر کدام از POST /v1/sync/{resource} استفاده می‌کنند و به چک‌پوینت مخصوص به خود نیاز دارند.

  5. محدودیت‌های اسنپ‌شات

    اسنپ‌شات‌ها پس از هفت روز منقضی می‌شوند و حداکثر ۱۰۰۰۰ دستگاه را در خود جای می‌دهند. هر اعتبارنامه می‌تواند در هر ساعت چهار اسنپ‌شات برای هر منبع و سازمان ایجاد کند؛ هر سازمان می‌تواند در مجموع بیست اسنپ‌شات در هر ساعت ایجاد کند. ذخیره‌سازی اسنپ‌شات فشرده به ۲۵۶ MiB برای هر سازمان محدود می‌شود.

مرجع API →

بازنگری محتوا 3f225a253 · OpenAPI SHA-256: b12c42306a89