

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Récupérer les fichiers AMIs supprimés de la corbeille
<a name="recycle-bin-working-with-amis"></a>

Cette rubrique explique comment récupérer des fichiers sauvegardés par Amazon EBS AMIs depuis la corbeille.

**Topics**
+ [Autorisations d'utilisation AMIs dans la corbeille](#ami-perms)
+ [Afficher AMIs dans la corbeille](#recycle-bin-view-ami)
+ [Restaurer AMIs à partir de la corbeille](#recycle-bin-restore-ami)

## Autorisations d'utilisation AMIs dans la corbeille
<a name="ami-perms"></a>

Par défaut, les utilisateurs ne sont pas autorisés à travailler avec ceux AMIs qui se trouvent dans la corbeille. Pour permettre aux utilisateurs de travailler avec ces ressources, vous devez créer des politiques IAM qui accordent l’autorisation d’utiliser des ressources et des actions d’API spécifiques. Une fois les politiques créées, vous devez ajouter des autorisations à vos utilisateurs, groupes ou rôles.

Pour consulter et récupérer AMIs le contenu de la corbeille, les utilisateurs doivent disposer des autorisations suivantes :
+ `ec2:ListImagesInRecycleBin`
+ `ec2:RestoreImageFromRecycleBin`

Pour gérer les balises AMIs dans la corbeille, les utilisateurs ont besoin des autorisations supplémentaires suivantes.
+ `ec2:CreateTags`
+ `ec2:DeleteTags`

Pour utiliser la console de la corbeille, les utilisateurs ont besoin de l’autorisation `ec2:DescribeTags`.

Voici un exemple de politique IAM. Elle comprend l’autorisation `ec2:DescribeTags` pour les utilisateurs de la console et les autorisations `ec2:CreateTags` et `ec2:DeleteTags` pour la gestion des identifications. Si les autorisations ne sont pas nécessaires, vous pouvez les supprimer de la politique.

Pour activer l’accès, ajoutez des autorisations à vos utilisateurs, groupes ou rôles :
+ Utilisateurs et groupes dans AWS IAM Identity Center :

  Créez un jeu d’autorisations. Suivez les instructions de la rubrique [Création d’un jeu d’autorisations](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html) du *Guide de l’utilisateur AWS IAM Identity Center *.
+ Utilisateurs gérés dans IAM par un fournisseur d’identité :

  Créez un rôle pour la fédération d’identité. Suivez les instructions de la rubrique [Création d’un rôle pour un fournisseur d’identité tiers (fédération)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) dans le *Guide de l’utilisateur IAM*.
+ Utilisateurs IAM :
  + Créez un rôle que votre utilisateur peut assumer. Suivez les instructions de la rubrique [Création d’un rôle pour un utilisateur IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) dans le *Guide de l’utilisateur IAM*.
  + (Non recommandé) Attachez une politique directement à un utilisateur ou ajoutez un utilisateur à un groupe d’utilisateurs. Suivez les instructions de la rubrique [Ajout d’autorisations à un utilisateur (console)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) du *Guide de l’utilisateur IAM*.

Pour plus d’informations sur les autorisations nécessaires pour utiliser la corbeille, consultez [Autorisations pour utiliser la corbeille et les règles de rétention](recycle-bin-perms.md#rule-perms).

## Afficher AMIs dans la corbeille
<a name="recycle-bin-view-ami"></a>

Lorsqu’une AMI se trouve dans la corbeille, vous pouvez afficher des informations limitées à son sujet, notamment :
+ Le nom, la description et l’ID unique de l’AMI.
+ La date et l’heure de la suppression de l’AMI et de son entrée dans la corbeille.
+ la date et l’heure d’expiration de la période de rétention ; L’AMI sera définitivement supprimée à ce moment-là.

Vous pouvez les afficher AMIs dans la corbeille en utilisant l'une des méthodes suivantes.

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

**Pour afficher les fichiers supprimés AMIs dans la corbeille à l'aide de la console**

1. Ouvrez la console Recycle Bin sur [console.aws.amazon. com/rbin/home](https://console.aws.amazon.com/rbin/home/)/.

1. Dans le volet de navigation, choisissez **Recycle Bin** (Corbeille).

1. La grille répertorie toutes les ressources qui se trouvent actuellement dans la corbeille. Pour afficher les détails d’une AMI spécifique, sélectionnez-la dans la grille et choisissez **Actions**, **View details** (Afficher les détails).

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

**Pour afficher les fichiers supprimés AMIs dans la corbeille à l'aide du AWS CLI**  
Utilisez la AWS CLI commande [list-images-in-recycle-bin](https://docs.aws.amazon.com/cli/latest/reference/ec2/list-images-in-recycle-bin.html). Pour une vue spécifique AMIs, incluez l'`--image-id`option et spécifiez IDs celle AMIs à afficher. Vous pouvez en spécifier jusqu'à 20 IDs dans une seule demande.

Pour afficher tout ce qui se trouve AMIs dans la corbeille, omettez l'`--image-id`option. Si vous ne spécifiez pas de valeur pour `--max-items`, la commande renvoie par défaut 1 000 éléments par page. Pour plus d’informations, consultez [Pagination](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Query-Requests.html#api-pagination) dans le manuel *Amazon EC2 API Reference*.

```
aws ec2 list-images-in-recycle-bin --image-id ami_id
```

Par exemple, la commande suivante renvoie des informations sur l’AMI `ami-01234567890abcdef` dans la corbeille.

```
aws ec2 list-images-in-recycle-bin --image-id ami-01234567890abcdef
```

Exemple de sortie :

```
{
    "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"
        }
    ]
}
```

**Important**  
Si le message d'erreur suivant s'affiche, il se peut que vous deviez mettre à jour votre AWS CLI version. Pour plus d’informations, veuillez consulter la rubrique [Erreurs liées aux commandes introuvables](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: ...
```

------

## Restaurer AMIs à partir de la corbeille
<a name="recycle-bin-restore-ami"></a>

Vous ne pouvez en aucun cas utiliser une AMI lorsqu’elle se trouve dans la corbeille. Pour utiliser l’AMI, vous devez d’abord la restaurer. Lorsque vous restaurez une AMI à partir de la corbeille, elle est immédiatement disponible pour utilisation et elle est supprimée de la corbeille. Une fois qu’elle est restaurée, vous pouvez l’utiliser de la même manière que n’importe quelle autre AMI de votre compte.

Vous pouvez restaurer une AMI à partir de la corbeille en utilisant l’une des méthodes suivantes.

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

**Pour restaurer une AMI depuis la corbeille en utilisant la console**

1. Ouvrez la console Recycle Bin sur [console.aws.amazon. com/rbin/home](https://console.aws.amazon.com/rbin/home/)/.

1. Dans le volet de navigation, choisissez **Recycle Bin** (Corbeille).

1. La grille répertorie toutes les ressources qui se trouvent actuellement dans la corbeille. Sélectionnez l’AMI à restaurer, puis choisissez **Recover** (Récupérer).

1. Lorsque vous y êtes invité, choisissez **Recover** (Récupérer).

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

**Pour restaurer une AMI supprimée de la corbeille à l'aide du AWS CLI**  
Utilisez la AWS CLI commande [restore-image-from-recycle-bin](https://docs.aws.amazon.com/cli/latest/reference/ec2/restore-image-from-recycle-bin.html). Pour `--image-id`, spécifiez l’ID de l’AMI à restaurer.

```
aws ec2 restore-image-from-recycle-bin --image-id ami_id
```

Par exemple, la commande suivante restaure l’AMI `ami-01234567890abcdef` depuis la corbeille.

```
aws ec2 restore-image-from-recycle-bin --image-id ami-01234567890abcdef
```

La commande ne renvoie aucun résultat en cas de succès.

**Important**  
Si le message d'erreur suivant s'affiche, il se peut que vous deviez mettre à jour votre AWS CLI version. Pour plus d’informations, veuillez consulter la rubrique [Erreurs liées aux commandes introuvables](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: ...
```

------