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á.
# Impedir que as tags de imagens sejam sobrescritas no Amazon ECR
Você pode impedir que as tags de imagens sejam sobrescritas ao ativar a imutabilidade de tags em um repositório. Depois que a imutabilidade de tags estiver ativada, um erro ` ImageTagAlreadyExistsException` será retornado se você tentar enviar uma imagem por push com uma tag que já existe no repositório. A imutabilidade de tags afeta todas as tags. Você não pode fazer com que algumas tags sejam imutáveis e outras não.
Você pode usar as AWS CLI ferramentas Console de gerenciamento da AWS e para definir a mutabilidade da tag de imagem para um novo repositório ou para um repositório existente. Para criar um repositório usando as etapas do console, consulte [Criar um repositório privado do Amazon ECR para armazenar imagens](repository-create.md).
## Configurar a mutabilidade de tags de imagens (Console de gerenciamento da AWS)
**Para configurar a mutabilidade de tags de imagens**
1. Abra o console do Amazon ECR em [https://console.aws.amazon.com/ecr/repositories](https://console.aws.amazon.com/ecr/repositories).
1. Na barra de navegação, selecione a região que contém o repositório a ser editado.
1. No painel de navegação, selecione **Repositórios** em **Registro privado**.
Se você não vê **Repositórios**, escolha **Registro privado** para expandir o menu e, em seguida, escolha **Repositórios**.
1. Na página **Repositórios privados**, selecione o botão de opção antes do nome do repositório para o qual você deseja definir as configurações de mutabilidade de tag de imagem.
1. Selecione **Ações** e, em seguida, **Repositório** em **Editar**.
1. Para **Mutabilidade de tag de imagem**, escolha uma das configurações de mutabilidade de tag a seguir para o repositório.
+ **Mutável** – Escolha essa opção se quiser que as tags de imagem sejam sobrescritas. É recomendada para repositórios que usam ações de cache de pull-through para garantir que o Amazon ECR possa atualizar imagens armazenadas em cache. Além disso, para desabilitar as atualizações de tag para algumas tags mutáveis, insira os nomes das tags ou use curingas (\*) para combinar várias tags semelhantes na caixa de texto **Exclusão de tag mutável**.
+ **Imutável** – Selecione esta opção se quiser impedir que as tags de imagem sejam sobrescritas. Isso se aplica a todas as tags e exclusões no repositório ao enviar uma imagem com uma tag existente. O Amazon ECR retorna uma `ImageTagAlreadyExistsException` se você tentar enviar uma imagem com uma tag existente. Além disso, para habilitar as atualizações de tag para algumas tags imutáveis, insira os nomes das tags ou use curingas (\*) para combinar várias tags semelhantes na caixa de texto **Exclusão de tag imutável**.
1. Em **Image scan settings** (Configurações de verificação de imagens), embora você possa especificar as configurações de verificação no nível do repositório para uma verificação básica, é prática recomendada especificar a configuração de verificação no nível do registro privado. Especificar as configurações de verificação no registro privado permite habilitar a verificação avançada ou a verificação básica, e também definir filtros para especificar quais repositórios são verificados. Para obter mais informações, consulte [Verificar imagens quanto a vulnerabilidades do software no Amazon ECR](image-scanning.md).
1. Em **Encryption settings** (Configurações de criptografia), este é um campo somente para visualização, pois as configurações de criptografia de um repositório não podem ser alteradas depois que ele é criado.
1. Escolha **Save (Salvar)** para atualizar as configurações do repositório.
## Configurar a mutabilidade de tags de imagens (AWS CLI)
**Como criar um repositório com tags imutáveis configuradas**
Use um dos comandos a seguir para criar um novo repositório de imagens com tags imutáveis configuradas.
+ [create-repository](https://docs.aws.amazon.com/cli/latest/reference/ecr/create-repository.html) (AWS CLI) com mutabilidade de tag de imagem
```
aws ecr create-repository --repository-name {{name}} --image-tag-mutability {{IMMUTABLE}} --region {{us-east-2}}
```
+ [create-repository](https://docs.aws.amazon.com/cli/latest/reference/ecr/create-repository.html) (AWS CLI) com filtros de exclusão de mutabilidade de tag de imagem
```
aws ecr create-repository --repository-name {{name}} --image-tag-mutability {{IMMUTABLE_WITH_EXCLUSION}} --image-tag-mutability-exclusion-filters filterType={{WILDCARD}},filter={{filter-text}} --region {{us-east-2}}
```
+ [New-ECRRepository](https://docs.aws.amazon.com/powershell/latest/reference/items/New-ECRRepository.html)(AWS Tools for Windows PowerShell) com mutabilidade da tag de imagem
```
New-ECRRepository -RepositoryName {{name}} -ImageTagMutability {{IMMUTABLE}} -Region {{us-east-2}} -Force
```
+ [New-ECRRepository](https://docs.aws.amazon.com/powershell/latest/reference/items/New-ECRRepository.html)(AWS Tools for Windows PowerShell) com filtros de exclusão de mutabilidade da tag de imagem
```
New-ECRRepository -RepositoryName {{name}} -ImageTagMutability {{IMMUTABLE_WITH_EXCLUSION}} -ImageTagMutabilityExclusionFilter @{FilterType={{WILDCARD}} Filter={{filter-text}}} -Region {{us-east-2}} -Force
```
**Para atualizar as configurações de mutabilidade de tags de imagens para um repositório**
Use um dos comandos a seguir para atualizar as configurações de mutabilidade de tag de imagem de um repositório existente.
+ [put-image-tag-mutability () com mutabilidade](https://docs.aws.amazon.com/cli/latest/reference/ecr/put-image-tag-mutability.html) da tag de imagem AWS CLI
```
aws ecr put-image-tag-mutability --repository-name {{name}} --image-tag-mutability {{IMMUTABLE}} --region {{us-east-2}}
```
+ [put-image-tag-mutability (AWS CLI) com filtros de exclusão de mutabilidade de](https://docs.aws.amazon.com/cli/latest/reference/ecr/put-image-tag-mutability.html) tag de imagem
```
aws ecr put-image-tag-mutability --repository-name {{name}} --image-tag-mutability {{IMMUTABLE_WITH_EXCLUSION}} --image-tag-mutability-exclusion-filters filterType={{WILDCARD}},filter={{latest}} --region {{us-east-2}}
```
+ [ Write-ECRImageTagMutability](https://docs.aws.amazon.com/powershell/latest/reference/items/Write-ECRImageTagMutability.html)(AWS Tools for Windows PowerShell) com mutabilidade da tag de imagem
```
Write-ECRImageTagMutability -RepositoryName {{name}} -ImageTagMutability {{IMMUTABLE}} -Region {{us-east-2}} -Force
```
+ [ Write-ECRImageTagMutability](https://docs.aws.amazon.com/powershell/latest/reference/items/Write-ECRImageTagMutability.html)(AWS Tools for Windows PowerShell) com filtros de exclusão de mutabilidade da tag de imagem
```
Write-ECRImageTagMutability -RepositoryName {{name}} -ImageTagMutability {{IMMUTABLE_WITH_EXCLUSION}} -ImageTagMutabilityExclusionFilter @{FilterType={{WILDCARD}} Filter={{latest}}}
```