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.
# Archivar una imagen en Amazon ECR
## ¿Qué es la clase de almacenamiento de archivos ECR?
La clase de almacenamiento de archivos Amazon ECR es una nueva clase de almacenamiento que proporciona almacenamiento a largo plazo y de bajo costo para imágenes de contenedores. Amazon ECR ofrece dos clases de almacenamiento:
+ Clase de **almacenamiento estándar ECR: la clase** de almacenamiento predeterminada para las imágenes activas a las que se accede con regularidad.
+ Clase de almacenamiento de **archivos ECR: una clase de almacenamiento de bajo costo para imágenes a las que se accede con poca frecuencia, pero que deben conservarse para cumplir con las normas o como referencia** a largo plazo. La clase de almacenamiento de archivos permite ahorrar costos para una gran cantidad de imágenes en comparación con la clase de almacenamiento estándar para la retención de imágenes a largo plazo. Para obtener información detallada sobre los precios, consulte los [precios de Amazon ECR.](https://aws.amazon.com/ecr/pricing/)
Para archivar imágenes, tiene dos opciones. En primer lugar, puede configurar las reglas del ciclo de vida para archivar automáticamente las imágenes en función de:
+ Tiempo transcurrido desde que se insertó la imagen
+ Tiempo transcurrido desde la última vez que se extrajo la imagen
+ Número de imágenes en el repositorio
También puedes configurar los ajustes para eliminar permanentemente las imágenes después de que se hayan archivado durante un período específico. Para obtener más información, consulte [Automatice la limpieza de imágenes mediante el uso de políticas de ciclo de vida en Amazon ECR](LifecyclePolicies.md).
También puede archivar imágenes mediante la consola Amazon ECR o AWS CLI. Para obtener más información, consulte [Archivar una imagen](archive-image.md).
Cuando necesite volver a utilizar una imagen archivada, puede restaurarla de nuevo a la clase de almacenamiento ECR Standard. Puede esperar que ECR restaure la imagen en 20 minutos. Las imágenes restauradas se comportan como imágenes recién insertadas y están disponibles inmediatamente para su uso una vez finalizada la restauración. Las imágenes restauradas están sujetas a las políticas de digitalización, replicación y ciclo de vida del repositorio. Para obtener más información, consulte [Restauración de una imagen](restore-image.md).
# Archivar una imagen
Puede archivar las imágenes manualmente mediante la consola Amazon ECR o AWS CLI automáticamente mediante las políticas de ciclo de vida. Cuando se archiva una imagen:
+ La imagen se mueve a la clase de almacenamiento de archivos.
+ Las imágenes archivadas no se pueden extraer. Las solicitudes para extraer la imagen archivada fallarán y generarán un error 404.
+ Si bien la imagen no se puede extraer, se puede describir con el ** describe-images** comando o enumerarla con el **list-images** comando. El estado de la imagen se mostrará como`ARCHIVED`.
+ Las imágenes archivadas tienen una duración mínima de almacenamiento de 90 días. No puede configurar políticas de ciclo de vida que eliminen imágenes que hayan estado archivadas durante menos de 90 días. Si debe eliminar las imágenes que se han archivado durante menos de 90 días, debe usar la **batch-delete-image** API, pero se le cobrará la duración mínima de almacenamiento de 90 días.
+ La imagen aparece en la pestaña **Imágenes archivadas** de la vista del repositorio (esta pestaña solo aparecerá si hay al menos una imagen archivada en el repositorio).
+ La imagen se puede restaurar como una imagen activa seleccionándola manualmente para restaurarla o volviéndola a colocar en el repositorio.
+ La imagen se eliminará si el repositorio tiene políticas de ciclo de vida que eliminen la imagen con criterios como el tiempo de archivado.
------
#### [ Consola de administración de AWS ]
**Para archivar una imagen**
1. Abra la consola Amazon ECR en los [https://console.aws.amazon.com/ecr/repositorios](https://console.aws.amazon.com/ecr/repositories).
1. En la barra de navegación, elija la región que contiene el repositorio con la imagen que desea archivar.
1. En el panel de navegación, haga clic en **Repositorios**.
1. En la página **Repositorios**, elija el repositorio que contiene la imagen que desea archivar.
1. Seleccione la imagen que desee archivar. Verás los detalles de la imagen.
1. Para archivar la imagen, selecciona el botón **Archivar** y selecciona **Confirmar** cuando se te pida.
1. Si es la primera imagen archivada del repositorio, aparece una nueva pestaña **Imágenes archivadas** con la imagen recién archivada. Si hay otras imágenes archivadas, esta imagen se añadirá a esa pestaña.
------
#### [ AWS CLI ]
**Para archivar una imagen**
+ Use el **update-image-storage-class** comando para archivar una imagen actualizando su clase de almacenamiento a`ARCHIVE`:
```
aws ecr update-image-storage-class \
--repository-name my-repository \
--image-id imageDigest=sha256:4f70ef7a4d29e8c0c302b13e25962d8f7a0bd304EXAMPLE \
--target-storage-class ARCHIVE
```
------
**Para archivar una imagen mediante políticas de ciclo de vida**
+ Puede configurar las reglas de archivado para sus repositorios mediante políticas de ciclo de vida para archivar automáticamente las imágenes. Las políticas de ciclo de vida te permiten archivar automáticamente las imágenes en función de criterios como:
+ Tiempo transcurrido desde que se insertó la imagen
+ Tiempo transcurrido desde la última vez que se extrajo la imagen
+ Número máximo de imágenes que se deben mantener activas
También puede configurar políticas de ciclo de vida para eliminar permanentemente las imágenes después de que se hayan archivado durante un período específico. Para obtener más información y ejemplos de políticas de ciclo de vida con acciones de archivado, consulte[Automatice la limpieza de imágenes mediante el uso de políticas de ciclo de vida en Amazon ECR](LifecyclePolicies.md).
**nota**
Las imágenes archivadas tienen una duración mínima de almacenamiento de 90 días. No puede configurar políticas de ciclo de vida que eliminen imágenes que hayan estado archivadas durante menos de 90 días. Si debe eliminar las imágenes que se han archivado durante menos de 90 días, debe usar la **batch-delete-image** API, pero se le cobrará la duración mínima de almacenamiento de 90 días.
Al describir las imágenes con el **describe-images** comando, las imágenes archivadas tienen un número de. `image-status` `ARCHIVED` Puede filtrar las imágenes `image-status` para ver solo las imágenes archivadas o solo las imágenes activas.
# Restauración de una imagen
Al restaurar una imagen archivada, pasa de la clase de almacenamiento ECR Archive a la clase de almacenamiento ECR Standard. Las imágenes restauradas se cobran según las tarifas de almacenamiento estándar. El proceso de restauración realiza acciones similares a las que se producen cuando se crea una imagen nueva:
+ La imagen estará disponible para su extracción cuando se complete la restauración. La restauración suele tardar hasta 20 minutos, aunque puede completarse más rápido.
+ Si la opción de escaneo por inserción está habilitada para el repositorio, se escaneará la imagen restaurada. Tenga en cuenta que los resultados de escaneos anteriores a la archivación de la imagen no estarán disponibles.
+ Si la replicación está configurada para el repositorio, la imagen restaurada se replicará si la replicación estaba habilitada en el momento de la restauración.
+ La imagen restaurada aparece en la lista de imágenes activas.
La restauración de una imagen suele tardar hasta 20 minutos, aunque puede completarse más rápido. Durante el proceso de restauración, la imagen permanece archivada y no se puede extraer hasta que se complete la restauración.
------
#### [ Consola de administración de AWS ]
**Para restaurar una imagen archivada**
1. Abra la consola Amazon ECR en los [https://console.aws.amazon.com/ecr/repositorios](https://console.aws.amazon.com/ecr/repositories).
1. En la barra de navegación, elija la región que contiene el repositorio con la imagen archivada que desea restaurar.
1. En el panel de navegación, haga clic en **Repositorios**.
1. En la página **Repositorios**, elija el repositorio que contiene la imagen archivada.
1. Seleccione la pestaña Imágenes **archivadas.**
1. Seleccione la imagen archivada que desee restaurar.
1. Seleccione **Restaurar** y confirme la acción de restauración.
1. Espere a que se complete la restauración. La imagen aparecerá en la lista de imágenes activas una vez finalizada la restauración.
------
#### [ AWS CLI ]
**Para restaurar una imagen archivada**
+ Utilice el **update-image-storage-class** comando para restaurar una imagen archivada actualizando su clase de almacenamiento a: `STANDARD`
```
aws ecr update-image-storage-class \
--repository-name my-repository \
--image-id imageDigest=sha256:4f70ef7a4d29e8c0c302b13e25962d8f7a0bd304EXAMPLE \
--target-storage-class STANDARD
```
------
Al describir las imágenes con el **describe-images** comando, las imágenes que se están restaurando tienen un número `image-status` de`ACTIVATING`. Puede filtrar las imágenes por `image-status` el valor `ACTIVATING` para ver las imágenes que se están restaurando actualmente.
Un método alternativo para restaurar una imagen archivada consiste en volver a enviarla al repositorio. Cuando insertes una imagen que esté actualmente archivada, esa imagen se restaurará inmediatamente y se eliminará del archivo.