Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mencegah tag gambar ditimpa di Amazon ECR
<a name="image-tag-mutability"></a>

Anda dapat mencegah tag gambar ditimpa dengan mengaktifkan kekekalan tag di repositori. Setelah kekekalan tag dihidupkan, ` ImageTagAlreadyExistsException` kesalahan dikembalikan jika Anda mendorong gambar dengan tag yang sudah ada di repositori. Kekekalan tag mempengaruhi semua tag. Anda tidak dapat membuat beberapa tag tidak dapat diubah sementara yang lain tidak.

Anda dapat menggunakan Konsol Manajemen AWS dan AWS CLI alat untuk mengatur mutabilitas tag gambar untuk repositori baru atau untuk repositori yang ada. Untuk membuat repositori menggunakan langkah-langkah konsol, lihat. [Membuat repositori pribadi Amazon ECR untuk menyimpan gambar](repository-create.md)

## Mengatur mutabilitas tag gambar ()Konsol Manajemen AWS
<a name="repository-edit"></a>

**Untuk mengatur mutabilitas tag gambar**

1. Buka konsol Amazon ECR di [https://console.aws.amazon.com/ecr/repositories](https://console.aws.amazon.com/ecr/repositories).

1. Dari bilah navigasi, pilih Wilayah yang berisi repositori untuk diedit.

1. **Di panel navigasi, pilih **Repositori** di bawah Registri pribadi.**

   **Jika Anda tidak melihat **Repositori**, pilih **Registri pribadi** untuk memperluas menu dan kemudian pilih Repositori.**

1. Pada halaman **Repositori pribadi**, pilih tombol radio sebelum nama repositori yang ingin Anda atur pengaturan mutabilitas tag gambar. 

1. **Pilih **Tindakan** dan kemudian pilih **Repositori** di bawah Edit.**

1. Untuk **kekekalan tag Gambar**, pilih salah satu pengaturan mutabilitas tag berikut untuk repositori.
   + **Mutable** - Pilih opsi ini jika Anda ingin tag gambar ditimpa. Direkomendasikan untuk repositori yang menggunakan tindakan pull through cache untuk memastikan Amazon ECR dapat memperbarui image yang tersimpan dalam cache. Selain itu, untuk menonaktifkan pembaruan tag untuk beberapa tag yang dapat berubah, masukkan nama tag atau gunakan wildcard (\*) untuk mencocokkan beberapa tag serupa di kotak teks **pengecualian tag Mutable**.
   + **Immutable** - Pilih opsi ini jika Anda ingin mencegah tag gambar ditimpa, dan itu berlaku untuk semua tag dan pengecualian di repositori saat mendorong gambar dengan tag yang ada. Amazon ECR mengembalikan pesan `ImageTagAlreadyExistsException` jika Anda mencoba melakukan push image dengan tag yang ada. Selain itu, untuk mengaktifkan pembaruan tag untuk beberapa tag yang tidak dapat diubah, masukkan nama tag atau gunakan wildcard (\*) untuk mencocokkan beberapa tag serupa di kotak teks pengecualian tag **Immutable**. 

1. Untuk **pengaturan pemindaian Gambar**, sementara Anda dapat menentukan pengaturan pemindaian di tingkat repositori untuk pemindaian dasar, praktik terbaik adalah menentukan konfigurasi pemindaian di tingkat registri pribadi. Tentukan pengaturan pemindaian di registri pribadi memungkinkan Anda mengaktifkan pemindaian yang ditingkatkan atau pemindaian dasar serta menentukan filter untuk menentukan repositori mana yang dipindai. Untuk informasi selengkapnya, lihat [Pindai gambar untuk kerentanan perangkat lunak di Amazon ECR](image-scanning.md).

1. Untuk **pengaturan Enkripsi**, ini adalah bidang tampilan saja karena pengaturan enkripsi untuk repositori tidak dapat diubah setelah repositori dibuat.

1. Pilih **Simpan** untuk memperbarui pengaturan repositori.

## Mengatur mutabilitas tag gambar ()AWS CLI
<a name="image-tag-mutability-cli"></a>

**Untuk membuat repositori dengan tanda tetap terkonfigurasi**

Gunakan salah satu dari perintah berikut untuk membuat repositori citra baru dengan tanda tetap terkonfigurasi.
+ [create-repository](https://docs.aws.amazon.com/cli/latest/reference/ecr/create-repository.html) ()AWS CLI dengan mutabilitas tag gambar

  ```
  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) dengan filter pengecualian mutabilitas tag gambar

  ```
  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) dengan mutabilitas tag gambar

  ```
  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) dengan filter pengecualian mutabilitas tag gambar

  ```
  New-ECRRepository -RepositoryName {{name}} -ImageTagMutability {{IMMUTABLE_WITH_EXCLUSION}} -ImageTagMutabilityExclusionFilter @{FilterType={{WILDCARD}} Filter={{filter-text}}} -Region {{us-east-2}} -Force
  ```

**Untuk memperbarui pengaturan mutabilitas tag gambar untuk repositori**

Gunakan salah satu dari perintah berikut untuk memperbarui pengaturan ketetapan tanda citra untuk repositori yang tersedia.
+ [put-image-tag-mutability () dengan mutabilitas tag](https://docs.aws.amazon.com/cli/latest/reference/ecr/put-image-tag-mutability.html) gambar 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 dengan filter pengecualian mutabilitas](https://docs.aws.amazon.com/cli/latest/reference/ecr/put-image-tag-mutability.html) tag gambar

  ```
  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) dengan mutabilitas tag gambar

  ```
  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) dengan filter pengecualian mutabilitas tag gambar

  ```
  Write-ECRImageTagMutability -RepositoryName {{name}} -ImageTagMutability {{IMMUTABLE_WITH_EXCLUSION}} -ImageTagMutabilityExclusionFilter @{FilterType={{WILDCARD}} Filter={{latest}}}
  ```