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á.
# Recuperar AMIs excluídas da Lixeira
Este tópico explica como recuperar Amazon EBS-backed AMIs da Lixeira.
**Topics**
+ [Permissões para trabalhar com AMIs na Lixeira](#ami-perms)
+ [Visualizar AMIs na Lixeira](#recycle-bin-view-ami)
+ [Restaurar as AMIs da Lixeira](#recycle-bin-restore-ami)
## Permissões para trabalhar com AMIs na Lixeira
Por padrão, os usuário não têm permissão para trabalhar com as AMIs que estão na Lixeira. Para permitir que os usuários trabalhem com esses recursos, você deve criar políticas do IAM que concedam permissão para o uso de recursos e ações de API específicos. Depois que as políticas forem criadas, você deverá adicionar permissões para os usuários, grupos ou perfis.
Para visualizar e recuperar as AMIs que estão na Lixeira, os usuários precisam ter as seguintes permissões:
+ `ec2:ListImagesInRecycleBin`
+ `ec2:RestoreImageFromRecycleBin`
Para gerenciar tags para AMIs que estão na Lixeira, os usuários precisam ter as permissões adicionais a seguir.
+ `ec2:CreateTags`
+ `ec2:DeleteTags`
Para usar o console da Lixeira, os usuários precisam ter a permissão `ec2:DescribeTags`.
A seguir está um exemplo de política do IAM. Ela inclui a permissão `ec2:DescribeTags` para usuários do console e inclui as permissões `ec2:CreateTags` e `ec2:DeleteTags` para gerenciar etiquetas. Se não forem necessárias permissões, será possível removê-las da política.
Para conceder acesso, adicione as permissões aos seus usuários, grupos ou perfis:
+ Usuários e grupos em Centro de Identidade do AWS IAM:
Crie um conjunto de permissões. Siga as instruções em [Criação de um conjunto de permissões](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html) no *Guia do usuário do Centro de Identidade do AWS IAM *.
+ Usuários gerenciados no IAM com provedor de identidades:
Crie um perfil para a federação de identidades. Siga as instruções em [Criando um perfil para um provedor de identidades de terceiros (federação)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) no *Guia do Usuário do IAM*.
+ Usuários do IAM:
+ Crie um perfil que seu usuário possa assumir. Siga as instruções em [Criação de um perfil para um usuário do IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) no *Guia do usuário do IAM*.
+ (Não recomendado) Vincule uma política diretamente a um usuário ou adicione um usuário a um grupo de usuários. Siga as instruções em [Adição de permissões a um usuário (console)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) no *Guia do usuário do IAM*.
Para obter mais informações sobre permissões necessárias para usar a Lixeira, consulte [Permissões para trabalhar com a Lixeira e com regras de retenção](recycle-bin-perms.md#rule-perms).
## Visualizar AMIs na Lixeira
Enquanto uma AMI está na Lixeira, é possível visualizar informações limitadas sobre ela, incluindo:
+ O nome, a descrição e o ID exclusivo da AMI.
+ A data e a hora em que a AMI foi excluída e entrou na Lixeira.
+ A data e a hora em que o período de retenção expira. A AMI será excluída permanentemente nesse momento.
É possível visualizar as AMIs na Lixeira usando um dos métodos a seguir.
------
#### [ Recycle Bin console ]
**Para visualizar as AMIs excluídas na Lixeira usando o console**
1. Abra o console da Lixeira em [console.aws.amazon. com/rbin/casa/](https://console.aws.amazon.com/rbin/home/).
1. No painel de navegação, selecione **Recycle Bin** (Lixeira).
1. A grade relaciona todos os recursos que estão atualmente na Lixeira. Para visualizar os detalhes de uma AMI específica, selecione-a na grade e escolha **Actions** (Ações), **View details** (Exibir detalhes).
------
#### [ AWS CLI ]
**Para visualizar as AMIs excluídas na Lixeira usando o AWS CLI**
Use o comando [list-images-in-recycle-bin](https://docs.aws.amazon.com/cli/latest/reference/ec2/list-images-in-recycle-bin.html) AWS CLI . Para visualizar AMIs específicas, inclua a opção `--image-id` e especifique os IDs das AMIs a serem exibidas. É possível especificar até 20 IDs em uma única solicitação.
Para visualizar todas as AMIs na Lixeira, omita a opção `--image-id`. Se você não especificar um valor para `--max-items`, o comando retornará mil itens por página, por padrão. Para obter mais informações, consulte [Pagination](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Query-Requests.html#api-pagination) (Paginação) em *Amazon EC2 API Reference* (Referência de API do Amazon EC2).
```
aws ec2 list-images-in-recycle-bin --image-id {{ami_id}}
```
Por exemplo, o comando a seguir retorna informações sobre a AMI `ami-01234567890abcdef` na Lixeira.
```
aws ec2 list-images-in-recycle-bin --image-id ami-01234567890abcdef
```
Resultado do exemplo:
```
{
"Images": [
{
"ImageId": "ami-0f740206c743d75df",
"Name": "My AL2 AMI",
"Description": "My Amazon Linux 2 AMI",
"RecycleBinEnterTime": "2021-11-26T21:04:50+00:00",
"RecycleBinExitTime": "2022-03-06T21:04:50+00:00"
}
]
}
```
**Importante**
Se você receber o erro a seguir, talvez seja necessário atualizar sua AWS CLI versão. Para obter mais informações, consulte [Erros de comando não encontrados](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-troubleshooting.html#tshoot-install-not-found).
```
aws.exe: error: argument operation: Invalid choice, valid choices are: ...
```
------
## Restaurar as AMIs da Lixeira
Você não pode usar uma AMI de nenhum modo enquanto ela está na Lixeira. Para usar a AMI, é necessário primeiro restaurá-la. Quando você restaura uma AMI da Lixeira, ela fica imediatamente disponível para uso e é removida da Lixeira. É possível usar uma AMI restaurada como usa qualquer outra AMI em sua conta.
É possível restaurar uma AMI da Lixeira usando um dos métodos a seguir.
------
#### [ Recycle Bin console ]
**Para restaurar uma AMI da Lixeira usando o console**
1. Abra o console da Lixeira em [console.aws.amazon. com/rbin/casa/](https://console.aws.amazon.com/rbin/home/).
1. No painel de navegação, selecione **Recycle Bin** (Lixeira).
1. A grade relaciona todos os recursos que estão atualmente na Lixeira. Selecione a AMI a ser restaurada e escolha **Recover** (Recuperar).
1. Quando solicitado, escolha **Recover** (Recuperar).
------
#### [ AWS CLI ]
**Para restaurar uma AMI excluída da Lixeira usando o AWS CLI**
Use o comando [restore-image-from-recycle-bin](https://docs.aws.amazon.com/cli/latest/reference/ec2/restore-image-from-recycle-bin.html) AWS CLI . Em `--image-id`, especifique o ID da AMI a ser restaurada.
```
aws ec2 restore-image-from-recycle-bin --image-id {{ami_id}}
```
Por exemplo, o comando a seguir restaura a AMI `ami-01234567890abcdef` da Lixeira.
```
aws ec2 restore-image-from-recycle-bin --image-id ami-01234567890abcdef
```
Quando o comando tem êxito, não retorna nenhuma saída.
**Importante**
Se você receber o erro a seguir, talvez seja necessário atualizar sua AWS CLI versão. Para obter mais informações, consulte [Erros de comando não encontrados](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-troubleshooting.html#tshoot-install-not-found).
```
aws.exe: error: argument operation: Invalid choice, valid choices are: ...
```
------