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á. # Criar uma regra de retenção da Lixeira Ao criar uma regra de retenção, você deve especificar os seguintes parâmetros obrigatórios: + O tipo de recurso a ser protegido (volumes, instantâneos ou AMIs). + O tipo de regra de retenção (em nível de tag ou Region-level). Tag-level as regras protegem somente recursos que tenham tags específicas. Region-level as regras protegem todos os recursos na região, mas podem excluir recursos que tenham tags específicas. + O período de retenção para reter os recursos após sua exclusão. Quando o período expira, o recurso é excluído permanentemente da Lixeira. Os períodos de retenção suportados são: + Volumes do EBS: 1 a 7 dias + Instantâneos e EBS-backed AMIs do EBS: 1 a 365 dias Opcionalmente, você também pode especificar um nome de regra e uma descrição de até 255 caracteres cada, além de etiquetas para ajudá-lo a identificar e organizar suas regras. Recomendamos não incluir informações pessoais, confidenciais ou sigilosas no nome, descrição ou etiquetas. Opcionalmente, você também pode bloquear as regras Region-level de retenção na criação. Se você bloquear uma regra de retenção ao criá-la, também deverá especificar o período de espera para o desbloqueio, que pode ser de 7 a 30 dias. As regras de retenção permanecem desbloqueadas, por padrão, a menos que você as bloqueie explicitamente. **nota** As regras de retenção só funcionam nas regiões em que são criadas. Se você pretender usar a lixeira em outras regiões, deverá criar regras de retenção adicionais nessas regiões. É possível criar uma regra de retenção da lixeira usando um dos métodos a seguir. ------ #### [ Recycle Bin console ] **Para criar uma regra de retenção em nível da etiqueta** 1. Abra o console da Lixeira em [https://console.aws.amazon.com/rbin/home/](https://console.aws.amazon.com/rbin/home/) 1. No painel de navegação, escolha **Retention rules** (Regras de retenção) e depois escolha **Create retention rule** (Criar regra de retenção). 1. (*Opcional*) Em **Retention rule name** (Nome da regra de retenção), insira um nome descritivo para a regra de retenção. 1. (*Opcional*) Em **Retention rule description** (Descrição da regra de retenção), insira uma breve descrição para a regra de retenção. 1. Em **Tipo de recurso**, selecione o tipo de recurso para a regra de retenção a ser protegida. A regra de retenção reterá somente recursos desse tipo na Lixeira. 1. Em **Selecionar os recursos a serem retidos**, escolha **Reter recursos que tenham etiquetas específicas**. 1. Em **Etiquetas de recurso**, insira os pares de chave e de valor de etiqueta a serem usados para identificar os recursos a serem retidos na Lixeira. Somente recursos do tipo especificado com, pelo menos, uma das etiquetas especificadas serão retidos pela regra de retenção. 1. Em **Período de retenção**, insira o número de dias pelos quais os recursos excluídos devem ser retidos na Lixeira. 1. Selecione **Create retention rule** (Criar regra de retenção). **Para criar uma regra Region-level de retenção** 1. Abra o console da Lixeira em [https://console.aws.amazon.com/rbin/home/](https://console.aws.amazon.com/rbin/home/) 1. No painel de navegação, escolha **Retention rules** (Regras de retenção) e depois escolha **Create retention rule** (Criar regra de retenção). 1. (*Opcional*) Em **Retention rule name** (Nome da regra de retenção), insira um nome descritivo para a regra de retenção. 1. (*Opcional*) Em **Retention rule description** (Descrição da regra de retenção), insira uma breve descrição para a regra de retenção. 1. Em **Tipo de recurso**, selecione o tipo de recurso para a regra de retenção a ser protegida. A regra de retenção reterá somente recursos desse tipo na Lixeira. 1. Em **Selecionar os recursos a serem retidos**, escolha **Reter todos os recursos**. 1. (*Opcional*) Para excluir recursos que tenham etiquetas específicas, em **Etiquetas de exclusão**, insira até cinco pares de chave e valor de etiqueta a serem usados para identificar os recursos a serem excluídos. Os recursos que têm qualquer uma dessas etiquetas são ignorados pela regra de retenção. 1. Em **Período de retenção**, insira o número de dias pelos quais os recursos excluídos devem ser retidos na Lixeira. 1. (*Opcional*) Para bloquear a regra de retenção, em **Rule lock settings** (Configurações de bloqueio da regra), selecione **Lock** (Bloquear) e, em seguida, para **Unlock delay period** (Período de espera para desbloqueio), especifique o período de espera para o desbloqueio em dias. Uma regra de retenção bloqueada não pode ser modificada nem excluída. Para modificar ou excluir a regra, você deve primeiro desbloqueá-la e depois aguardar que o período de espera para o desbloqueio expire. Para obter mais informações, consulte [Bloquear uma regra de retenção da Lixeira para evitar que seja atualizada ou excluída](recycle-bin-lock.md). Para deixar a regra de retenção desbloqueada, em **Rule lock settings** (Configurações de bloqueio da regra), mantenha a opção **Unlock** (Desbloquear) selecionada. Uma regra de retenção desbloqueada pode ser modificada ou excluída a qualquer momento. **nota** Você não pode bloquear regras Region-level de retenção que tenham tags de exclusão. 1. Selecione **Create retention rule** (Criar regra de retenção). ------ #### [ AWS CLI ] **Para criar uma regra de retenção** Use o comando [create-rule](https://docs.aws.amazon.com/cli/latest/reference/rbin/create-rule.html) da AWS CLI . Em `--retention-period`, especifique o número de dias de retenção dos snapshots excluídos na lixeira. Para`--resource-type`, especifique `EBS_VOLUME` para volumes, `EBS_SNAPSHOT` para instantâneos ou `EC2_IMAGE` para AMIs. Para criar uma regra de retenção em nível de tag, para`--resource-tags`, especifique as tags a serem usadas para identificar os recursos que devem ser retidos. Para criar uma regra Region-level de retenção, omita e`--resource-tags`, opcionalmente, especifique`--exclude-resource-tags`, exclua recursos que tenham tags específicas. Para bloquear uma regra Region-level de retenção`--lock-configuration`, inclua e especifique o período de atraso de desbloqueio em dias. ``` aws rbin create-rule \ --retention-period RetentionPeriodValue={{number_of_days}},RetentionPeriodUnit=DAYS \ --resource-type {{EBS_VOLUME|EBS_SNAPSHOT|EC2_IMAGE}} \ --description "{{rule_description}}" \ --lock-configuration 'UnlockDelay={UnlockDelayUnit=DAYS,UnlockDelayValue={{unlock_delay_in_days}}}' \ --resource-tags ResourceTagKey={{tag_key}},ResourceTagValue={{tag_value}} \ --exclude-resource-tags ResourceTagKey={{tag_key}},ResourceTagValue={{tag_value}} ``` **Exemplo 1** O comando de exemplo a seguir cria uma regra de Region-level retenção desbloqueada que retém todos os instantâneos excluídos por um período de dias. `7` ``` aws rbin create-rule \ --retention-period RetentionPeriodValue=7,RetentionPeriodUnit=DAYS \ --resource-type EBS_SNAPSHOT \ --description "Match all snapshots" ``` **Exemplo 2** O exemplo de comando a seguir cria uma regra de retenção, no nível da tag, que retém todos os snapshots com tag de `purpose=production` aplicada por um período de `7` dias. ``` aws rbin create-rule \ --retention-period RetentionPeriodValue=7,RetentionPeriodUnit=DAYS \ --resource-type EBS_SNAPSHOT \ --description "Match snapshots with a specific tag" \ --resource-tags ResourceTagKey=purpose,ResourceTagValue=production ``` **Exemplo 3** O comando de exemplo a seguir cria uma regra Region-level de retenção bloqueada que retém todos os instantâneos excluídos por um período de `7` dias. A regra de retenção é bloqueada com um período de espera para o desbloqueio de 7 dias. ``` aws rbin create-rule \ --retention-period RetentionPeriodValue=7,RetentionPeriodUnit=DAYS \ --resource-type EBS_SNAPSHOT \ --description "Match all snapshots" \ --lock-configuration 'UnlockDelay={UnlockDelayUnit=DAYS,UnlockDelayValue=7}' ``` **Exemplo 4** O comando de exemplo a seguir cria uma regra de Region-level retenção desbloqueada que retém todos os instantâneos excluídos, exceto os instantâneos marcados com`purpose:testing`, por um período de dias. `7` ``` aws rbin create-rule \ --retention-period RetentionPeriodValue=7,RetentionPeriodUnit=DAYS \ --resource-type EBS_SNAPSHOT \ --description "Match only production snapshots" \ --exclude-resource-tags ResourceTagKey=purpose,ResourceTagValue=testing ``` ------