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á.
# Usar expressões cron no Image Builder
Use expressões cron no EC2 Image Builder para configurar uma janela de tempo para atualizar sua imagem com atualizações que se aplicam à imagem base e aos componentes do seu pipeline. A janela de tempo para a atualização do pipeline começa com a hora definida na expressão cron. Você pode definir a hora em sua expressão cron até o minuto. A construção do seu pipeline pode ser executada durante ou após o horário de início.
Às vezes, pode levar alguns segundos ou até um minuto para que sua compilação comece a ser executada.
**nota**
As expressões cron usam o fuso horário Tempo Universal Coordenado (UTC) por padrão, ou você pode especificar o fuso horário. Para obter mais informações sobre o horário UTC e encontrar a diferença do seu fuso horário, consulte [Time Zone Abbreviations, Worldwide List](https://www.timeanddate.com/time/zones/) (Abreviações de fuso horário: lista mundial).
## Valores compatíveis com expressões cron no Image Builder
EC2 O Image Builder usa um formato cron que consiste em seis campos obrigatórios. Cada um é separado dos outros por um espaço intermediário, sem espaços à esquerda ou à direita:
` `
A tabela a seguir mostra os valores compatíveis com as entradas cron necessárias.
**Valores compatíveis com expressões cron**
| Campo | Valores | Curingas |
| --- | --- | --- |
| Minuto | 0-59 | , - \$1 / |
| Hora | 0-23 | , - \$1 / |
| Dia | 1-31 | , - \$1 ? / L W |
| Mês | 1-12 ou jan-dec | , - \$1 / |
| Dia da semana | 1-7 ou sun-sat | , - \$1 ? L \$1 |
| Ano | 1970-2199 | , - \$1 / |
**Curingas**
A tabela a seguir descreve como o Image Builder usa curingas para expressões cron. Lembre-se de que pode levar até um minuto após o horário especificado para que a compilação seja iniciada.
**Curingas compatíveis com expressões cron**
| Curinga | Descrição |
| --- | --- |
| , | A , (vírgula) curinga inclui valores adicionais. No campo mês, jan,feb,mar inclui janeiro, fevereiro e março. |
| - | O - (traço) curinga especifica intervalos. Em dia do campo mês, 1-15 inclui dias 1 a 15 do mês especificado. |
| \$1 | O \$1 (asterisco) curinga inclui todos os valores válidos para o campo. |
| ? | O curinga ? (interrogação) especifica que o valor do campo depende de outra configuração. No caso do Dia e dos Day-of-week campos, quando um é especificado ou inclui todos os valores possíveis (\$1), o outro deve ser ? a. Não é possível especificar ambos. Por exemplo, se você inserir a 7 no campo Dia (executar a construção no sétimo dia do mês), a Day-of-week posição deverá conter ? a. |
| / | A / (barra) curinga especifica incrementos. Por exemplo, se você quiser que sua compilação seja executada a cada dois dias, insira \$1/2 o campo dia. |
| L | O curinga L em qualquer um dos campos do dia especifica o último dia: 28 a 31 para o dia do mês, dependendo do mês, ou domingo, para o dia da semana. |
| W | O curinga W no campo Day-of-month especifica um dia da semana. No Day-of-month campo, se você inserir um número antes doW, isso significa que você deseja segmentar o dia da semana mais próximo desse dia. Por exemplo, se você especificar3W, deseja que sua compilação seja executada no dia da semana mais próximo ao terceiro dia do mês. |
| \$1 | O \$1 (hash) é permitido somente para o campo do dia da semana e deve ser seguido por um número entre 1 e 5. O número especifica quais semanas em um determinado mês se aplicam à execução da compilação. Por exemplo, se você quiser que sua compilação seja executada na segunda sexta-feira de cada mês, use fri\$12 para o campo dia da semana. |
**Restrições**
+ Não é possível especificar os campos Day-of-month e Day-of-week na mesma expressão cron. Se você especificar um valor ou `*` em um dos campos, deverá usar um `?` (ponto de interrogação) no outro.
+ Não há suporte para expressões Cron que causam taxas mais rápidas que um minuto.
## Exemplos de expressões cron no Image Builder
As expressões cron são inseridas de forma diferente no console do Image Builder e na API ou na CLI. Para ver exemplos, escolha a guia que se aplica a você.
------
#### [ Image Builder console ]
Os exemplos a seguir mostram expressões cron que você pode inserir no console para sua agenda de compilação. O horário UTC é especificado usando um relógio de 24 horas.
**Executada diariamente às 10h (UTC)**
`0 10 * * ? *`
**Corra diariamente às 12h15 (UTC)**
`15 12 * * ? *`
**Executar diariamente à meia-noite (UTC)**
`0 0 * * ? *`
**Executada às 10h (UTC) todas as manhãs dos dias da semana**
`0 10 ? * 2-6 *`
**Executada às 18h (UTC) todas as noites da semana**
`0 18 ? * mon-fri *`
**Executar às 8h (UTC) todo o primeiro dia do mês**
`0 8 1 * ? *`
**Execute na segunda terça-feira de cada mês às 22h30 (UTC)**
`30 22 ? * tue#2 *`
**dica**
Se você não quiser que seu trabalho de pipeline se estenda até o dia seguinte enquanto estiver em execução, lembre-se de levar em consideração o tempo de sua compilação ao especificar o horário de início.
------
#### [ API/CLI ]
Os exemplos a seguir mostram expressões cron que você pode inserir usando comandos CLI ou solicitações de API para sua agenda de compilação. Somente a expressão cron é mostrada.
**Executada diariamente às 10h (UTC)**
`cron(0 10 * * ? *)`
**Corra diariamente às 12h15 (UTC)**
`cron(15 12 * * ? *)`
**Executar diariamente à meia-noite (UTC)**
`cron(0 0 * * ? *)`
**Executada às 10h (UTC) todas as manhãs dos dias da semana**
`cron(0 10 ? * 2-6 *)`
**Executada às 18h (UTC) todas as noites da semana**
`cron(0 18 ? * mon-fri *)`
**Executar às 8h (UTC) todo o primeiro dia do mês**
`cron(0 8 1 * ? *)`
**Execute na segunda terça-feira de cada mês às 22h30 (UTC)**
`cron(30 22 ? * tue#2 *)`
**dica**
Se você não quiser que seu trabalho de pipeline se estenda até o dia seguinte enquanto estiver em execução, lembre-se de levar em consideração o tempo de sua compilação ao especificar o horário de início.
------
## Expressões rate no Image Builder
Uma expressão rate começa quando você cria a regra de evento programado e, em seguida, a executa em sua programação definida.
As expressões rate têm dois campos obrigatórios. Os campos são 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
**Restrições**
Se o valor for igual a `1`, a unidade deverá ser singular. Da mesma forma, para valores maiores do que `1`, a unidade deve ser plural. Por exemplo, `rate(1 hours)` e `rate(5 hour)` não são válidos, mas `rate(1 hour)` e `rate(5 hours)` são.