Bloqueio para manutenção, backup e limpeza
O bloqueio para manutenção é usado em operações que exigem suspender gravações, como restauração de configurações, evitando alterações contínuas nas configurações de negócio e nos controles durante a restauração.
Bloqueio para manutenção
Seção intitulada “Bloqueio para manutenção”A sequência de estados é OFF → ENTERING → ACTIVE → EXITING → OFF. A entrada e a saída podem exigir espera; considere o resultado da consulta de estado como referência.
Durante o bloqueio, gravações protegidas de configuração e controle são recusadas com o código de negócio 200162. Use as interfaces atuais de entrada e saída, e não as interfaces removidas de Capability ou saída em etapas.
| Operação | Interface |
|---|---|
| Consultar estado | GET /maintenance/state |
| Entrar no bloqueio | POST /maintenance/enter |
| Sair do bloqueio | POST /maintenance/exit |
Backup e restauração
Seção intitulada “Backup e restauração”- Use o backup de configuração para salvar as definições atuais.
- Entre no bloqueio para manutenção e envie um arquivo de backup compatível com a versão.
- Confira o resultado da restauração e a reconstrução do cache; após confirmar, saia do bloqueio.
- Se precisar sincronizar templates, execute depois a reconciliação dos tipos ou instâncias UDE especificados.
POST /ems-data/backup baixa o backup de configuração; POST /ems-data/restore recebe o arquivo pelo campo file de uma solicitação multipart. O backup salva os itens de seu manifesto e não equivale a uma imagem completa do dispositivo. Confira se planos de arquivamento, metadados de execução e outros itens estão incluídos no escopo do seu backup.
Limpeza por categoria
Seção intitulada “Limpeza por categoria”A limpeza em lote pode tratar dados e configurações por categoria e reconstruir os caches correspondentes. A limpeza de dados originais ou compartilhados também pode afetar configurações e mapeamentos de grupos; a limpeza UDE inclui regras e listas de artefatos gerados.
Confirme as categorias selecionadas e suas referências antes de chamar POST /ems-data/batch/clear. Cada categoria é executada separadamente; sucessos parciais não são revertidos se outra categoria falhar. Verifique os resultados individualmente.
Para obter dados pontualmente, use Exportação do histórico; para retenção de longo prazo, Arquivamento periódico. Para entender quando os parâmetros entram em vigor, consulte Configurações de execução.