Recover deleted AMIs from the Recycle Bin
Topics
Permissions for working with AMIs in the Recycle Bin
By default, users don't have permission to work with AMIs that are in the Recycle Bin. To allow users to work with these resources, you must create IAM policies that grant permission to use specific resources and API actions. After the policies are created, you must add permissions to your users, groups, or roles.
To view and recover AMIs that are in the Recycle Bin, users must have the following permissions:
-
ec2:ListImagesInRecycleBin -
ec2:RestoreImageFromRecycleBin
To manage tags for AMIs in the Recycle Bin, users need the following additional permissions.
-
ec2:CreateTags -
ec2:DeleteTags
To use the Recycle Bin console, users need the ec2:DescribeTags
permission.
The following is an example IAM policy. It includes the ec2:DescribeTags
permission for console users, and it includes the ec2:CreateTags and
ec2:DeleteTags permissions for managing tags. If the permissions are not
needed, you can remove them from the policy.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ec2:ListImagesInRecycleBin", "ec2:RestoreImageFromRecycleBin" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "ec2:CreateTags", "ec2:DeleteTags", "ec2:DescribeTags" ], "Resource": "arn:aws:ec2:Region::image/*" } ] }
To provide access, add permissions to your users, groups, or roles:
-
Users and groups in AWS IAM Identity Center:
Create a permission set. Follow the instructions in Create a permission set in the AWS IAM Identity Center User Guide.
-
Users managed in IAM through an identity provider:
Create a role for identity federation. Follow the instructions in Create a role for a third-party identity provider (federation) in the IAM User Guide.
-
IAM users:
-
Create a role that your user can assume. Follow the instructions in Create a role for an IAM user in the IAM User Guide.
-
(Not recommended) Attach a policy directly to a user or add a user to a user group. Follow the instructions in Adding permissions to a user (console) in the IAM User Guide.
-
For more information about the permissions needed to use Recycle Bin, see Permissions for working with Recycle Bin and retention rules.
View AMIs in the Recycle Bin
While an AMI is in the Recycle Bin, you can view limited information about it, including:
-
The name, description, and unique ID of the AMI.
-
The date and time when the AMI was deleted and it entered Recycle Bin.
-
The date and time when the retention period expires. The AMI will be permanently deleted at this time.
You can view the AMIs in the Recycle Bin using one of the following methods.
Restore AMIs from the Recycle Bin
You can't use an AMI in any way while it is in the Recycle Bin. To use the AMI, you must first restore it. When you restore an AMI from the Recycle Bin, the AMI is immediately available for use, and it is removed from the Recycle Bin. You can use a restored AMI in the same way that you use any other AMI in your account.
You can restore an AMI from the Recycle Bin using one of the following methods.
