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á.

# Programação de alternância
<a name="rotate-secrets_schedule"></a>

O Secrets Manager faz a alternância do seu segredo em uma programação durante uma janela de alternância definida por você. Para definir a programação e a janela, use uma expressão **cron()** ou **rate()** junto com a duração da janela. O Secrets Manager alterna seu segredo a qualquer momento durante a janela de alternância. É possível alternar um segredo com intervalos a partir de quatro horas em uma janela de alternância. 

Para ativar a alternância, consulte:
+ [Rotação gerenciada para AWS Secrets Manager segredos](rotate-secrets_managed.md)
+ [Configure a alternância automática para segredos do Amazon RDS, do Amazon Aurora, do Amazon Redshift ou do Amazon DocumentDB](rotate-secrets_turn-on-for-db.md)
+ [Configure a rotação automática para segredos que não sejam do banco de dados AWS Secrets Manager](rotate-secrets_turn-on-for-other.md)

Os horários de alternância do Secrets Manager usam o fuso horário UTC.

## Janelas de alternância
<a name="rotate-secrets_rotation-windows"></a>

A janela de alternância do Secrets Manager é semelhante a uma janela de manutenção. Você define a janela de alternância quando deseja alternar seu segredo, e o Secrets Manager alterna seu segredo em algum momento durante a janela de alternância. 

As janelas de alternância do Secrets Manager sempre começam na hora. Para uma programação de alternância que use uma expressão `rate()` em dias, a janela de alternância começa à meia-noite. É possível definir a hora de início da janela de alternância usando uma expressão `cron()`. Para obter exemplos, consulte [Expressão cron](#rotate-secrets_schedule-cron). 

Por padrão, a janela de alternância fecha após uma hora para uma programação de alternância em *horas*, e no final do dia para uma programação de alternância em *dias*. 

Para alterar o comprimento da janela de alternância, defina a **Duração de janela**. É possível definir a janela de alternância tão pequena quanto uma hora. A janela de alternância não pode se estender até a próxima janela de alternância. Em outras palavras, para um cronograma de alternância em *horas*, confirme se a janela de alternância é menor ou igual ao número de horas entre as alternâncias. Para um cronograma de alternância em *dias*, confirme se o horário inicial somado à duração da janela é menor ou igual a 24 horas.

## Expressões rate
<a name="rotate-secrets_schedule-rate"></a>

As expressões de taxa do Secrets Manager têm o seguinte formato, onde {{Value}} é um número inteiro positivo e {{Unit}} pode ser`hour`,`hours`,`day`, ou`days`:

```
rate({{Value}} {{Unit}})
```

É possível alternar um segredo com intervalos a partir de quatro horas. O período máximo de alternância é de 999 dias. Exemplos:
+ `rate(4 hours)` significa que o segredo é alternado a cada 4 horas.
+ `rate(1 day)` significa que o segredo é alternado a cada dia.
+ `rate(10 days)` significa que o segredo é alternado a cada 10 dias.

## Expressão cron
<a name="rotate-secrets_schedule-cron"></a>

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

```
cron({{Minutes}} {{Hours}} {{Day-of-month}} {{Month}} {{Day-of-week}} {{Year}})
```

Uma expressão cron que inclui incrementos de redefinições de horas a cada dia. Por exemplo, `cron(0 4/12 * * ? *)` significa 4h, 16h e, no dia seguinte, 4h, 16h. Os horários de alternância do Secrets Manager usam o fuso horário UTC.


| Exemplo de programação | Expressão | 
| --- | --- | 
| A cada 8 horas a partir da meia-noite.  | `cron(0 /8 * * ? *)` | 
| A cada 8 horas a partir das 8h.  | `cron(0 8/8 * * ? *)` | 
| A cada 10 horas a partir das 2h.<br />As janelas de alternância começarão às 2h, 12h e 22h, e no dia seguinte, às 2h, 12h e 22h.  | `cron(0 2/10 * * ? *)` | 
| 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 *)` | 
| A partir de janeiro, a cada 11 meses na primeira segunda-feira à meia-noite. | `cron(0 0 ? 1/11 2#1 *)` | 

### Requisitos de expressão cron no Secrets Manager
<a name="rotate-secrets_schedule-cron-ASM"></a>

O Secrets Manager tem algumas restrições quanto ao que pode ser usado em expressões cron. Uma expressão cron para o Secrets Manager deve ter **0** no campo de minutos, pois as janelas de alternância do Secrets Manager começam na hora indicada. É 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. A tabela a seguir mostra as opções que você pode utilizar.


| **Campos** | **Valores** | **Curingas** | 
| --- | --- | --- | 
| Minutos | Deve ser 0 | Nenhum | 
| Horas | 0–23 | Use **/** (barra) para especificar incrementos. Por exemplo, `2/10` significa a cada 10 horas a partir das 2h. É possível alternar um segredo com intervalos a partir de quatro horas.  | 
| Day-of-month | 1–31 | Use **,** (vírgula) para incluir valores adicionais. Por exemplo, `1,15` significa o 1.º e o 15.º dia do mês.<br />Use **-** (traço) para especificar um intervalo. Por exemplo, `1–15` significa do dia 1 ao dia 15 do mês.<br />Use **\*** (asterisco) para incluir todos os valores no campo. Por exemplo, `*` significa todos os dias do mês.<br />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.<br />Use **/** (barra) para especificar incrementos. Por exemplo, `1/2` significa a cada 2 dias a partir do dia 1, ou seja, dia 1, 3, 5 e assim por diante.<br />Use **L** para especificar o último dia do mês.<br />Use **{{DAY}}L** para especificar o último dia nomeado do mês. Por exemplo, `SUNL` significa o último domingo do mês. | 
| Mês | 1-12 ou JAN-DEZ | Use **,** (vírgula) para incluir valores adicionais. Por exemplo, `JAN,APR,JUL,OCT` significa janeiro, abril, julho e outubro.<br />Use **-** (traço) para especificar um intervalo. Por exemplo, `1–3` significa do mês 1 ao mês 3 do ano.<br />Use **\*** (asterisco) para incluir todos os valores no campo. Por exemplo, `*` significa todos os meses.<br />Use **/** (barra) para especificar incrementos. Por exemplo, `1/3` significa a cada 3 meses, começando no mês 1, ou seja, mês 1, 4, 7 e 10. | 
| Day-of-week | 1-7 ou DOM-SÁB | Use **\#** para especificar o dia da semana em um mês. Por exemplo, `TUE#3` significa a terceira terça-feira do mês. <br />Use **,** (vírgula) para incluir valores adicionais. Por exemplo, `1,4` significa o 1.º e o 4.º dia da semana.<br />Use **-** (traço) para especificar um intervalo. Por exemplo, `1–4` significa do dia 1 ao dia 4 da semana.<br />Use **\*** (asterisco) para incluir todos os valores no campo. Por exemplo, `*` significa todos os dias da semana.<br />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.<br />Use **/** (barra) para especificar incrementos. Por exemplo, `1/2` significa cada 2.º dia da semana, começando no primeiro dia, ou seja, dias 1, 3, 5 e 7.<br />Use **L** para especificar o último dia da semana. | 
| Ano | Deve ser \* | Nenhum |