As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Definindo um padrão de programação para regras programadas (antigas) na Amazon EventBridge **nota** As regras programadas são um recurso antigo do EventBridge. EventBridgeoferece uma maneira mais flexível e poderosa de criar, executar e gerenciar tarefas agendadas centralmente, em grande escala: EventBridge Scheduler. Com o EventBridge Scheduler, você pode criar agendas usando expressões cron e rate para padrões recorrentes ou configurar invocações únicas. Você pode configurar janelas de tempo flexíveis para entregas, definir limites de novas tentativas e o tempo máximo de retenção de invocações de API com falha. O Scheduler é altamente personalizável e oferece escalabilidade aprimorada em relação às regras programadas, com um conjunto mais amplo de operações e serviços de API de destino. AWS Recomendamos que você use o Agendador para invocar destinos em uma programação. Para obter mais informações, consulte [Criar uma programação](using-eventbridge-scheduler.md#using-eventbridge-scheduler-create) o *[Guia do usuário do EventBridge Scheduler](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)*. Ao criar uma regra programada em, EventBridge você pode especificar um padrão de agendamento que determina quando a regra EventBridge é executada: + Use uma expressão *cron* para executar a regra em horários e datas específicos. + Use uma expressão *rate* para executar a regra em intervalos regulares. ## Expressão cron Expressões cron têm seis campos obrigatórios, que são separados por um espaço em branco. **Sintaxe** ``` cron(fields) ``` | **Campo** | **Valores** | **Curingas** | | --- | --- | --- | | minutos | 0-59 | , - \$1 / | | Horas | 0-23 | , - \$1 / | | D ay-of-month | 1-31 | , - \$1 ? / L W | | Mês | 1-12 ou JAN-DEZ | , - \$1 / | | D ay-of-week | 1-7 ou DOM-SÁB | , - \$1 ? L \$1 | | Ano | 1970-2199 | , - \$1 / | **Curingas** + A **,** (vírgula) curinga inclui valores adicionais. No campo Mês, JAN, FEV, MAR inclui janeiro, fevereiro e março. + O **-** (traço) curinga especifica intervalos. No campo Dia, 1-15 inclui os dias 1 a 15 do mês especificado. + O **\$1** (asterisco) curinga inclui todos os valores no campo. No campo Hours (Horas), **\$1** inclui todas as horas. Você não pode usar **\$1** nos Day-of-week campos Day-of-month e. Se você usá-lo em um deles, utilize **?** no outro. + A **/** (barra) curinga especifica incrementos. No campo Minutos, você pode inserir 1/10 para especificar cada décimo minuto a partir do primeiro minuto da hora (por exemplo, o 11º, 21º e 31º minuto, etc.). + O curinga **?** (interrogação) especifica qualquer um. No Day-of-month campo você poderia inserir **7** e se algum dia da semana fosse aceitável, você poderia inserir**?** no Day-of-week campo. + O curinga **L** nos campos Day-of-month ou Day-of-week especifica o último dia do mês ou da semana. + O **W** curinga no Day-of-month campo especifica um dia da semana. No Day-of-month campo, **3W** especifica o dia da semana mais próximo do terceiro dia do mês. + O caractere curinga **\$1** no Day-of-week campo especifica uma determinada instância do dia da semana especificado em um mês. Por exemplo, 3\$12 seria a segunda terça-feira do mês: o 3 refere-se a terça-feira, porque é o terceiro dia de cada semana, e o 2 refere-se ao segundo dia desse tipo dentro do mês. **nota** Se você usar um caractere '\$1', poderá definir somente uma expressão no day-of-week campo. Por exemplo, o valor `"3#1,6#3"` não é válido porque é interpretado como duas expressões. **Limitações** + Não é possível especificar os campos Day-of-month e Day-of-week na mesma expressão cron. Se especificar um valor ou \$1 (asterisco) em um dos campos, deverá usar **?** (ponto de interrogação) no outro. + As expressões cron que levam a taxas mais rápidas do que 1 minuto não têm suporte. **Exemplos** Você pode usar as seguintes sequências de caracteres cron de exemplo ao criar uma regra com programação. | Minutos | Horas | Dia do mês | Mês | Dia da semana | Ano | Significado | | --- | --- | --- | --- | --- | --- | --- | | 0 | 10 | \$1 | \$1 | ? | \$1 | Executada às 10h00 (UTC\$10) todos os dias | | 15 | 12 | \$1 | \$1 | ? | \$1 | Executada às 12h15 (UTC\$10) todos os dias | | 0 | 18 | ? | \$1 | SEG-SEX | \$1 | Executada às 18h (UTC\$10) de segunda a sexta | | 0 | 8 | 1 | \$1 | ? | \$1 | Executada às 8h (UTC\$10) todo primeiro dia do mês | | 0/15 | \$1 | \$1 | \$1 | ? | \$1 | Executada a cada 15 minutos | | 0/10 | \$1 | ? | \$1 | SEG-SEX | \$1 | Executada a cada 10 minutos de segunda a sexta | | 0/5 | 8-17 | ? | \$1 | SEG-SEX | \$1 | Executada a cada cinco minutos, de segunda a sexta, entre 8h e 17h55 (UTC\$10) | | 0/30 | 20-2 | ? | \$1 | SEG-SEX | \$1 | Executada a cada 30 minutos, de segunda a sexta-feira, das 22h do dia inicial às 2h do dia seguinte (UTC) Executada das 12h às 2h na manhã de segunda-feira (UTC). | O seguinte exemplo cria uma regra que é executada todos os dias às 12h UTC\$10. ``` aws events put-rule --schedule-expression "cron(0 12 * * ? *)" --name MyRule1 ``` O seguinte exemplo cria uma regra que é executada todos os dias, às 14h05 e 14h35 UTC\$10. ``` aws events put-rule --schedule-expression "cron(5,35 14 * * ? *)" --name MyRule2 ``` O exemplo a seguir cria uma regra executada às 10h15 UTC\$10 na última sexta-feira de cada mês durante os anos de 2019 a 2022. ``` aws events put-rule --schedule-expression "cron(15 10 ? * 6L 2019-2022)" --name MyRule3 ``` ## Expressões rate Uma *expressão rate* começa quando a regra de evento programado é criada e é executada em uma programação definida. As expressões rate têm dois campos obrigatórios separados por um espaço em branco. **Sintaxe** ``` rate(value unit) ``` valor Um número positivo. unidade A unidade de tempo. Diferentes unidades são necessárias para valores de 1, como `minute`, e valores acima de 1, como `minutes`. Valores válidos: minuto \$1 minutos \$1 hora \$1 horas \$1 dia \$1 dias **Limitações** Se o valor for igual a 1, a unidade deverá ser singular. Se o valor for maior que 1, a unidade deverá ser plural. Por exemplo, as taxas (uma hora) e (cinco horas) não são válidas, mas as taxas (uma hora) e (cinco horas) são válidas. **Exemplos** Os exemplos a seguir mostram como usar expressões de taxa com o AWS CLI `put-rule` comando. O primeiro exemplo aciona a regra a cada minuto, o segundo exemplo aciona a regra a cada cinco minutos, o próximo a aciona uma vez por hora e o terceiro exemplo a aciona uma vez por dia. ``` aws events put-rule --schedule-expression "rate(1 minute)" --name MyRule2 ``` ``` aws events put-rule --schedule-expression "rate(5 minutes)" --name MyRule3 ``` ``` aws events put-rule --schedule-expression "rate(1 hour)" --name MyRule4 ``` ``` aws events put-rule --schedule-expression "rate(1 day)" --name MyRule5 ```