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

# Versi CLI AWS Enkripsi
<a name="crypto-cli-versions"></a>

Kami menyarankan Anda menggunakan CLI AWS Enkripsi versi terbaru.

**catatan**  
[Versi CLI AWS Enkripsi lebih awal dari 4.0.0 sedang dalam fase. end-of-support](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html#version-life-cycle)  
Anda dapat memperbarui dengan aman dari versi 2.1. *x* dan yang lebih baru ke versi terbaru CLI AWS Enkripsi tanpa perubahan kode atau data apa pun. Namun, [fitur keamanan baru](about-versions.md#version-2) diperkenalkan di versi 2.1. *x* tidak kompatibel ke belakang. Untuk memperbarui dari versi 1.7. *x* atau sebelumnya, Anda harus terlebih dahulu memperbarui ke yang terbaru 1. *x* versi CLI AWS Enkripsi. Lihat perinciannya di [Migrasi Anda AWS Encryption SDK](migration.md).  
Fitur keamanan baru awalnya dirilis dalam AWS Enkripsi CLI versi 1.7. *x* dan 2.0. *x*. Namun, AWS Enkripsi CLI versi 1.8. *x* menggantikan versi 1.7. *x* dan AWS Enkripsi CLI 2.1. *x* menggantikan 2.0. *x*. Untuk detailnya, lihat [penasihat keamanan](https://github.com/aws/aws-encryption-sdk-cli/security/advisories/GHSA-2xwp-m7mq-7q3r) yang relevan di [aws-encryption-sdk-cli](https://github.com/aws/aws-encryption-sdk-cli/)repositori di. GitHub

Untuk informasi tentang versi signifikan dari AWS Encryption SDK, lihat[Versi dari AWS Encryption SDK](about-versions.md).

**Versi mana yang saya gunakan?**

Jika Anda baru mengenal CLI AWS Enkripsi, gunakan versi terbaru.

Untuk mendekripsi data yang dienkripsi oleh versi AWS Encryption SDK sebelumnya dari versi 1.7. *x*, migrasi terlebih dahulu ke versi terbaru dari CLI AWS Enkripsi. Buat [semua perubahan yang disarankan](migration-guide.md) sebelum memperbarui ke versi 2.1. *x* atau yang lebih baru. Lihat perinciannya di [Migrasi Anda AWS Encryption SDK](migration.md).

**Pelajari selengkapnya**
+ Untuk informasi terperinci tentang perubahan dan panduan untuk bermigrasi ke versi baru ini, lihat[Migrasi Anda AWS Encryption SDK](migration.md).
+ Untuk deskripsi parameter dan atribut CLI AWS Enkripsi baru, lihat. [AWS Encryption SDK Sintaks CLI dan referensi parameter](crypto-cli-reference.md)

Daftar berikut menjelaskan perubahan CLI AWS Enkripsi di versi 1.8. *x* dan 2.1. *x*.

## Versi 1.8. *x* perubahan pada CLI AWS Enkripsi
<a name="cli-changes-1.7"></a>
+ Menghentikan parameter. `--master-keys` Sebagai gantinya, gunakan `--wrapping-keys` parameternya.
+ Menambahkan parameter `--wrapping-keys` (`-w`). Ini mendukung semua atribut `--master-keys` parameter. Ini juga menambahkan atribut opsional berikut, yang hanya valid saat mendekripsi dengan. AWS KMS keys
  + **penemuan**
  + **penemuan-partisi**
  + **penemuan-akun**

  Untuk penyedia kunci master kustom, `--encrypt` dan - `-decrypt` perintah memerlukan `--wrapping-keys` parameter atau `--master-keys` parameter (tetapi tidak keduanya). Juga, `--encrypt` perintah dengan AWS KMS keys membutuhkan `--wrapping-keys` parameter atau `--master-keys` parameter (tetapi tidak keduanya). 

  Dalam `--decrypt` perintah dengan AWS KMS keys, `--wrapping-keys` parameternya opsional, tetapi disarankan, karena diperlukan dalam versi 2.1. *x*. Jika Anda menggunakannya, Anda harus menentukan atribut **kunci** atau atribut **penemuan** dengan nilai `true` (tetapi tidak keduanya).
+ Menambahkan `--commitment-policy` parameter. Satu-satunya nilai yang valid adalah `forbid-encrypt-allow-decrypt`. Kebijakan `forbid-encrypt-allow-decrypt` komitmen digunakan dalam semua perintah enkripsi dan dekripsi.

  Dalam versi 1.8. *x*, ketika Anda menggunakan `--wrapping-keys` parameter, `--commitment-policy` parameter dengan `forbid-encrypt-allow-decrypt` nilai diperlukan. Menyetel nilai secara eksplisit mencegah [kebijakan komitmen](concepts.md#commitment-policy) Anda berubah secara otomatis menjadi `require-encrypt-require-decrypt` saat Anda meningkatkan ke versi 2.1. *x*.

## Versi 2.1. *x* perubahan pada CLI AWS Enkripsi
<a name="cli-changes-2.x"></a>
+ Menghapus `--master-keys` parameter. Sebagai gantinya, gunakan `--wrapping-keys` parameternya.
+ `--wrapping-keys`Parameter diperlukan di semua perintah enkripsi dan dekripsi. Anda harus menentukan atribut **kunci** atau atribut **penemuan** dengan nilai `true` (tetapi tidak keduanya).
+ `--commitment-policy`Parameter mendukung nilai-nilai berikut. Lihat perinciannya di [Menetapkan kebijakan komitmen Anda](migrate-commitment-policy.md).
  + `forbid-encrypt-allow-decrypt`
  + `require-encrypt-allow-decrypt`
  + `require-encrypt-require decrypt`(Default)
+ `--commitment-policy`Parameternya opsional di versi 2.1. *x*. Nilai default-nya adalah `require-encrypt-require-decrypt`.

## Versi 1.9. *x* dan 2.2. *x* perubahan pada CLI AWS Enkripsi
<a name="cli-changes-2.2"></a>
+ Menambahkan `--decrypt-unsigned` parameter. Lihat perinciannya di [Versi 2.2. *x*](about-versions.md#version2.2.x).
+ Menambahkan `--buffer` parameter. Lihat perinciannya di [Versi 2.2. *x*](about-versions.md#version2.2.x).
+ Menambahkan `--max-encrypted-data-keys` parameter. Lihat perinciannya di [Membatasi kunci data terenkripsi](configure.md#config-limit-keys).

## Versi 3.0. *x* perubahan pada CLI AWS Enkripsi
<a name="cli-changes-v3"></a>
+ Menambahkan dukungan untuk kunci AWS KMS Multi-wilayah. Lihat perinciannya di [Menggunakan Multi-region AWS KMS keys](configure.md#config-mrks).