Agendamentos · Documentação da Ephemeral

Um agendamento inicia um fluxo de trabalho salvo conforme uma programação, com a mesma entrada e o mesmo orçamento a cada vez. Cada início é uma execução comum: registrada, cobrada e destruída como uma que você iniciasse por conta própria.

Um agendamento

Um agendamento indica um fluxo de trabalho, uma programação em sintaxe cron e um fuso horário, além da entrada e do orçamento de cada execução. Por exemplo, todo dia útil às 09:00 em Tóquio, buscar os novos clientes de ontem e enviar a cada um um e-mail de boas-vindas por meio de uma conexão:

POST /v1/schedules

{
  "workflow": "welcome-new-customers",
  "name": "Weekday welcome emails",
  "cron": "0 9 * * 1-5",
  "timezone": "Asia/Tokyo",
  "input": { "signed_up": "yesterday" },
  "max_cost_micros": 200000
}

O painel monta a programação para você em Agendamentos: a cada alguns minutos, de hora em hora, diariamente em um ou mais horários, em dias da semana ou do mês escolhidos, ou qualquer expressão cron. Ele mostra os próximos horários de início antes de você salvar.

Programações

Uma programação tem cinco campos: minuto, hora, dia do mês, mês e dia da semana. Cada um aceita um valor, uma lista (1,15), um intervalo (1-5), um passo (*/15) ou *. Os atalhos também funcionam.

Programação	Inicia
`/15 * * *`	A cada 15 minutos.
`0 * * * *`	A cada hora, em ponto.
`30 8,17 * * *`	Todos os dias às 08:30 e às 17:30.
`0 9 * * 1-5`	Nos dias úteis às 09:00.
`0 6 1 * *`	No dia 1º de cada mês às 06:00.
`@daily`	Todos os dias à meia-noite. Também @hourly, @weekly e @monthly.
`@every 90m`	A cada 90 minutos, contados a partir do momento em que o agendamento é salvo.

Os horários são interpretados no timezone do agendamento, um nome IANA como Europe/Madrid, de modo que um agendamento às 09:00 continua às 09:00 nas mudanças de horário de verão. Os agendamentos iniciam no máximo uma vez por minuto.

Como funcionam os inícios

O Ephemeral verifica a cada poucos segundos se há agendamentos pendentes e inicia cada um como se você tivesse chamado POST /v1/runs com o fluxo de trabalho, a entrada e o orçamento. A execução registra qual agendamento a iniciou.
Cada horário de início executa uma única vez. Se o Ephemeral estava indisponível quando havia inícios pendentes, o agendamento executa uma vez quando ele voltar e depois retoma a programação.
Por padrão, um início é ignorado enquanto a execução anterior do agendamento ainda está em andamento, e o agendamento registra isso. Defina skip_if_running como false para permitir que as execuções se sobreponham.
Se um início falhar, por exemplo porque o fluxo de trabalho foi excluído ou não há créditos suficientes, o agendamento registra o motivo e tenta de novo no horário seguinte. Depois de cinco inícios com falha seguidos, ele é pausado; reativá-lo zera a contagem.

As execuções agendadas gastam créditos por conta própria

Cada início reserva o orçamento da execução a partir dos créditos da sua organização, como qualquer execução. Somente proprietários e administradores podem criar, alterar ou excluir agendamentos; os membros podem vê-los e iniciar um imediatamente.

Acompanhando as execuções agendadas

As execuções agendadas aparecem junto com as suas outras execuções e trazem um schedule_id. Liste as execuções de um agendamento com GET /v1/runs?schedule={id}. Os agendamentos não enviam callbacks; para agir sobre o resultado, faça o fluxo de trabalho cuidar disso por meio de uma conexão ou consulte as execuções do agendamento.

Uma organização pode ter até 50 agendamentos. Veja a API de agendamentos para todos os campos.