RemoteGymp · API v1

Mantenga una copia sincronizada.

Copie su lista de dispositivos en otro sistema y, a continuación, obtenga solo los que hayan cambiado.

  1. Tomar una instantánea completa

    Llamar a POST /v1/sync/devices con previousSnapshotId establecido en null. Leer GET /v1/sync/devices/{snapshotId}, pasando cada valor de next como after, hasta que next sea null.

  2. Guardar el punto de control después de que cada página se procese correctamente.

    Aplicar cada página y luego guardar el ID de la instantánea. La próxima vez, enviar ese ID como previousSnapshotId. Aplicar los registros upsert agregando o actualizando el dispositivo; eliminar los registros marcados con deleted, cuyo valor de dispositivo sea null. Asegúrese de que cada página sea segura para volver a aplicarla. Conserve su punto de control anterior hasta que la actualización se complete correctamente.

  3. Reinicie cuando sea necesario.

    Si el punto de control caduca con el código 410, cree una nueva instantánea completa y compárela con sus datos guardados. Las instantáneas pertenecen a la credencial que las creó, por lo que una credencial de reemplazo necesita su propia línea base.

  4. Mantenga puntos de control separados para otros datos.

    Las instantáneas de dispositivos contienen resúmenes. El inventario detallado, el software, las alertas y los campos personalizados utilizan POST /v1/sync/{resource} y necesitan su propio punto de control.

  5. Límites de instantáneas

    Las instantáneas caducan después de siete días y almacenan un máximo de 10 000 dispositivos. Cada credencial puede crear cuatro instantáneas por recurso y organización por hora; cada organización puede crear veinte en total por hora. El almacenamiento de instantáneas comprimidas está limitado a 256 MiB por organización.

Referencia de API →

Revisión de contenido 3f225a253 · OpenAPI SHA-256: b12c42306a89