O que é um agendamento?
Um agendamento é um gatilho baseado em cron vinculado a um contexto. Quando dispara, o Matcher lança uma execução de reconciliação para aquele contexto usando suas regras e fontes ativas.
Ciclo de vida do agendamento
Agendamentos suportam um ciclo de vida CRUD completo em
/v1/contexts/{contextId}/schedules.
Criando um agendamento
Forneça uma
cronExpression; enabled assume o valor ativo por padrão quando omitido.
cURL
String
obrigatório
Expressão cron que define a frequência de execução (1–100 caracteres), com pelo menos cinco minutos entre disparos. Agendamentos por minuto e subminuto são rejeitados
Boolean
Se o agendamento fica ativo imediatamente
id, nextRunAt e timestamps. A listagem de agendamentos (GET) retorna todos os agendamentos do contexto, habilitados e desabilitados igualmente.
Pausar vs. excluir um agendamento
Quando você precisa parar uma reconciliação recorrente, tem duas opções — e a escolha importa. Desabilite o agendamento para pausar as execuções automáticas mantendo sua configuração e histórico. Reabilitar depois é uma única chamada, sem necessidade de recriá-lo. Atualize a expressão cron, alterne
enabled ou ambos (os campos omitidos permanecem inalterados):
cURL
DELETE .../schedules/{scheduleId}) apenas quando a cadência acabou de vez — a exclusão é permanente. Para simplesmente fazer uma pausa, desabilite em vez disso.
Boas práticas
Alinhe a cadência com a disponibilidade das fontes
Alinhe a cadência com a disponibilidade das fontes
Agende as execuções para dispararem depois que todas as fontes do contexto tiverem entregue seus dados do período. Executar antes de a ingestão concluir produz exceções evitáveis.
Prefira desabilitar a excluir
Prefira desabilitar a excluir
Ao pausar uma cadência de reconciliação, desabilite o agendamento para que histórico e configuração sejam preservados e reabilitar seja uma única chamada.
Use expressões cron explícitas
Use expressões cron explícitas
Mantenha as expressões cron legíveis e documentadas (por exemplo,
0 0 * * * = diariamente às 00:00). Verifique as premissas de fuso horário do seu ambiente antes de depender de um agendamento para execuções sensíveis a SLA.Próximos passos
Contextos e Fontes
Configure os contextos e as fontes que um agendamento reconcilia.
Gerando Relatórios
Revise os resultados produzidos pelas execuções agendadas.