RemoteGymp · API v1

Mantenha uma cópia sincronizada

Copie sua lista de dispositivos para outro sistema e, em seguida, busque apenas o que foi alterado.

  1. Capture um instantâneo completo

    Chame POST /v1/sync/devices com previousSnapshotId definido como null. Leia GET /v1/sync/devices/{snapshotId}, passando cada valor de next como after, até que next seja null.

  2. Salve seu ponto de verificação após cada página ser concluída com sucesso.

    Aplique cada página e salve o ID do instantâneo. Na próxima vez, envie esse ID como previousSnapshotId. Aplique os registros upsert adicionando ou atualizando o dispositivo; remova os registros marcados como deleted, cujo valor do dispositivo é null. Torne cada página segura para reaplicação. Mantenha seu ponto de verificação antigo até que a atualização seja concluída com sucesso.

  3. Recomece quando necessário

    Se o ponto de verificação expirar com o código 410, faça um novo snapshot completo e compare-o com seus dados salvos. Os snapshots pertencem à credencial que os criou; portanto, uma credencial de substituição precisa de sua própria linha de base.

  4. Mantenha pontos de verificação separados para outros dados

    Os snapshots de dispositivos contêm resumos. Inventário detalhado, software, alertas e campos personalizados usam POST e /v1/sync/{resource} e precisam de seus próprios pontos de verificação.

  5. Limites de snapshots

    Os snapshots expiram após sete dias e armazenam no máximo 10.000 dispositivos. Cada credencial pode criar quatro snapshots por recurso e organização por hora; cada organização pode criar um total de vinte por hora. O armazenamento de snapshots compactados é limitado a 256 MiB por organização.

Referência da API →

Revisão de conteúdo 3f225a253 · OpenAPI SHA-256: b12c42306a89