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á.

# Excluir uma imagem no Amazon ECR
<a name="delete_image"></a>

Se você já terminou de usar uma imagem, pode excluí-la do repositório. Se você já terminou de usar um repositório, pode excluir o repositório inteiro e todas as imagens contidas nele. Para obter mais informações, consulte [Excluir um repositório privado do Amazon ECR](repository-delete.md).

Como alternativa a excluir as imagens manualmente, você pode criar políticas de ciclo de vida do repositório que fornecem mais controle sobre o gerenciamento do ciclo de vida das imagens em seus repositórios. As políticas de ciclo de vida automatizam esse processo para você. Para obter mais informações, consulte [Automatizar a limpeza de imagens usando políticas de ciclo de vida no Amazon ECR](LifecyclePolicies.md).

**nota**  
 Se o repositório tiver uma combinação de imagens, algumas das quais tendo sido enviadas por push antes de o Amazon ECR ser compatível com o OCI v1.1, algumas assinaturas terão índices de imagens ou listas de manifestos apontando para elas. Como resultado, ao excluir uma imagem pré-OCI v1.1, talvez seja necessário excluir manualmente a lista de manifestos que faz referência à imagem para poder excluir o artefato.

**Para excluir uma imagem (Console de gerenciamento da AWS)**

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, selecione a região que contém a imagem a ser excluída.

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 a ser excluída.

1. Na *repository\$1name* página **Repositórios:**, selecione a caixa à esquerda da imagem a ser excluída e escolha **Excluir**.

1. Na caixa de diálogo **Excluir imagem(ns)**, verifique se as imagens selecionadas devem ser excluídas e escolha **Excluir**.

**Para excluir uma imagem (AWS CLI)**

1. Listar as imagens no seu repositório. As imagens marcadas terão um resumo de imagem, bem como uma lista de tags associadas. Imagens não marcadas só terão um resumo de imagem.

   ```
   aws ecr list-images \
        --repository-name my-repo
   ```

1. (Opcional) Exclua quaisquer tags indesejáveis da imagem especificando a tag da imagem que você deseja excluir. Quando você excluir a última tag de uma imagem, a imagem será excluída.

   ```
   aws ecr batch-delete-image \
        --repository-name my-repo \
        --image-ids imageTag=tag1 imageTag=tag2
   ```

1. Exclua uma imagem marcada ou não marcada especificando o resumo da imagem. Quando você excluir uma imagem fazendo referência ao seu resumo, a imagem e todas as suas tags serão excluídas.

   ```
   aws ecr batch-delete-image \
        --repository-name my-repo \
        --image-ids imageDigest=sha256:4f70ef7a4d29e8c0c302b13e25962d8f7a0bd304EXAMPLE
   ```

   Para excluir várias imagens, você pode especificar várias tags de imagem ou resumos de imagem na solicitação.

   ```
   aws ecr batch-delete-image \
        --repository-name my-repo \
        --image-ids imageDigest=sha256:4f70ef7a4d29e8c0c302b13e25962d8f7a0bd304EXAMPLE imageDigest=sha256:f5t0e245ssffc302b13e25962d8f7a0bd304EXAMPLE
   ```