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ídos da Lixeira
Este tópico explica como recuperar o suporte do Amazon EBS AMIs da Lixeira.
**Topics**
+ [Permissões para trabalhar AMIs na Lixeira](#ami-perms)
+ [Exibir AMIs na lixeira](#recycle-bin-view-ami)
+ [Restaurar AMIs a partir da lixeira](#recycle-bin-restore-ami)
## Permissões para trabalhar AMIs na Lixeira
Por padrão, os usuários não têm permissão para trabalhar com os 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 os AMIs que estão na Lixeira, os usuários devem ter as seguintes permissões:
+ `ec2:ListImagesInRecycleBin`
+ `ec2:RestoreImageFromRecycleBin`
Para gerenciar etiquetas AMIs na Lixeira, os usuários precisam das seguintes permissões adicionais.
+ `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).
## Exibir 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.
Você pode visualizar o AMIs na Lixeira usando um dos métodos a seguir.
------
#### [ Recycle Bin console ]
**Para ver os excluídos AMIs na Lixeira usando o console**
1. Abra o console da Lixeira em [console.aws.amazon. com/rbin/home](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 os excluídos AMIs na Lixeira usando o AWS CLI**
Use o AWS CLI comando [list-images-in-recycle-bin](https://docs.aws.amazon.com/cli/latest/reference/ec2/list-images-in-recycle-bin.html). Para exibir uma visualização específica AMIs, inclua a `--image-id` opção e especifique AMIs a IDs da visualização. Você pode especificar até 20 IDs em uma única solicitação.
Para ver tudo AMIs na Lixeira, omita a `--image-id` opção. 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 AMIs a partir 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/home](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 AWS CLI comando [restore-image-from-recycle-bin](https://docs.aws.amazon.com/cli/latest/reference/ec2/restore-image-from-recycle-bin.html). 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: ...
```
------