RemoteGymp · API v1

Giữ một bản sao được đồng bộ hóa

Sao chép danh sách thiết bị của bạn vào một hệ thống khác, sau đó chỉ lấy những gì đã thay đổi.

  1. Chụp ảnh toàn bộ

    Gọi POST /v1/sync/devices với previousSnapshotId được đặt thành null. Đọc GET /v1/sync/devices/{snapshotId}, truyền từng giá trị next làm after, cho đến khi next là null.

  2. Lưu điểm kiểm tra sau mỗi trang thành công

    Áp dụng mọi trang, sau đó lưu ID ảnh chụp. Lần sau, gửi ID đó làm previousSnapshotId. Áp dụng các bản ghi upsert bằng cách thêm hoặc cập nhật thiết bị; xóa các bản ghi được đánh dấu deleted, có giá trị thiết bị là null. Đảm bảo mỗi trang an toàn để áp dụng lại. Giữ nguyên điểm kiểm tra cũ cho đến khi toàn bộ quá trình cập nhật thành công.

  3. Bắt đầu lại khi cần

    Nếu điểm kiểm tra hết hạn với mã lỗi 410, hãy tạo ảnh chụp nhanh đầy đủ mới và so sánh với dữ liệu đã lưu. Ảnh chụp nhanh thuộc về thông tin xác thực đã tạo ra chúng, vì vậy thông tin xác thực thay thế cần có điểm cơ sở riêng.

  4. Giữ các điểm kiểm tra riêng biệt cho các dữ liệu khác

    Ảnh chụp nhanh thiết bị chứa các bản tóm tắt. Thông tin chi tiết về kho dữ liệu, phần mềm, cảnh báo và các trường tùy chỉnh đều sử dụng POST /v1/sync/{resource} và cần điểm kiểm tra riêng.

  5. Giới hạn ảnh chụp nhanh

    Ảnh chụp nhanh hết hạn sau bảy ngày và lưu trữ tối đa 10.000 thiết bị. Mỗi thông tin xác thực có thể tạo bốn ảnh chụp nhanh cho mỗi tài nguyên và tổ chức mỗi giờ; Mỗi tổ chức có thể tạo tổng cộng hai mươi bản ghi mỗi giờ. Dung lượng lưu trữ ảnh chụp nhanh nén bị giới hạn ở 256 bản ghi MiB cho mỗi tổ chức.

Tham khảo API →

3f225a253 sửa đổi nội dung · OpenAPI SHA-256: b12c42306a89