Agendamento

Você define quando uma integração executa na seção Geral e Agendamento, ao criar ou editar a integração. Escolha a frequência de execução e preencha os detalhes, como o horário do dia, e pronto. Não é preciso escrever nenhuma expressão especial.

​

Escolhendo uma frequência

Escolha com que frequência a integração deve executar. Dependendo da sua escolha, o formulário mostra as opções correspondentes:

​

O campo de horário

Digite o horário apenas com números e o campo formata para você:

• Os dois-pontos são inseridos automaticamente.
• Horas com um único dígito ganham o zero à esquerda: digitar 9 vira 09:.
• Valores colados funcionam com ou sem separador (0930 e 09:30 são aceitos).
• Dígitos que não formam um horário válido simplesmente não são aceitos.

Se um horário ou intervalo for inválido, uma mensagem de erro aparece em vez de o valor voltar silenciosamente ao que era antes.

​

Trocando de frequência

Suas escolhas são lembradas enquanto você edita. Se você escolher um horário em Diária, trocar para A cada hora para comparar e voltar para Diária, o horário continua lá. O mesmo vale para dias selecionados e intervalos.

​

Expressões avançadas

Se as opções de frequência não expressam o agendamento que você precisa, clique em Mostrar avançado para digitar a expressão de agendamento diretamente. Dois formatos são suportados. Enquanto você digita, o campo valida a expressão e mostra uma mensagem de erro clara quando algo está errado. O erro mais comum é até corrigido automaticamente: rate(1 days) se corrige para rate(1 day), e rate(5 day) para rate(5 days). A validação existe para ajudar: ela nunca impede o salvamento. Ao editar uma integração cujo agendamento foi escrito como expressão avançada, a seção avançada abre automaticamente para que o agendamento fique visível de imediato.

​

Expressões rate

Expressões rate definem com que frequência uma integração deve ser executada usando intervalos de tempo simples, no formato rate(value unit). Exemplos:

• rate(1 day) - Executar uma vez por dia
• rate(7 days) - Executar uma vez por semana

​

Expressões cron

Expressões cron fornecem controle preciso sobre quando as integrações são executadas, permitindo especificar horários exatos, dias da semana ou datas usando a expressão cron do AWS EventBridge. A expressão tem seis campos: minuto, hora, dia-do-mês, mês, dia-da-semana e ano. Formato: cron(minute hour day-of-month month day-of-week year) Exemplo: cron(15 3 ? * * *): executa todos os dias às 3:15 AM. Para um guia completo sobre a sintaxe e diferenças entre a expressão cron normal e a expressão cron do AWS EventBridge, consulte a documentação de cron do AWS EventBridge.

​

Executar agora

Além do agendamento, você pode disparar uma execução a qualquer momento.

​

Pela página de edição

Abra a integração e clique em Executar agora, ao lado do botão Salvar. Um diálogo de confirmação sempre aparece antes de qualquer execução. Isso funciona mesmo se a integração estiver desabilitada (útil para testar sem ligar o agendamento).

• Se houver alterações não salvas, o diálogo avisa e a ação vira Salvar e executar: suas alterações são salvas primeiro e então a execução começa. Se o salvamento falhar, nada é executado.
• Para integrações webhook, o diálogo pede o payload JSON que o webhook receberia. Ele vem preenchido com o corpo de exemplo do preview (se você tiver informado um) ou com o último payload usado nessa integração.
• Em caso de sucesso, você verá a mensagem Execução iniciada; se a execução não puder ser iniciada, o motivo é mostrado dentro do diálogo.

​

Pela página de status da integração

Em workspaces com a página de status da integração, o botão Executar agora também está disponível lá. Como essa página é somente leitura, não há nada para salvar: após a confirmação, a execução sempre começa diretamente.