

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

# Atualizar uma regra de retenção da Lixeira já existente
<a name="recycle-bin-update-rule"></a>

Você pode atualizar a descrição, as etiquetas de recursos e o período de retenção de uma regra de retenção desbloqueada a qualquer momento após a criação. Você não pode atualizar o tipo de recurso nem o período de espera para o desbloqueio de uma regra de retenção, mesmo que a regra de retenção esteja desbloqueada.

Você não pode atualizar uma regra de retenção bloqueada de nenhuma maneira. Se precisar modificar uma regra de retenção bloqueada, deverá primeiro desbloqueá-la e aguardar até que o período de espera para o desbloqueio expire.

Se você precisar modificar o período espera para o desbloqueio de uma regra de retenção bloqueada, [desbloqueie a regra de retenção](recycle-bin-unlock.md) e aguarde até que o período atual de espera para o desbloqueio expire. Quando o período de espera para o desbloqueio expirar, você deve [bloquear a regra de retenção novamente](recycle-bin-lock.md) e especificar o novo período de espera para o desbloqueio.

**nota**  
Recomendamos não incluir informações pessoais, confidenciais ou sigilosas na descrição da regra de retenção.

Depois que você atualiza uma regra de retenção, as alterações só se aplicam aos novos recursos que ela retém. As alterações não afetam os recursos enviados anteriormente para a Lixeira. Por exemplo, se você atualizar o período de retenção de uma regra de retenção, apenas os snapshots excluídos após a atualização serão retidos pelo novo período de retenção. Os snapshots enviados para a lixeira antes da atualização ainda serão retidos pelo período de retenção anterior (antigo).

É possível atualizar uma regra de retenção usando um dos seguintes métodos.

------
#### [ Recycle Bin console ]

**Para atualizar uma regra de retenção**

1. [Abra o console da Lixeira em casa/ https://console.aws.amazon.com/rbin/](https://console.aws.amazon.com/rbin/home/)

1. No painel de navegação, selecione **Retention rules** (Regras de retenção).

1. Na grade, selecione a regra de retenção a ser atualizada e escolha **Actions** (Ações), **Edit retention rule** (Editar regra de retenção).

1. Na seção **Rule details** (Detalhes da regra), atualize **Retention rule name** (Nome da regra de retenção) e **Retention rule description** (Descrição da regra de retenção) conforme necessário.

1. Na seção **Configurações de regra**, atualize **Tipo de recurso**, **Etiquetas de recurso a corresponder** e **Período de retenção** conforme necessário.

1. Na seção **Tags**, adicione ou remova tags da regra de retenção conforme necessário.

1. Selecione **Save retention rule** (Salvar regra de retenção).

------
#### [ AWS CLI ]

**Para atualizar uma regra de retenção**  
Use o comando [update-rule](https://docs.aws.amazon.com/cli/latest/reference/rbin/update-rule.html) da AWS CLI . Para`--identifier`, especifique o ID da regra de retenção a ser atualizada para`--resource-types`, especifique `EBS_VOLUME` para volumes, `EBS_SNAPSHOT` para instantâneos ou `EC2_IMAGE` para AMIs.

```
aws rbin update-rule \
--identifier rule_ID \
--retention-period RetentionPeriodValue=number_of_days,RetentionPeriodUnit=DAYS \
--resource-type EBS_VOLUME|EBS_SNAPSHOT|EC2_IMAGE \
--description "rule_description"
```

**Exemplo**  
O exemplo a seguir atualiza a regra de retenção `6lsJ2Fa9nh9` para reter todos os snapshots por `7` dias e atualiza sua descrição.

```
aws rbin update-rule \
--identifier 6lsJ2Fa9nh9 \
--retention-period RetentionPeriodValue=7,RetentionPeriodUnit=DAYS \
--resource-type EBS_SNAPSHOT \
--description "Retain for three weeks"
```

------