Programe expressões nas alternâncias do Secrets Manager - AWS Secrets Manager

Programe expressões nas alternâncias do Secrets Manager

Quando você ativa a alternância automática, é possível usar uma expressão cron() ou rate() para definir o cronograma para a alternância do seu segredo. Com uma expressão de taxa, você pode criar uma programação de alternância que se repetirá em um intervalo de dias. Com uma expressão cron, você pode criar programações de alternância mais detalhadas do que um intervalo de alternância. Os horários de alternância do Secrets Manager usam o fuso horário UTC.

O Secrets Manager alterna o seu segredo a qualquer momento durante uma janela de alternância. Para uma expressão rate(), a janela de alternância começará automaticamente à 0h. Para uma expressão cron(), a janela de alternância será aberta no horário que você especificar. Por padrão, a janela de alternância fecha ao final do dia. É possível definir uma duração de janela para encurtar a janela de alternância. A janela de alternância não deve ir até o próximo dia UTC ou, em outras palavras, a hora de início mais a duração da janela deve ser menor ou igual a 24 horas.

Para ativar a alternância, consulte:

Expressões rate

As expressões de taxa do Secrets Manager têm o formato a seguir, em que Value (Valor) é um número inteiro positivo e Unit (Unidade) pode ser day ou days:

rate(Value Unit)

Por exemplo, rate(8 days) significa que o segredo é alternado a cada oito dias.

Expressões do cron

As expressões cron têm o formato a seguir:

cron(Minutes Hours Day-of-month Month Day-of-week Year)
Campos Valores Wildcards (Curingas)

Minutos

Deve ser 0

Horas

0–23

Dia do mês

1 – 31

, - * ? / L

Mês

1-12 ou JAN-DEZ

, - * /

Dia da semana

1-7 ou DOM-SÁB

# , - * ? / L

Ano

Deve ser *

Uma expressão cron para o Secrets Manager deve ter 0 no campo de minutos porque as janelas de alternância do Secrets Manager abrem no horário indicado. É necessário que um * esteja no campo de ano, porque o Secrets Manager não oferece suporte a cronogramas de alternância com mais de um ano de intervalo.

Curingas:

  • O * (asterisco) curinga inclui todos os valores no campo. No campo Days, * significa todos os dias.

  • A , (vírgula) curinga inclui valores adicionais. No campo Month, JAN,APR,JUL,OCT significa janeiro, abril, julho e outubro.

  • O - (traço) curinga especifica intervalos. No campo Day, 1–15 significa os dias 1 a 15 do mês especificado.

  • A / (barra) curinga especifica incrementos. No campo Days, 1/10 significa a cada dez dias.

  • O curinga ? (interrogação) especifica um ou outro. Não é possível especificar os campos Day-of-month e Day-of-week na mesma expressão cron. Se você especificar um valor em um dos campos, deverá usar um ? (ponto de interrogação) no outro.

  • O curinga L nos campos Day-of-month ou Day-of-week especifica o último dia do mês ou da semana. Em Day-of-month, você também pode especificar o último dia nomeado do mês. Por exemplo, SUNL significa o último domingo do mês.

  • O curinga # no campo Day-of-week especifica um dia da semana de um mês. Por exemplo, TUE#3 significa a terceira terça-feira do mês.

Exemplos

Programação (UTC) Expressão

Todos os dias às 10h.

cron(0 10 * * ? *)

Todos os sábados às 18h.

cron(0 18 ? * SAT *)

O primeiro dia de cada mês, às 8h.

cron(0 8 1 * ? *)

A cada três meses, no primeiro domingo, à 1 hora da manhã.

cron(0 1 ? 1/3 SUN#1 *)

O último dia de cada mês, às 17h.

cron(0 17 L * ? *)

De segunda-feira a sexta-feira, às 8h.

cron(0 8 ? * MON-FRI *)

Primeiro e 15.º dia de cada mês às 16h.

cron(0 16 1,15 * ? *)

Primeiro domingo de cada mês à 0h.

cron(0 0 ? * SUN#1 *)