

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Recupera lo borrado AMIs de la papelera de reciclaje
<a name="recycle-bin-working-with-amis"></a>

En este tema se explica cómo recuperar Amazon EBS AMIs de la papelera de reciclaje.

**Topics**
+ [Permisos para trabajar con ellos AMIs en la papelera de reciclaje](#ami-perms)
+ [Ver AMIs en la papelera de reciclaje](#recycle-bin-view-ami)
+ [Restaure AMIs desde la papelera de reciclaje](#recycle-bin-restore-ami)

## Permisos para trabajar con ellos AMIs en la papelera de reciclaje
<a name="ami-perms"></a>

De forma predeterminada, los usuarios no tienen permiso para trabajar con los AMIs que están en la papelera de reciclaje. Para permitir a los usuarios trabajar con estos recursos, debe crear políticas de IAM que concedan permisos para utilizar recursos específicos y acciones de la API. Una vez creadas las políticas, tendrá que agregar permisos a los usuarios, grupos o roles.

Para ver y recuperar AMIs lo que está en la papelera de reciclaje, los usuarios deben tener los siguientes permisos:
+ `ec2:ListImagesInRecycleBin`
+ `ec2:RestoreImageFromRecycleBin`

Para gestionar las etiquetas de AMIs la papelera de reciclaje, los usuarios necesitan los siguientes permisos adicionales.
+ `ec2:CreateTags`
+ `ec2:DeleteTags`

Para utilizar la consola de la papelera de reciclaje, los usuarios necesitan el permiso `ec2:DescribeTags`.

A continuación, se muestra una política de IAM de ejemplo. Incluye el permiso `ec2:DescribeTags` para los usuarios de la consola y los permisos `ec2:CreateTags` y `ec2:DeleteTags` para administrar etiquetas. Si los permisos no se necesitan, puede eliminarlos de la política.

Para dar acceso, agregue permisos a los usuarios, grupos o roles:
+ Usuarios y grupos en AWS IAM Identity Center:

  Cree un conjunto de permisos. Siga las instrucciones de [Creación de un conjunto de permisos](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html) en la *Guía del usuario de AWS IAM Identity Center *.
+ Usuarios gestionados en IAM a través de un proveedor de identidades:

  Cree un rol para la federación de identidades. Siga las instrucciones descritas en [Creación de un rol para un proveedor de identidad de terceros (federación)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) en la *Guía del usuario de IAM*.
+ Usuarios de IAM:
  + Cree un rol que el usuario pueda aceptar. Siga las instrucciones descritas en [Creación de un rol para un usuario de IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) en la *Guía del usuario de IAM*.
  + (No recomendado) Adjunte una política directamente a un usuario o agregue un usuario a un grupo de usuarios. Siga las instrucciones descritas en [Adición de permisos a un usuario (consola)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) de la *Guía del usuario de IAM*.

Para obtener más información acerca de los permisos que se necesitan para usar la papelera de reciclaje, consulte [Permisos para trabajar con la papelera de reciclaje y las reglas de retención](recycle-bin-perms.md#rule-perms).

## Ver AMIs en la papelera de reciclaje
<a name="recycle-bin-view-ami"></a>

Mientras una AMI se encuentre en la papelera de reciclaje, podrá ver información limitada sobre ella, incluido lo siguiente:
+ El nombre, la descripción y el ID único de la AMI.
+ La fecha y la hora en las que se eliminó la AMI e ingresó a la papelera de reciclaje.
+ La fecha y la hora en que se vence el periodo de retención. La AMI se eliminará de forma permanente en este momento.

Puede verlo AMIs en la papelera de reciclaje mediante uno de los siguientes métodos.

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

**Para ver los AMIs borrados de la papelera de reciclaje mediante la consola**

1. Abra la consola de la papelera de reciclaje en [console.aws.amazon. com/rbin/home/.](https://console.aws.amazon.com/rbin/home/)

1. En el panel de navegación, elija **Recycle Bin** (Papelera de reciclaje).

1. La cuadrícula enumera todos los recursos que se encuentran actualmente en la papelera de reciclaje. Para ver los detalles de una AMI específica, selecciónela en la cuadrícula y elija **Actions** (Acciones), **View details** (Ver detalles).

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

**Para ver los AMIs borrados de la papelera de reciclaje mediante el AWS CLI**  
Utilice el AWS CLI comando [list-images-in-recycle-bin](https://docs.aws.amazon.com/cli/latest/reference/ec2/list-images-in-recycle-bin.html). Para ver una vista específica AMIs, incluya la `--image-id` opción y especifique IDs la AMIs que desea ver. Puede especificar hasta 20 IDs en una sola solicitud.

Para ver todo lo que hay AMIs en la papelera de reciclaje, omita la `--image-id` opción. Si no especifica un valor para `--max-items`, de forma predeterminada, el comando devolverá 1000 elementos por página. Para obtener más información, consulte [Paginación](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Query-Requests.html#api-pagination) en la *Referencia de la API de Amazon EC2*.

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

Por ejemplo, el siguiente comando proporciona información acerca de la AMI `ami-01234567890abcdef` en la papelera de reciclaje.

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

Ejemplo de código de salida:

```
{
    "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**  
Si recibes el siguiente error, es posible que tengas que actualizar tu AWS CLI versión. Para obtener más información, consulte [Errores: comandos no 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: ...
```

------

## Restaure AMIs desde la papelera de reciclaje
<a name="recycle-bin-restore-ami"></a>

No puede utilizar una AMI de ninguna manera mientras está en la papelera de reciclaje. Para utilizar la AMI, primero debe restaurarla. Cuando se restaura una AMI desde la papelera de reciclaje, la AMI queda disponible inmediatamente para su uso y se quita de la papelera de reciclaje. Puede utilizar una AMI restaurada de la misma manera que utiliza cualquier otra AMI de su cuenta.

Puede restaurar una AMI desde la papelera de reciclaje siguiendo alguno de los métodos que se indican a continuación.

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

**Para restaurar una AMI desde la papelera de reciclaje usando la consola**

1. Abra la consola de la papelera de reciclaje en [console.aws.amazon. com/rbin/home/.](https://console.aws.amazon.com/rbin/home/)

1. En el panel de navegación, elija **Recycle Bin** (Papelera de reciclaje).

1. La cuadrícula enumera todos los recursos que se encuentran actualmente en la papelera de reciclaje. Seleccione la AMI que desea restaurar y elija **Recover** (Recuperar).

1. Cuando se le pregunte, elija **Recover** (Recuperar).

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

**Para restaurar una AMI eliminada de la papelera de reciclaje mediante el AWS CLI**  
Utilice el AWS CLI comando [restore-image-from-recycle-bin](https://docs.aws.amazon.com/cli/latest/reference/ec2/restore-image-from-recycle-bin.html). En `--image-id`, especifique el ID de la AMI que desea restaurar.

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

Por ejemplo, el siguiente comando restaura la AMI `ami-01234567890abcdef` desde la papelera de reciclaje.

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

Si el comando se ejecuta correctamente, no devuelve ningún resultado.

**importante**  
Si recibes el siguiente error, es posible que tengas que actualizar tu AWS CLI versión. Para obtener más información, consulte [Errores: comandos no 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: ...
```

------