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á.
# Arquivamento de uma imagem no Amazon ECR
## Qual é a classe de armazenamento de arquivamento ECR?
A classe de armazenamento arquivístico Amazon ECR é uma nova classe de armazenamento que fornece armazenamento de baixo custo e de longo prazo para imagens de contêineres. O Amazon ECR oferece duas classes de armazenamento:
+ Classe de **armazenamento padrão ECR — A classe** de armazenamento padrão para imagens ativas que são acessadas regularmente.
+ Classe de **armazenamento de arquivamento ECR — uma classe** de armazenamento de baixo custo para imagens que raramente são acessadas, mas que precisam ser mantidas para fins de conformidade ou referência de longo prazo. A classe de armazenamento arquivístico oferece economia de custos para grandes quantidades de imagens em comparação com a classe de armazenamento padrão para retenção de imagens a longo prazo. Para obter informações detalhadas sobre preços, consulte os [preços do Amazon ECR.](https://aws.amazon.com/ecr/pricing/)
Para arquivar imagens, você tem duas opções. Primeiro, você pode configurar regras de ciclo de vida para arquivar imagens automaticamente com base em:
+ Tempo desde que a imagem foi enviada
+ Tempo desde a última vez que a imagem foi retirada
+ Número de imagens no repositório
Você também pode definir as configurações para excluir permanentemente as imagens após elas terem sido arquivadas por um período especificado. Consulte [Automatizar a limpeza de imagens usando políticas de ciclo de vida no Amazon ECR](LifecyclePolicies.md) para obter mais informações.
Você também pode arquivar imagens usando o console Amazon ECR ou AWS CLI. Consulte [Arquivando uma imagem](archive-image.md) para obter mais informações.
Quando precisar usar uma imagem arquivada novamente, você pode restaurá-la de volta à classe de armazenamento ECR Standard. Você pode esperar que o ECR restaure a imagem em 20 minutos. As imagens restauradas se comportam como imagens recém-enviadas e ficam imediatamente disponíveis para uso quando a restauração for concluída. As imagens restauradas estão sujeitas às políticas de digitalização, replicação e ciclo de vida do repositório. Consulte [Restaurando uma imagem](restore-image.md) para obter mais informações.
# Arquivando uma imagem
Você pode arquivar imagens manualmente usando o console Amazon ECR ou AWS CLI automaticamente usando políticas de ciclo de vida. Quando uma imagem é arquivada:
+ A imagem é movida para a classe de armazenamento arquivístico.
+ As imagens arquivadas não podem ser extraídas. As solicitações para extrair a imagem arquivada falharão com um erro 404.
+ Embora a imagem não possa ser extraída, ela ainda pode ser descrita usando o ** describe-images** comando ou listada usando o **list-images** comando. O status da imagem será mostrado como`ARCHIVED`.
+ As imagens arquivadas têm uma duração mínima de armazenamento de 90 dias. Você não pode configurar políticas de ciclo de vida que excluam imagens que estão arquivadas há menos de 90 dias. Se você precisar excluir imagens que foram arquivadas por menos de 90 dias, precisará usar a **batch-delete-image** API, mas você será cobrado pela duração mínima de armazenamento de 90 dias.
+ A imagem aparece em uma guia **Imagens arquivadas** na visualização do repositório (essa guia aparecerá somente se pelo menos uma imagem estiver arquivada no repositório).
+ A imagem pode ser restaurada como uma imagem ativa selecionando-a manualmente para ser restaurada ou empurrando-a novamente para o repositório.
+ A imagem será excluída se o repositório tiver políticas de ciclo de vida que excluam a imagem com critérios como tempo de arquivamento.
------
#### [ Console de gerenciamento da AWS ]
**Para arquivar uma imagem**
1. Abra o console do Amazon ECR nos [https://console.aws.amazon.com/ecr/repositórios](https://console.aws.amazon.com/ecr/repositories).
1. Na barra de navegação, escolha a região que contém o repositório com a imagem que você deseja arquivar.
1. No painel de navegação, escolha **Repositories (Repositórios)**.
1. Na página **Repositórios**, escolha o repositório que contém a imagem que você deseja arquivar.
1. Selecione a imagem que você deseja arquivar. Você verá os detalhes da imagem.
1. Para arquivar a imagem, selecione o botão **Arquivar** e selecione **Confirmar** quando solicitado.
1. Se essa for a primeira imagem arquivada no repositório, uma nova guia **Imagens arquivadas** será exibida com a imagem recém-arquivada. Se houver outras imagens arquivadas, essa imagem será adicionada a essa guia.
------
#### [ AWS CLI ]
**Para arquivar uma imagem**
+ Use o **update-image-storage-class** comando para arquivar uma imagem atualizando sua classe de armazenamento para`ARCHIVE`:
```
aws ecr update-image-storage-class \
--repository-name my-repository \
--image-id imageDigest=sha256:4f70ef7a4d29e8c0c302b13e25962d8f7a0bd304EXAMPLE \
--target-storage-class ARCHIVE
```
------
**Para arquivar uma imagem usando políticas de ciclo de vida**
+ Você pode configurar regras de arquivamento para seus repositórios usando políticas de ciclo de vida para arquivar imagens automaticamente. As políticas de ciclo de vida permitem que você arquive imagens automaticamente com base em critérios como:
+ Tempo desde que a imagem foi enviada
+ Tempo desde a última vez que a imagem foi retirada
+ Número máximo de imagens para manter ativas
Você também pode configurar políticas de ciclo de vida para excluir permanentemente imagens após elas terem sido arquivadas por um período especificado. Para obter mais informações e exemplos de políticas de ciclo de vida com ações de arquivamento, consulte. [Automatizar a limpeza de imagens usando políticas de ciclo de vida no Amazon ECR](LifecyclePolicies.md)
**nota**
As imagens arquivadas têm uma duração mínima de armazenamento de 90 dias. Você não pode configurar políticas de ciclo de vida que excluam imagens que estão arquivadas há menos de 90 dias. Se você precisar excluir imagens que foram arquivadas por menos de 90 dias, precisará usar a **batch-delete-image** API, mas você será cobrado pela duração mínima de armazenamento de 90 dias.
Quando você descreve imagens usando o **describe-images** comando, as imagens arquivadas têm um `image-status` de`ARCHIVED`. Você pode filtrar imagens `image-status` para ver somente imagens arquivadas ou somente imagens ativas.
# Restaurando uma imagem
Quando você restaura uma imagem arquivada, ela é movida da classe de armazenamento ECR Archive de volta para a classe de armazenamento ECR Standard. As imagens restauradas são cobradas de acordo com as taxas de armazenamento padrão. O processo de restauração executa ações semelhantes às que ocorrem quando uma nova imagem é criada:
+ A imagem fica disponível para extração quando a restauração for concluída. A restauração normalmente leva até 20 minutos, embora possa ser concluída mais rapidamente.
+ Se a digitalização por push estiver ativada para o repositório, a imagem restaurada será digitalizada. Observe que os resultados de digitalização anteriores anteriores ao arquivamento da imagem não estarão disponíveis.
+ Se a replicação estiver configurada para o repositório, a imagem restaurada será replicada se a replicação estiver habilitada no momento da restauração.
+ A imagem restaurada aparece na lista de imagens ativas.
A restauração de uma imagem normalmente leva até 20 minutos, embora possa ser concluída mais rapidamente. Durante o processo de restauração, a imagem permanece no estado arquivado e não pode ser extraída até que a restauração seja concluída.
------
#### [ Console de gerenciamento da AWS ]
**Para restaurar uma imagem arquivada**
1. Abra o console do Amazon ECR nos [https://console.aws.amazon.com/ecr/repositórios](https://console.aws.amazon.com/ecr/repositories).
1. Na barra de navegação, escolha a região que contém o repositório com a imagem arquivada que você deseja restaurar.
1. No painel de navegação, escolha **Repositories (Repositórios)**.
1. Na página **Repositórios**, escolha o repositório que contém a imagem arquivada.
1. Escolha a guia **Imagens arquivadas**.
1. Selecione a imagem arquivada que você deseja restaurar.
1. Escolha **Restaurar** e confirme a ação de restauração.
1. Aguarde a conclusão da restauração. A imagem aparecerá na lista de imagens ativas quando a restauração for concluída.
------
#### [ AWS CLI ]
**Para restaurar uma imagem arquivada**
+ Use o **update-image-storage-class** comando para restaurar uma imagem arquivada atualizando sua classe de armazenamento para`STANDARD`:
```
aws ecr update-image-storage-class \
--repository-name my-repository \
--image-id imageDigest=sha256:4f70ef7a4d29e8c0c302b13e25962d8f7a0bd304EXAMPLE \
--target-storage-class STANDARD
```
------
Quando você descreve imagens usando o **describe-images** comando, as imagens que estão sendo restauradas têm um `image-status` de`ACTIVATING`. Você pode filtrar imagens `image-status` com o valor `ACTIVATING` para visualizar as imagens que estão sendo restauradas no momento.
Um método alternativo para restaurar uma imagem arquivada é reenviar a imagem para o repositório. Quando você envia uma imagem que está atualmente arquivada, essa imagem é imediatamente restaurada e removida do arquivamento.