Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Panduan migrasi untuk AWS CLI versi 2
Bagian ini berisi instruksi untuk memperbarui AWS CLI versi 1 ke AWS CLI versi 2. AWS CLI Versi 2 dibangun di atas AWS CLI versi 1 dan mencakup fitur dan penyempurnaan berdasarkan umpan balik komunitas. AWS CLI Versi 2 adalah versi utama terbaru AWS CLI dan mendukung semua fitur terbaru. Beberapa fitur yang diperkenalkan di versi 2 tidak di-backport ke versi 1 dan Anda harus meningkatkan untuk mengakses fitur-fitur tersebut.
Untuk mencegah masalah yang tidak terduga, sebelum Anda bermigrasi ke versi 2, [pelajari tentang perbedaan antar versi](cliv2-migration-changes.md). AWS CLI Versi 2 mencakup fitur dan perubahan baru yang mungkin mengharuskan Anda memperbarui skrip atau perintah untuk kompatibilitas mundur.
AWS CLI versi 1 dan 2 menggunakan nama `aws` perintah yang sama. Jika Anda memiliki kedua versi yang diinstal, komputer Anda menggunakan yang pertama ditemukan di jalur pencarian Anda. Ini dapat mengakibatkan nama `aws` perintah Anda memanggil AWS CLI versi lama Anda, bahkan ketika Anda telah menginstal yang baru.
Untuk memperbarui ke AWS CLI versi 2, ikuti salah satu petunjuk di bawah ini:
+ Jika sebelumnya Anda menginstal AWS CLI versi 1, ikuti instruksi di[Menginstal AWS CLI versi 2 dari AWS CLI versi 1](cliv2-migration-instructions.md).
+ Jika Anda belum menginstal AWS CLI versi 1 sebelumnya, ikuti instruksi di[Memulai dengan AWS CLI](cli-chap-getting-started.md).
## Menggunakan Alat Migrasi AWS CLI untuk Mengurangi Kerusakan
Ada perubahan perilaku antara AWS CLI versi 1 dan AWS CLI versi 2 yang mungkin mengharuskan Anda memperbarui skrip atau perintah Anda. Memutakhirkan ke AWS CLI versi 2 tanpa memverifikasi bahwa skrip Anda yang ada dimigrasikan dengan aman berisiko menghadapi efek tak terduga saat menjalankan skrip dengan AWS CLI versi 2, seperti membuat perubahan yang tidak diinginkan pada sumber daya di akun Anda. AWS
Ada dua alat AWS milik yang dapat Anda gunakan untuk memandu migrasi Anda. Terlepas dari alat mana yang Anda gunakan, kami sarankan Anda referensi [Memecahkan perubahan antara AWS CLI versi 1 dan AWS CLI versi 2](cliv2-migration-changes.md#cliv2-migration-changes-breaking) dalam [Fitur baru dan perubahan dalam AWS CLI versi 2](cliv2-migration-changes.md) panduan ini.
### Upgrade Mode Debug
Upgrade mode debug adalah fitur dalam AWS CLI versi 1 yang tersedia dalam `1.44.0` versi dan lebih tinggi. Ketika fitur ini diaktifkan, setiap perintah AWS CLI yang Anda jalankan diperiksa untuk menentukan apakah kemungkinan memiliki perilaku yang berbeda di AWS CLI versi 2, dengan asumsi lingkungan eksekusi tetap sama. Jika perintah yang dijalankan akan memiliki perilaku yang berbeda di AWS CLI versi 2, peringatan akan ditampilkan di samping output perintah dengan tindakan yang disarankan yang dapat diambil untuk mempertahankan perilaku CLI versi 1 di AWS AWS CLI versi 2.
Alasan utama untuk menggunakan mode debug pemutakhiran untuk memandu migrasi Anda adalah karena ia memiliki cakupan yang tinggi untuk mendeteksi apakah perintah akan menghadapi perubahan perilaku. 14 dari 15 perubahan yang melanggar yang dijelaskan dalam [Memecahkan perubahan antara AWS CLI versi 1 dan AWS CLI versi 2](cliv2-migration-changes.md#cliv2-migration-changes-breaking) dapat dideteksi dengan mode debug pemutakhiran—lihat [Batasan](cli-upgrade-debug-mode.md#upgrade-mode-limitations) keterbatasan fitur ini. [Menggunakan mode debug upgrade untuk memutakhirkan AWS CLI versi 1 ke AWS CLI versi 2](cli-upgrade-debug-mode.md) Di sisi lain, kelemahan utama menggunakan mode debug pemutakhiran adalah bahwa outputnya hanya relevan dalam lingkungan pelaksanaannya; jika ada pengaturan konfigurasi AWS CLI yang berubah di lingkungan setelah bermigrasi ke AWS CLI versi 2, perubahan yang melanggar mungkin masih terjadi, dan Anda harus memverifikasi ulang menggunakan mode debug upgrade di lingkungan yang diperbarui.
### AWS Alat Migrasi CLI v1-ke-v2
AWS CLI v1-to-v2 Migration Tool adalah alat mandiri yang dapat digunakan dengan Python 3.9 dan lebih tinggi. Alat ini adalah linter statis yang berjalan secara independen dari AWS CLI. Ini menghubungkan skrip bash yang berisi perintah AWS CLI versi 1 yang mungkin memiliki perilaku berbeda di CLI versi 2. AWS Untuk sebagian besar perintah yang terdeteksi kemungkinan memiliki perilaku yang berbeda di AWS CLI versi 2, ia dapat secara otomatis memperbarui perintah dalam skrip untuk mempertahankan perilaku CLI versi 1 di AWS AWS CLI versi 2.
Alasan utama untuk menggunakan Alat Migrasi AWS CLI v1-ke-v2 untuk memandu migrasi Anda adalah karena ia dapat secara otomatis memperbarui skrip Anda untuk mempertahankan perilaku CLI AWS versi 1 di AWS CLI versi 2, menghemat waktu dan upaya Anda dalam membuat pembaruan sendiri. Di sisi lain, kelemahan utama menggunakan alat migrasi adalah ia memiliki cakupan yang lebih rendah untuk mendeteksi apakah perintah akan menghadapi perubahan perilaku. Menjadi alat statis, itu tidak memeriksa perubahan perilaku yang ditentukan saat runtime.
## Memilih Antara Mode Upgrade Debug dan Alat Migrasi AWS CLI v1-ke-v2
Tabel berikut menyoroti perbedaan utama antara mode debug upgrade dan Alat Migrasi AWS CLI v1-ke-v2, dan dapat digunakan untuk membantu memandu Anda memilih alat yang tepat untuk kasus penggunaan Anda.
| Tingkatkan mode debug | AWS Alat Migrasi CLI v1-ke-v2 |
| --- | --- |
| Mendeteksi 14 dari 15 perubahan yang melanggar antara AWS CLI versi 1 dan AWS CLI versi 2. | Mendeteksi 7 dari 15 perubahan yang melanggar antara AWS CLI versi 1 dan AWS CLI versi 2. |
| Kompatibel dengan program terminal apa pun yang dapat menjalankan AWS CLI. | Hanya mendukung skrip bash linting. |
| Membutuhkan AWS CLI versi 1, versi 1.44.0 atau lebih tinggi. | Berjalan secara independen dari AWS CLI; itu tidak memerlukan AWS CLI untuk diinstal. |
| Perbaikan manual harus dilakukan untuk mempertahankan perilaku AWS CLI versi 1 di AWS CLI versi 2. | Secara otomatis memperbaiki sebagian besar perintah AWS CLI versi 1 yang terdeteksi kemungkinan memiliki perilaku yang berbeda di AWS CLI versi 2. |
| Deteksi dan perbaikan yang disarankan hanya relevan dengan lingkungan eksekusi (yaitu konfigurasi AWS CLI) tempat dieksekusi. | Deteksi dan perbaikan yang disarankan tidak tergantung pada lingkungan. |
| Memerlukan mengeksekusi setiap perintah AWS CLI yang sedang diuji untuk perubahan perilaku. | Tidak memerlukan mengeksekusi perintah AWS CLI apa pun. Hanya perlu dieksekusi sekali per skrip bash. |
| Memiliki tepat 5 kasus yang diketahui di mana ia akan menghasilkan deteksi positif palsu. | Memiliki tepat 3 kasus yang diketahui di mana ia akan menghasilkan deteksi positif palsu. |
Tabel berikut menunjukkan mana yang [Memecahkan perubahan antara AWS CLI versi 1 dan AWS CLI versi 2](cliv2-migration-changes.md#cliv2-migration-changes-breaking) didukung di masing-masing dari dua alat migrasi.
| Melanggar perubahan | Terdeteksi dengan mode upgrade debug | Terdeteksi oleh Alat AWS Migrasi CLI v1-ke-v2 |
| --- | --- | --- |
| [Variabel lingkungan ditambahkan untuk mengatur pengkodean file teks](cliv2-migration-changes.md#cliv2-migration-encodingenvvar) | Ya | Tidak |
| [Parameter biner dilewatkan sebagai string yang dikodekan base64 secara default](cliv2-migration-changes.md#cliv2-migration-binaryparam) | Ya | Ya |
| [Peningkatan penanganan Amazon S3 dari properti file dan tag untuk salinan multipart](cliv2-migration-changes.md#cliv2-migration-s3-copy-metadata) | Ya | Ya |
| [Tidak ada pengambilan otomatis `http://` atau `https://` URLs untuk parameter](cliv2-migration-changes.md#cliv2-migration-paramfile) | Ya | Tidak |
| [Pager digunakan untuk semua output secara default](cliv2-migration-changes.md#cliv2-migration-output-pager) | Ya | Ya |
| [Nilai keluaran stempel waktu distandarisasi ke format ISO 8601](cliv2-migration-changes.md#cliv2-migration-timestamp) | Ya | Tidak |
| [Peningkatan penanganan CloudFormation penerapan yang tidak menghasilkan perubahan](cliv2-migration-changes.md#cliv2-migration-cfn) | Ya | Ya |
| [Mengubah perilaku default untuk titik akhir Amazon S3 Regional untuk Wilayah `us-east-1`](cliv2-migration-changes.md#cliv2-migration-s3-regional-endpoint) | Ya | Tidak |
| [Mengubah perilaku default untuk titik AWS STS akhir Regional](cliv2-migration-changes.md#cliv2-migration-sts-regional-endpoint) | Ya | Tidak |
| [`ecr get-login`dihapus dan diganti dengan `ecr get-login-password`](cliv2-migration-changes.md#cliv2-migration-ecr-get-login) | Ya | Ya |
| [AWS CLI dukungan versi 2 untuk plugin berubah](cliv2-migration-changes.md#cliv2-migration-profile-plugins) | Ya | Tidak |
| [Dukungan alias tersembunyi dihapus](cliv2-migration-changes.md#cliv2-migration-aliases) | Ya | Ya |
| [Pengaturan file `api_versions` konfigurasi tidak didukung](cliv2-migration-changes.md#cliv2-migration-api-versions) | Ya | Tidak |
| [AWS CLI versi 2 hanya menggunakan Signature v4 untuk mengautentikasi permintaan Amazon S3](cliv2-migration-changes.md#cliv2-migration-sigv4) | Ya | Tidak |
| [AWS CLI versi 2 lebih konsisten dengan parameter paging](cliv2-migration-changes.md#cliv2-migration-skeleton-paging) | Ya | Ya |
| [AWS CLI versi 2 menyediakan kode pengembalian yang lebih konsisten di semua perintah](cliv2-migration-changes.md#cliv2-migration-return-codes) | Tidak | Tidak |
## Topik tambahan di bagian ini
+ [Fitur baru dan perubahan dalam AWS CLI versi 2](cliv2-migration-changes.md)
+ [Menginstal AWS CLI versi 2 dari AWS CLI versi 1](cliv2-migration-instructions.md)
+ [Menggunakan mode debug upgrade untuk memutakhirkan AWS CLI versi 1 ke AWS CLI versi 2](cli-upgrade-debug-mode.md)
+ [Menggunakan Alat Migrasi AWS CLI v1-ke-v2 untuk meningkatkan CLI versi 1 ke CLI AWS versi 2 AWS](cli-migration-tool.md)
# Fitur baru dan perubahan dalam AWS CLI versi 2
Topik ini menjelaskan fitur baru dan perubahan perilaku antara AWS CLI versi 1 dan AWS CLI versi 2. Perubahan ini mungkin mengharuskan Anda memperbarui skrip atau perintah untuk mendapatkan perilaku yang sama di versi 2 seperti yang Anda lakukan di versi 1.
**Topics**
+ [AWS CLI versi 2 fitur baru](#cliv2-migration-changes-features)
+ [Memecahkan perubahan antara AWS CLI versi 1 dan AWS CLI versi 2](#cliv2-migration-changes-breaking)
## AWS CLI versi 2 fitur baru
AWS CLI Versi 2 adalah versi utama terbaru AWS CLI dan mendukung semua fitur terbaru. Beberapa fitur yang diperkenalkan di versi 2 tidak di-backport ke versi 1 dan Anda harus meningkatkan untuk mengakses fitur-fitur tersebut. Fitur-fitur ini mencakup hal-hal berikut:
**Penerjemah Python tidak diperlukan**
AWS CLI Versi 2 tidak memerlukan instalasi Python yang terpisah. Ini termasuk versi tertanam.
**[Penyihir](cli-usage-wizard.md)**
Anda dapat menggunakan wizard dengan AWS CLI versi 2. Wizard memandu Anda melalui pembuatan perintah tertentu.
**[Autentikasi Pusat Identitas IAMKonsep Pusat Identitas IAMTutorial: AWS IAM Identity Center dan Amazon S3AWS CLI contoh](cli-configure-sso.md)**
Jika organisasi Anda menggunakan AWS IAM Identity Center (Pusat Identitas IAM), pengguna Anda dapat masuk ke Active Directory, direktori Pusat Identitas IAM bawaan, atau [iDP lain yang terhubung ke Pusat Identitas](https://docs.aws.amazon.com/singlesignon/latest/userguide/manage-your-identity-source-idp.html) IAM. Kemudian, mereka dipetakan ke peran AWS Identity and Access Management (IAM) yang memungkinkan Anda menjalankan AWS CLI perintah.
**[Prompt otomatis](cli-usage-parameters-prompting.md)**
Saat diaktifkan, AWS CLI versi 2 dapat meminta Anda untuk perintah, parameter, dan sumber daya saat Anda menjalankan `aws` perintah.
**[Menjalankan gambar Amazon ECR Public atau Docker resmi untuk AWS CLI](getting-started-docker.md)**
Gambar Docker resmi untuk AWS CLI menyediakan isolasi, portabilitas, dan keamanan yang AWS secara langsung mendukung dan memelihara. Dengan cara ini, Anda dapat menggunakan AWS CLI versi 2 di lingkungan berbasis wadah tanpa harus mengelola instalasi sendiri.
**[Pager sisi klien](cli-usage-pagination.md#cli-usage-pagination-clientside)**
AWS CLI Versi 2 menyediakan penggunaan program pager sisi klien untuk output. Secara default, fitur ini diaktifkan dan mengembalikan semua output melalui program pager default sistem operasi Anda.
**[`aws configure import`](cli-configure-files.md#cli-config-aws_configure_import)**
Impor `.csv` kredensil yang dihasilkan dari file. Konsol Manajemen AWS`.csv`File diimpor dengan nama profil yang cocok dengan nama pengguna IAM.
**[https://docs.aws.amazon.com/cli/latest/reference/configure/list-profiles.html](https://docs.aws.amazon.com/cli/latest/reference/configure/list-profiles.html)**
Daftar nama semua profil yang telah Anda konfigurasikan.
**[Format keluaran aliran YAMAL](cli-usage-output-format.md#yaml-stream-output)**
`yaml-stream`Format `yaml` dan memanfaatkan format [YAMAL](https://yaml.org) sambil memberikan tampilan kumpulan data besar yang lebih responsif dengan mengalirkan data kepada Anda. Anda dapat mulai melihat dan menggunakan data YAMB sebelum seluruh unduhan kueri.
**[`ddb`Perintah tingkat tinggi baru untuk DynamoDB](https://docs.aws.amazon.com/cli/latest/reference/ddb/index.html)**
AWS CLI Versi 2 memiliki perintah Amazon [https://docs.aws.amazon.com/cli/latest/reference/api/latest/reference/ddb/put.html](https://docs.aws.amazon.com/cli/latest/reference/api/latest/reference/ddb/put.html)DynamoDB tingkat tinggi dan. Perintah ini menyediakan antarmuka yang disederhanakan untuk menempatkan item dalam tabel DynamoDB dan mencari di tabel atau indeks DynamoDB.
**[https://docs.aws.amazon.com/cli/latest/reference/logs/tail.html](https://docs.aws.amazon.com/cli/latest/reference/logs/tail.html)**
AWS CLI Versi 2 memiliki `aws logs tail` perintah khusus yang mengekor log untuk grup Amazon CloudWatch Logs. Secara default, perintah mengembalikan log dari semua aliran CloudWatch Log terkait selama sepuluh menit terakhir.
**[Menambahkan dukungan metadata untuk perintah tingkat tinggi `s3`](cli-services-s3-commands.md#using-s3-commands-before-large)**
AWS CLI Versi 2 menambahkan `--copy-props` parameter ke `s3` perintah tingkat tinggi. Dengan parameter ini, Anda dapat mengonfigurasi metadata dan tag tambahan untuk Amazon Simple Storage Service (Amazon S3).
**[`AWS_REGION`](cli-configure-envvars.md#envvars-list-AWS_REGION)**
AWS CLI Versi 2 memiliki variabel lingkungan yang AWS kompatibel dengan SDK yang disebut. `AWS_REGION` Variabel ini menentukan Wilayah AWS untuk mengirim permintaan ke. Ini mengesampingkan variabel `AWS_DEFAULT_REGION` lingkungan, yang hanya berlaku di. AWS CLI
## Memecahkan perubahan antara AWS CLI versi 1 dan AWS CLI versi 2
Bagian ini menjelaskan semua perubahan perilaku antara AWS CLI versi 1 dan AWS CLI versi 2. Perubahan ini mungkin mengharuskan Anda memperbarui skrip atau perintah untuk mendapatkan perilaku yang sama di versi 2 seperti yang Anda lakukan di versi 1.
**Topics**
+ [Variabel lingkungan ditambahkan untuk mengatur pengkodean file teks](#cliv2-migration-encodingenvvar)
+ [Parameter biner dilewatkan sebagai string yang dikodekan base64 secara default](#cliv2-migration-binaryparam)
+ [Peningkatan penanganan Amazon S3 dari properti file dan tag untuk salinan multipart](#cliv2-migration-s3-copy-metadata)
+ [Tidak ada pengambilan otomatis `http://` atau `https://` URLs untuk parameter](#cliv2-migration-paramfile)
+ [Pager digunakan untuk semua output secara default](#cliv2-migration-output-pager)
+ [Nilai keluaran stempel waktu distandarisasi ke format ISO 8601](#cliv2-migration-timestamp)
+ [Peningkatan penanganan CloudFormation penerapan yang tidak menghasilkan perubahan](#cliv2-migration-cfn)
+ [Mengubah perilaku default untuk titik akhir Amazon S3 Regional untuk Wilayah `us-east-1`](#cliv2-migration-s3-regional-endpoint)
+ [Mengubah perilaku default untuk titik AWS STS akhir Regional](#cliv2-migration-sts-regional-endpoint)
+ [`ecr get-login`dihapus dan diganti dengan `ecr get-login-password`](#cliv2-migration-ecr-get-login)
+ [AWS CLI dukungan versi 2 untuk plugin berubah](#cliv2-migration-profile-plugins)
+ [Dukungan alias tersembunyi dihapus](#cliv2-migration-aliases)
+ [Pengaturan file `api_versions` konfigurasi tidak didukung](#cliv2-migration-api-versions)
+ [AWS CLI versi 2 hanya menggunakan Signature v4 untuk mengautentikasi permintaan Amazon S3](#cliv2-migration-sigv4)
+ [AWS CLI versi 2 lebih konsisten dengan parameter paging](#cliv2-migration-skeleton-paging)
+ [AWS CLI versi 2 menyediakan kode pengembalian yang lebih konsisten di semua perintah](#cliv2-migration-return-codes)
### Variabel lingkungan ditambahkan untuk mengatur pengkodean file teks
Secara default, file teks untuk [blob](cli-usage-parameters-types.md#parameter-type-blob) menggunakan pengkodean yang sama dengan lokal yang diinstal. Karena AWS CLI versi 2 menggunakan versi Python yang disematkan, variabel `PYTHONUTF8` dan `PYTHONIOENCODING` lingkungan tidak didukung. Untuk mengatur pengkodean file teks agar berbeda dari lokal, gunakan variabel `AWS_CLI_FILE_ENCODING` lingkungan. Contoh berikut menetapkan AWS CLI untuk membuka file teks menggunakan `UTF-8` pada Windows.
```
AWS_CLI_FILE_ENCODING=UTF-8
```
Untuk informasi selengkapnya, lihat [Mengkonfigurasi variabel lingkungan untuk AWS CLI](cli-configure-envvars.md).
### Parameter biner dilewatkan sebagai string yang dikodekan base64 secara default
Dalam AWS CLI, beberapa perintah memerlukan string [base64](https://wikipedia.org/wiki/Base64) -encoded, sementara yang lain memerlukan string byte yang dikodekan UTF-8. Dalam AWS CLI versi 1, meneruskan data antara dua jenis string yang dikodekan sering memerlukan beberapa pemrosesan perantara. AWS CLI Versi 2 membuat penanganan parameter biner lebih konsisten, yang membantu meneruskan nilai dari satu perintah ke perintah lainnya dengan lebih andal.
Secara default, AWS CLI versi 2 melewati semua parameter input biner dan output biner sebagai string yang dikodekan base64 `blobs` (objek besar biner). Untuk informasi selengkapnya, lihat [blob](cli-usage-parameters-types.md#parameter-type-blob).
Untuk kembali ke perilaku AWS CLI versi 1, gunakan konfigurasi `cli\$1binary\$1format` file atau `--cli-binary-format` parameter.
### Peningkatan penanganan Amazon S3 dari properti file dan tag untuk salinan multipart
Saat Anda menggunakan perintah AWS CLI versi 1 di `aws s3` namespace untuk menyalin file dari satu lokasi bucket S3 ke lokasi bucket lainnya, dan operasi tersebut menggunakan [salinan multipart](https://docs.aws.amazon.com/AmazonS3/latest/userguide/CopyingObjctsMPUapi.html), tidak ada properti file dari objek sumber yang disalin ke objek tujuan.
Secara default, perintah yang sesuai di AWS CLI versi 2 mentransfer semua tag dan beberapa properti dari sumber ke salinan tujuan. Dibandingkan dengan AWS CLI versi 1, ini dapat menghasilkan lebih banyak panggilan AWS API yang dilakukan ke titik akhir Amazon S3. Untuk mengubah perilaku default untuk `s3` perintah di AWS CLI versi 2, gunakan `--copy-props` parameter.
Untuk informasi selengkapnya, lihat [Properti file dan tag dalam salinan multipart](cli-services-s3-commands.md#using-s3-commands-before-tags).
### Tidak ada pengambilan otomatis `http://` atau `https://` URLs untuk parameter
AWS CLI Versi 2 tidak melakukan `GET` operasi ketika nilai parameter dimulai dengan `http://` atau`https://`, dan tidak menggunakan konten yang dikembalikan sebagai nilai parameter. Akibatnya, opsi baris perintah terkait `cli_follow_urlparam` dihapus dari AWS CLI versi 2.
Jika Anda perlu mengambil URL dan meneruskan konten URL ke nilai parameter, kami sarankan Anda menggunakan `curl` atau alat serupa untuk mengunduh konten URL ke file lokal. Kemudian, gunakan `file://` sintaks untuk membaca isi file itu dan menggunakannya sebagai nilai parameter.
Misalnya, perintah berikut tidak lagi mencoba untuk mengambil isi halaman yang ditemukan di `http://www.example.com` dan meneruskan konten tersebut sebagai parameter. Sebaliknya, ia melewati string teks literal `https://example.com` sebagai parameter.
```
$ aws ssm put-parameter \
--value http://www.example.com \
--name prod.microservice1.db.secret \
--type String 2
```
Jika Anda perlu mengambil dan menggunakan konten URL web sebagai parameter, Anda dapat melakukan hal berikut di versi 2.
```
$ curl https://my.example.com/mypolicyfile.json -o mypolicyfile.json
$ aws iam put-role-policy \
--policy-document file://./mypolicyfile.json \
--role-name MyRole \
--policy-name MyReadOnlyPolicy
```
Pada contoh sebelumnya, `-o` parameter memberitahu `curl` untuk menyimpan file di folder saat ini dengan nama yang sama dengan file sumber. Perintah kedua mengambil konten dari file yang diunduh dan meneruskan konten sebagai nilai. `--policy-document`
### Pager digunakan untuk semua output secara default
Secara default, AWS CLI versi 2 mengembalikan semua output melalui program pager default sistem operasi Anda. Program ini adalah [https://ss64.com/bash/less.html](https://ss64.com/bash/less.html)program di Linux atau macOS, dan [https://docs.microsoft.com/windows-server/administration/windows-commands/more](https://docs.microsoft.com/windows-server/administration/windows-commands/more)program di Windows. Ini dapat membantu Anda menavigasi sejumlah besar output dari layanan dengan menampilkan output itu satu halaman pada satu waktu.
Anda dapat mengonfigurasi AWS CLI versi 2 untuk menggunakan program paging yang berbeda atau tidak sama sekali. Untuk informasi selengkapnya, lihat [Pager sisi klien](cli-usage-pagination.md#cli-usage-pagination-clientside).
### Nilai keluaran stempel waktu distandarisasi ke format ISO 8601
Secara default, AWS CLI versi 2 mengembalikan semua nilai respons stempel waktu dalam format [ISO 8601](https://wikipedia.org/wiki/ISO_8601). Di AWS CLI versi 1, perintah mengembalikan nilai stempel waktu dalam format apa pun yang dikembalikan oleh respons HTTP API, yang dapat bervariasi dari layanan ke layanan.
Untuk melihat stempel waktu dalam format yang ditampilkan oleh respons HTTP API, gunakan `wire` nilai dalam file Anda`config`. Untuk informasi selengkapnya, lihat `cli\$1timestamp\$1format`.
### Peningkatan penanganan CloudFormation penerapan yang tidak menghasilkan perubahan
Secara default di AWS CLI versi 1, jika Anda menerapkan CloudFormation template yang tidak menghasilkan perubahan, kode kesalahan akan AWS CLI dikembalikan. Ini menyebabkan masalah jika Anda tidak menganggap itu sebagai kesalahan dan Anda ingin skrip Anda berlanjut. Anda dapat mengatasi ini di AWS CLI versi 1 dengan menambahkan bendera`-–no-fail-on-empty-changeset`, yang kembali`0`.
Karena ini adalah kasus penggunaan umum, AWS CLI versi 2 default mengembalikan kode keluar yang berhasil `0` ketika tidak ada perubahan yang disebabkan oleh penerapan dan operasi mengembalikan set perubahan kosong.
Untuk kembali ke perilaku asli, tambahkan bendera`--fail-on-empty-changeset`.
### Mengubah perilaku default untuk titik akhir Amazon S3 Regional untuk Wilayah `us-east-1`
Saat Anda mengonfigurasi AWS CLI versi 1 untuk menggunakan `us-east-1` Wilayah, maka akan AWS CLI menggunakan `s3.amazonaws.com` titik akhir global yang dihosting secara fisik di `us-east-1` Wilayah. AWS CLI Versi 2 menggunakan titik akhir Regional yang sebenarnya `s3.us-east-1.amazonaws.com` ketika Region tersebut ditentukan. Untuk memaksa AWS CLI versi 2 menggunakan titik akhir global, Anda dapat mengatur Region untuk `aws-global` perintah.
### Mengubah perilaku default untuk titik AWS STS akhir Regional
Secara default, AWS CLI versi 2 mengirimkan semua AWS Security Token Service (AWS STS) permintaan API ke titik akhir Regional untuk yang saat ini dikonfigurasi Wilayah AWS.
Secara default, rilis apa pun sebelumnya `1.42.0` untuk AWS CLI versi 1 mengirimkan AWS STS permintaan ke AWS STS titik akhir global. Anda dapat mengontrol perilaku default ini di versi 1 dengan menggunakan [https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html#cli-config-sts_regional_endpoints](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html#cli-config-sts_regional_endpoints)pengaturan.
Setiap rilis pada atau setelah `1.42.0` menggunakan titik akhir Regional sebagai default, jika Anda bermigrasi ke AWS CLI versi 2 dari rilis yang lebih baru ini, perilaku ini tetap tidak berubah.
### `ecr get-login`dihapus dan diganti dengan `ecr get-login-password`
AWS CLI Versi 2 menggantikan perintah `aws ecr get-login` dengan `aws ecr get-login-password` perintah yang meningkatkan integrasi otomatis dengan otentikasi kontainer.
`aws ecr get-login-password`Perintah mengurangi risiko mengekspos kredensialmu dalam daftar proses, riwayat shell, atau file log lainnya. Ini juga meningkatkan kompatibilitas dengan `docker login` perintah untuk otomatisasi yang lebih baik.
`aws ecr get-login-password`Perintah ini tersedia dalam AWS CLI versi 1.17.10 dan yang lebih baru, dan AWS CLI versi 2. `aws ecr get-login`Perintah sebelumnya masih tersedia di AWS CLI versi 1 untuk kompatibilitas mundur.
Dengan `aws ecr get-login-password` perintah tersebut, Anda dapat mengganti kode berikut yang mengambil kata sandi.
```
$ (aws ecr get-login --no-include-email)
```
Untuk mengurangi risiko mengekspos kata sandi ke riwayat shell atau log, gunakan perintah contoh berikut sebagai gantinya. Dalam contoh ini, kata sandi disalurkan langsung ke `docker login` perintah, di mana ia ditetapkan ke parameter kata sandi dengan `--password-stdin` opsi.
```
$ aws ecr get-login-password | docker login --username AWS --password-stdin MY-REGISTRY-URL
```
Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/cli/latest/reference/ecr/get-login-password.html](https://docs.aws.amazon.com/cli/latest/reference/ecr/get-login-password.html)di *Panduan Referensi AWS CLI versi 2*.
### AWS CLI dukungan versi 2 untuk plugin berubah
Dukungan plugin di AWS CLI versi 2 sepenuhnya sementara dan dimaksudkan untuk membantu pengguna bermigrasi dari AWS CLI versi 1 hingga antarmuka plugin yang stabil dan diperbarui dirilis. Tidak ada jaminan bahwa plugin tertentu atau bahkan antarmuka AWS CLI plugin akan didukung di versi masa depan AWS CLI versi 2. Jika Anda mengandalkan plugin, pastikan untuk mengunci ke versi tertentu dari AWS CLI dan menguji fungsionalitas plugin Anda ketika Anda melakukan upgrade.
Untuk mengaktifkan dukungan plugin, buat `[plugins]` bagian di bagian Anda`~/.aws/config`.
```
[plugins]
cli_legacy_plugin_path = /python3.7/site-packages
=
```
Di `[plugins]` bagian ini, tentukan `cli_legacy_plugin_path` variabel dan atur nilainya ke jalur paket situs Python tempat modul plugin Anda berada. Kemudian, Anda dapat mengkonfigurasi plugin dengan memberikan nama untuk plugin (`plugin-name`) dan nama file modul Python (`plugin-module`) yang berisi kode sumber untuk plugin Anda. AWS CLI Memuat setiap plugin dengan mengimpor `plugin-module` dan memanggil `awscli_initialize` fungsinya.
### Dukungan alias tersembunyi dihapus
AWS CLI versi 2 tidak lagi mendukung alias tersembunyi berikut yang didukung di versi 1.
Pada tabel berikut, kolom pertama menampilkan layanan, perintah, dan parameter yang berfungsi di semua versi, termasuk AWS CLI versi 2. Kolom kedua menampilkan alias yang tidak lagi berfungsi di AWS CLI versi 2.
| Layanan kerja, perintah, dan parameter | Alias usang |
| --- | --- |
| kognito-identitas -arns create-identity-pool open-id-connect-provider | open-id-connect-provider-ar-ns |
| storagegateway mendeskripsikan kaset-kaset-arns | tape-ar-ns |
| Storagegateway. describe-tape-archives.tape-arns | tape-ar-ns |
| Storagegateway. describe-vtl-devices. vtl-device-arns | vtl-device-ar-ns |
| Storagegateway. describe-cached-iscsi-volumes.volume-arns | volume-ar-ns |
| Storagegateway. describe-stored-iscsi-volumes.volume-arns | volume-ar-ns |
| route53domains.view-billing.start-time | start |
| menyebarkan. create-deployment-group.ec2-tag-set | ec-2-tag-set |
| menyebarkan. list-application-revisions.s3-ember | s-3-ember |
| menyebarkan. list-application-revisions.s3-kunci-awalan | awalan s-3-kunci- |
| menyebarkan. update-deployment-group.ec2-tag-set | ec-2-tag-set |
| saya. enable-mfa-device.otentikasi-kode1 | otentikasi-kode-1 |
| saya. enable-mfa-device.otentikasi-kode2 | otentikasi-kode-2 |
| saya. resync-mfa-device.otentikasi-kode1 | otentikasi-kode-1 |
| saya. resync-mfa-device.otentikasi-kode2 | otentikasi-kode-2 |
| impor ekspor. get-shipping-label.jalan1 | jalan-1 |
| impor ekspor. get-shipping-label.jalan2 | jalan-2 |
| impor ekspor. get-shipping-label.jalan3 | jalan-3 |
| lambda.publish-version.code-sha256 | kode-sha-256 |
| lightsail. import-key-pair. public-key-base64 | public-key-base-64 |
| opsworks.register-volume.ec2-volume-id | ec-2-volume id |
### Pengaturan file `api_versions` konfigurasi tidak didukung
AWS CLI Versi 2 tidak mendukung panggilan versi AWS layanan sebelumnya APIs dengan menggunakan pengaturan file `api_versions` konfigurasi. Semua AWS CLI perintah sekarang memanggil versi terbaru dari layanan APIs yang saat ini didukung oleh endpoint.
### AWS CLI versi 2 hanya menggunakan Signature v4 untuk mengautentikasi permintaan Amazon S3
AWS CLI Versi 2 tidak mendukung algoritme tanda tangan sebelumnya untuk mengautentikasi permintaan layanan secara kriptografis yang dikirim ke titik akhir Amazon S3. Penandatanganan ini terjadi secara otomatis dengan setiap permintaan Amazon S3 dan hanya [Proses Penandatanganan Versi Tanda Tangan 4](https://docs.aws.amazon.com/AmazonS3/latest/userguide/reference_aws-signing.html) yang didukung. Anda tidak dapat mengonfigurasi versi tanda tangan. Semua bucket Amazon S3 presigned URLs sekarang hanya menggunakan SiGv4 dan memiliki durasi kedaluwarsa maksimum satu minggu.
### AWS CLI versi 2 lebih konsisten dengan parameter paging
Dalam AWS CLI versi 1, jika Anda menentukan parameter pagination pada baris perintah, maka pagination otomatis dimatikan seperti yang diharapkan. Namun, ketika Anda menentukan parameter pagination dengan menggunakan file dengan `‐‐cli-input-json` parameter, pagination otomatis tidak dimatikan, yang dapat menghasilkan output yang tidak terduga. AWS CLI Versi 2 mematikan pagination otomatis terlepas dari bagaimana Anda memberikan parameter.
### AWS CLI versi 2 menyediakan kode pengembalian yang lebih konsisten di semua perintah
AWS CLI Versi 2 lebih konsisten di semua perintah dan mengembalikan kode keluar yang sesuai dengan AWS CLI versi 1 dengan benar. Kami juga menambahkan kode keluar 252, 253, dan 254. Untuk informasi selengkapnya tentang kode keluar, lihat[Kode pengembalian baris perintah di AWS CLI](cli-usage-returncodes.md).
Jika Anda memiliki ketergantungan pada bagaimana AWS CLI versi 1 menggunakan nilai kode pengembalian, kami sarankan untuk memeriksa kode keluar untuk memastikan bahwa Anda mendapatkan nilai yang Anda harapkan.
# Menginstal AWS CLI versi 2 dari AWS CLI versi 1
Topik ini memberikan petunjuk untuk bermigrasi dari AWS CLI versi 1 ke AWS CLI versi 2.
AWS CLI versi 1 dan 2 menggunakan nama `aws` perintah yang sama. Jika Anda memiliki kedua versi yang diinstal, komputer Anda menggunakan yang pertama ditemukan di jalur pencarian Anda. Jika sebelumnya Anda menginstal AWS CLI versi 1, kami sarankan Anda melakukan salah satu hal berikut untuk menggunakan AWS CLI versi 2:
+ **Direkomendasikan** - [Copot pemasangan AWS CLI versi 1 dan gunakan hanya AWS CLI versi 2](#cliv2-migration-instructions-migrate).
+ [Untuk menginstal kedua versi](#cliv2-migration-instructions-side-by-side), gunakan kemampuan sistem operasi Anda untuk membuat tautan simbolik (symlink) atau alias dengan nama yang berbeda untuk salah satu dari dua perintah. `aws`
Untuk informasi tentang melanggar perubahan antara versi 1 dan versi 2, lihat[Fitur baru dan perubahan dalam AWS CLI versi 2](cliv2-migration-changes.md).
## Mengganti versi 1 dengan versi 2
Lakukan langkah-langkah berikut untuk mengganti AWS CLI versi 1 dengan AWS CLI versi 2.
**Untuk mengganti AWS CLI versi 1 dengan AWS CLI versi 2**
1. Siapkan skrip yang ada yang Anda miliki untuk migrasi dengan mengonfirmasi setiap perubahan yang melanggar antara versi 1 dan versi 2 di[Fitur baru dan perubahan dalam AWS CLI versi 2](cliv2-migration-changes.md). Anda dapat menggunakan fitur mode upgrade debug untuk memandu persiapan Anda dengan mengikuti petunjuk di[Menggunakan mode debug upgrade untuk memutakhirkan AWS CLI versi 1 ke AWS CLI versi 2](cli-upgrade-debug-mode.md).
1. Copot pemasangan AWS CLI versi 1 dengan mengikuti petunjuk uninstall untuk sistem operasi Anda di [Menginstal, memperbarui, dan menghapus instalan](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html) versi 1. AWS CLI
1. Konfirmasikan bahwa AWS CLI sudah benar-benar dihapus dengan menggunakan perintah berikut.
```
$ aws --version
```
Lengkapi salah satu dari berikut ini berdasarkan output:
+ **Tidak ada versi yang dikembalikan:** Anda telah berhasil menghapus AWS CLI versi 1 dan dapat melanjutkan ke langkah berikutnya.
+ **Versi dikembalikan:** Anda masih memiliki instalasi AWS CLI versi 1. Untuk langkah-langkah pemecahan masalah, lihat [Perintah `aws --version` "" mengembalikan versi setelah mencopot pemasangan AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1). Lakukan langkah pemecahan masalah hingga tidak ada keluaran versi yang diterima.
1. Instal AWS CLI versi 2 dengan mengikuti petunjuk penginstalan yang sesuai untuk sistem operasi Anda di[Menginstal atau memperbarui ke versi terbaru dari AWS CLI](getting-started-install.md).
## Side-by-side menginstal
Untuk menginstal kedua versi, gunakan kemampuan sistem operasi Anda untuk membuat tautan simbolik (symlink) atau alias dengan nama yang berbeda untuk salah satu dari dua perintah. `aws`
1. Instal AWS CLI versi 2 dengan mengikuti petunjuk penginstalan yang sesuai untuk sistem operasi Anda di[Menginstal atau memperbarui ke versi terbaru dari AWS CLI](getting-started-install.md).
1. Gunakan kemampuan sistem operasi Anda untuk membuat symlink atau alias dengan nama yang berbeda untuk salah satu dari dua `aws` perintah, seperti menggunakan *`aws2`* untuk AWS CLI versi 2. Berikut ini adalah contoh symlink untuk AWS CLI versi 2. Ganti *PATH* dengan lokasi pemasangan Anda.
------
#### [ Linux and macOS ]
Anda dapat menggunakan [tautan simbolis](https://www.linux.com/topic/desktop/understanding-linux-links/) atau [alias](https://www.linux.com/topic/desktop/aliases-diy-shell-commands/) di Linux dan macOS.
```
$ alias aws2='PATH'
```
------
#### [ Windows command prompt ]
[https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/doskey](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/doskey)di Windows.
```
C:\> doskey aws2=PATH
```
------
# Menggunakan mode debug upgrade untuk memutakhirkan AWS CLI versi 1 ke AWS CLI versi 2
Topik ini menjelaskan mode debug pemutakhiran di AWS CLI versi 1.
Kami merekomendasikan agar pengguna AWS CLI versi 1 meningkatkan ke AWS CLI versi 2 untuk mengakses fitur baru dan meningkatkan kinerja. Ada perubahan perilaku antara AWS CLI versi 1 dan AWS CLI versi 2 yang mungkin mengharuskan Anda memperbarui skrip atau perintah untuk mendapatkan perilaku yang sama. Mode debug pemutakhiran di AWS CLI versi 1 mengeluarkan peringatan saat Anda menggunakan fitur yang memiliki perilaku berbeda di AWS CLI versi 2. Fitur ini meningkatkan pengalaman peningkatan dengan secara otomatis mendeteksi perintah AWS CLI versi 1 Anda yang perlu dimodifikasi sebelum memutakhirkan ke CLI versi 2 AWS untuk mencegah masalah yang tidak terduga.
Untuk detail lebih lanjut, lihat [Memecahkan perubahan antara AWS CLI versi 1 dan AWS CLI versi 2](cliv2-migration-changes.md#cliv2-migration-changes-breaking) di[Fitur baru dan perubahan dalam AWS CLI versi 2](cliv2-migration-changes.md).
## Prasyarat
Fitur mode debug upgrade diperkenalkan ke AWS CLI dalam versi. `1.44.0`
Menggunakan AWS CLI versi 1, jalankan`aws --version`, dan verifikasi bahwa versi AWS CLI atau lebih tinggi. `1.44.0`
Jika versinya kurang dari`1.44.0`, lihat [Menginstal, memperbarui, dan menghapus AWS CLI](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html).
## Cara kerjanya
Jika diaktifkan, mode debug pemutakhiran mendeteksi penggunaan fitur yang diperbarui dengan perubahan yang melanggar pada AWS CLI versi 2. Jika Anda menggunakan perintah atau fitur yang tercantum di kami [Memecahkan perubahan antara AWS CLI versi 1 dan AWS CLI versi 2](cliv2-migration-changes.md#cliv2-migration-changes-breaking) setelah memutakhirkan ke AWS CLI versi 2, peringatan akan ditampilkan di output. Deteksi perubahan yang melanggar didasarkan pada perintah yang digunakan, argumen yang diberikan, lingkungan eksekusi (misalnya variabel lingkungan, pengaturan konfigurasi, dll.), Dan untuk beberapa kasus, konten atau konfigurasi sumber daya dalam AWS akun yang digunakan.
Peringatan menjelaskan tindakan untuk mencegah masalah tak terduga dari peningkatan ke AWS CLI versi 2. Setelah membuat perubahan yang direkomendasikan oleh pesan peringatan, Anda dapat mengonfirmasi bahwa perintah telah berhasil diperbarui dengan menjalankan kembali perintah untuk memverifikasi peringatan tidak lagi ditampilkan. Peringatan yang diselesaikan menandakan bahwa perintah tidak lagi mungkin mengalami perubahan yang melanggar yang dijelaskan saat memutakhirkan ke AWS CLI versi 2.
Contoh berikut menunjukkan seperti apa peringatan ini. Perintah ini menunjukkan contoh peringatan. Semua teks peringatan dimulai dengan "AWS CLI V2 UPGRADE WARNING,” diikuti oleh pesan peringatan khusus. Dalam hal ini, peringatan adalah output karena perintah bergantung pada AWS CLI untuk mengambil konten URL dan menggunakan konten sebagai nilai parameter, yang merupakan `--template-body` fitur yang dihapus dalam AWS CLI versi 2.
```
$ aws cloudformation create-stack \
--stack-name "stack012345" \
--template-body "https://s3.amazonaws.com/amzn-s3-demo-bucket/template.json"
AWS CLI v2 UPGRADE WARNING: For input parameters that have a prefix of http:// or
https://, AWS CLI v2 will not automatically request the content of the URL for
the parameter, and the `cli_follow_urlparam` option has been removed. See
https://docs.aws.amazon.com/cli/latest/userguide/cliv2-migration-changes.html#cliv2-migration-paramfile.
```
Tabel berikut dari semua perubahan yang melanggar, dan cara menghindari menghadapi perubahan yang melanggar di AWS CLI versi 2. Tindakan remediasi yang menyelesaikan peringatan dalam mode debug dicetak tebal.
| Melanggar perubahan | Pada v1, bermigrasi ke perilaku v2 | Pada v2, pertahankan perilaku v1 |
| --- | --- | --- |
| [Variabel lingkungan ditambahkan untuk mengatur pengkodean file teks](cliv2-migration-changes.md#cliv2-migration-encodingenvvar) | Hapus pengaturan variabel PYTHONUTF8 dan PYTHONIOENCODING lingkungan. | Atur variabel AWS\$1CLI\$1FILE\$1ENCODING lingkungan ke pengkodean yang ditentukan dalam v1. |
| [Parameter biner dilewatkan sebagai string yang dikodekan base64 secara default](cliv2-migration-changes.md#cliv2-migration-binaryparam) | Encode nilai parameter dengan base64. Jika parameter sedang dimuat dari file, encode isi file dengan base64. | Atur cli\$1binary\$1format pengaturan keraw-in-base64-out. |
| [Peningkatan penanganan Amazon S3 dari properti file dan tag untuk salinan multipart](cliv2-migration-changes.md#cliv2-migration-s3-copy-metadata) | N/A. Tidak dapat bermigrasi ke perilaku versi 2 di versi 1. | Gunakan parameter --copy-props none. |
| [Tidak ada pengambilan otomatis `http://` atau `https://` URLs untuk parameter](cliv2-migration-changes.md#cliv2-migration-paramfile) | Gunakan curl (atau alat alternatif) untuk mengunduh konten URLs ke file lokal. Kemudian, muat konten file ke parameter dengan [file://](https://docs.aws.amazon.com/cli/v1/userguide/cli-usage-parameters-file.html). Atau, konfigurasikan cli\$1follow\$1urlparam ke false untuk menentukan URL mentah sebagai nilai paramater. | N/A. Mustahil untuk mempertahankan perilaku versi 1 di versi 2. |
| [Pager digunakan untuk semua output secara default](cliv2-migration-changes.md#cliv2-migration-output-pager) | N/A. Tidak dapat bermigrasi ke perilaku versi 2 di versi 1. | Atur cli\$1pager pengaturan atau AWS\$1PAGER variabel ke string kosong. |
| [Nilai keluaran stempel waktu distandarisasi ke format ISO 8601](cliv2-migration-changes.md#cliv2-migration-timestamp) | Setel pengaturan cli\$1timestamp \$1format keiso8601. | Atur cli\$1timestamp\$1format pengaturan ke kawat. |
| [Peningkatan penanganan CloudFormation penerapan yang tidak menghasilkan perubahan](cliv2-migration-changes.md#cliv2-migration-cfn) | Gunakan --no-fail-on-empty-changeset parameternya. | Gunakan parameter --fail-on-empty-changeset. |
| [Mengubah perilaku default untuk titik akhir Amazon S3 Regional untuk Wilayah `us-east-1`](cliv2-migration-changes.md#cliv2-migration-s3-regional-endpoint) | [Atur variabel `AWS_ENDPOINT_URL_S3` lingkungan atau opsi baris `--endpoint-url` perintah ke URL regional us-east-1.](https://docs.aws.amazon.com/general/latest/gr/s3.html#s3_region) | Gunakan opsi baris --region aws-global perintah. |
| [`ecr get-login`dihapus dan diganti dengan `ecr get-login-password`](cliv2-migration-changes.md#cliv2-migration-ecr-get-login) | (1.17.10 atau yang lebih baru) Gunakan [`ecr get-login`dihapus dan diganti dengan `ecr get-login-password`](cliv2-migration-changes.md#cliv2-migration-ecr-get-login) dan salurkan output ke perintah docker. | N/A. Mustahil untuk mempertahankan perilaku versi 1 di versi 2. |
| [AWS CLI dukungan versi 2 untuk plugin berubah](cliv2-migration-changes.md#cliv2-migration-profile-plugins) | N/A. Tidak dapat bermigrasi ke perilaku versi 2 di versi 1. | Konfigurasikan [cli\$1legacy\$1plugin\$1path](https://docs.aws.amazon.com/cli/latest/topic/config-vars.html#plugins) ke bagian file konfigurasi. [plugins] Uji plugin di versi 2, kunci versi 2 Anda, dan uji plugin Anda setiap kali Anda meningkatkan. |
| [Dukungan alias tersembunyi dihapus](cliv2-migration-changes.md#cliv2-migration-aliases) | Beralih dari menggunakan alias tersembunyi usang ke [Dukungan alias tersembunyi dihapus](cliv2-migration-changes.md#cliv2-migration-aliases) yang berfungsi di semua versi. | N/A. Mustahil untuk mempertahankan perilaku versi 1 di versi 2. |
| [Pengaturan file `api_versions` konfigurasi tidak didukung](cliv2-migration-changes.md#cliv2-migration-api-versions) | Migrasikan dan uji penggunaan versi API lama Anda ke versi API terbaru, dan hapus [api\$1versions](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html#cli-config-api_versions) dari pengaturan konfigurasi Anda. | N/A. Mustahil untuk mempertahankan perilaku versi 1 di versi 2. |
| [AWS CLI versi 2 hanya menggunakan Signature v4 untuk mengautentikasi permintaan Amazon S3](cliv2-migration-changes.md#cliv2-migration-sigv4) | Tentukan Versi Tanda Tangan ke versi 4 (lihat [Menentukan Versi Tanda Tangan dalam otentikasi permintaan](https://docs.aws.amazon.com/AmazonS3/latest/API/specify-signature-version.html)). | N/A. Mustahil untuk mempertahankan perilaku versi 1 di versi 2. |
| [AWS CLI versi 2 lebih konsisten dengan parameter paging](cliv2-migration-changes.md#cliv2-migration-skeleton-paging) | Pindahkan parameter pagination dalam parameter input JSON ke perintah itu sendiri. | Hapus parameter pagination dari parameter input JSON. |
| [AWS CLI versi 2 menyediakan kode pengembalian yang lebih konsisten di semua perintah](cliv2-migration-changes.md#cliv2-migration-return-codes) | N/A. Tidak dapat bermigrasi ke perilaku versi 2 di versi 1. | N/A. Mustahil untuk mempertahankan perilaku versi 1 di versi 2. |
## Batasan
Kami sangat menyarankan pelanggan meninjau kami[Memecahkan perubahan antara AWS CLI versi 1 dan AWS CLI versi 2](cliv2-migration-changes.md#cliv2-migration-changes-breaking).
### Deteksi Perubahan Breaking Tidak Didukung
Fitur mode debug upgrade mendukung setiap perubahan yang melanggar kecuali itu[AWS CLI versi 2 menyediakan kode pengembalian yang lebih konsisten di semua perintah](cliv2-migration-changes.md#cliv2-migration-return-codes). Mode ini tidak dapat menjelaskan bagaimana Anda menggunakan kode kesalahan yang dikembalikan oleh AWS CLI hilir.
### Deteksi Perubahan Pemutusan Bersyarat
Deteksi [Nilai keluaran stempel waktu distandarisasi ke format ISO 8601](cliv2-migration-changes.md#cliv2-migration-timestamp) adalah satu-satunya kasus di mana deteksi tergantung pada status AWS akun, dan dapat mengalami perubahan yang melanggar jika sumber daya akun diperbarui kemudian. Jika tidak ada stempel waktu yang disertakan dalam respons API dari layanan, tidak ada deteksi yang akan dilakukan untuk perubahan yang melanggar ini.
Jika Anda mengandalkan format stempel waktu yang dikembalikan oleh perintah AWS CLI dan belum mengonfigurasi AWS CLI untuk menggunakan ISO 8601, lakukan tindakan pencegahan ekstra untuk memastikan pemrosesan stempel waktu Anda tidak akan rusak setelah memutakhirkan ke versi 2.
### Deteksi Perubahan yang Tidak Dapat Dipecahkan
Beberapa keluaran peringatan dengan mode debug upgrade tidak dapat diselesaikan dengan memodifikasi perintah atau lingkungan. Kasus berikut adalah kasus di mana peringatan akan selalu dikeluarkan oleh mode debug upgrade selama Anda menggunakan fitur yang sesuai:
+ [AWS CLI dukungan versi 2 untuk plugin berubah](cliv2-migration-changes.md#cliv2-migration-profile-plugins)- jika Anda mengandalkan plugin di [file konfigurasi](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html) Anda, mode debug upgrade akan selalu mengeluarkan peringatan yang tidak dapat diselesaikan. Mode ini tidak dapat menjamin apakah salah satu plugin Anda akan berfungsi di AWS CLI versi 2.
+ [Peningkatan penanganan Amazon S3 dari properti file dan tag untuk salinan multipart](cliv2-migration-changes.md#cliv2-migration-s3-copy-metadata)- jika `aws s3` digunakan untuk melakukan salinan bucket-to-bucket Amazon S3 Amazon, mode debug upgrade akan selalu mengeluarkan peringatan yang tidak dapat diselesaikan.
### Deteksi palsu
Peringatan yang dikeluarkan oleh mode debug pemutakhiran tidak menjamin bahwa perubahan yang melanggar akan dihadapi setelah memutakhirkan ke CLI AWS v2. Di bawah ini adalah kasus di mana peringatan akan dikeluarkan oleh mode debug pemutakhiran, meskipun tidak ada perubahan yang melanggar yang diperkenalkan di CLI v2 AWS :
+ [Variabel lingkungan ditambahkan untuk mengatur pengkodean file teks](cliv2-migration-changes.md#cliv2-migration-encodingenvvar)- jika variabel `PYTHONUTF8` atau `PYTHONIOENCODING` lingkungan ditentukan untuk mengatur pengkodean file teks, dan pengkodean yang ditentukan sudah cocok dengan lokal yang diinstal, peringatan mungkin deteksi palsu karena mode debug tidak memeriksa apakah pengkodean cocok dengan lokal yang diinstal.
+ [Peningkatan penanganan Amazon S3 dari properti file dan tag untuk salinan multipart](cliv2-migration-changes.md#cliv2-migration-s3-copy-metadata)- jika `aws s3` digunakan untuk melakukan salinan bucket-to-bucket Amazon S3 Amazon, dan salinannya tidak multipart karena objek sumber berada di bawah [ukuran ambang multipart](https://docs.aws.amazon.com/cli/latest/topic/s3-config.html#multipart-threshold), deteksi palsu akan menjadi output.
+ [Nilai keluaran stempel waktu distandarisasi ke format ISO 8601](cliv2-migration-changes.md#cliv2-migration-timestamp)- jika pengaturan konfigurasi cli\$1timestamp\$1format diatur ke kawat (default), dan stempel waktu dalam format ISO 8601 dikembalikan oleh layanan.
+ [Peningkatan penanganan CloudFormation penerapan yang tidak menghasilkan perubahan](cliv2-migration-changes.md#cliv2-migration-cfn)- jika `--fail-on-empty-changeset` flag digunakan dengan `aws cloudformation deploy` perintah, dan changeset yang dihasilkan kosong, deteksi palsu akan menjadi output. Juga, jika changeset tidak kosong, dan tidak `--no-fail-on-empty-changeset` digunakan, deteksi palsu akan menjadi output.
+ [Mengubah perilaku default untuk titik akhir Amazon S3 Regional untuk Wilayah `us-east-1`](cliv2-migration-changes.md#cliv2-migration-s3-regional-endpoint)- jika `aws s3` atau `aws s3api` digunakan untuk melakukan operasi Amazon S3 Amazon, dan wilayah dikonfigurasi ke`us-east-1`, dan konfigurasi tidak `s3.us_east_1_regional_endpoint` dikonfigurasi ke regional, dan titik akhir Amazon S3 global digunakan untuk permintaan karena pengaturan [konfigurasi titik akhir](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-endpoints.html#endpoints-precedence), maka peringatan mungkin deteksi palsu, karena mode debug tidak memeriksa pengaturan titik akhir yang dikonfigurasi.
## Konfigurasikan mode debug pemutakhiran
Anda dapat mengaktifkan atau menonaktifkan mode debug upgrade menggunakan metode berikut, yang tercantum dalam urutan prioritas:
+ Opsi baris perintah mengaktifkan atau menonaktifkan mode debug upgrade untuk satu perintah. Gunakan [--v2-debug untuk menggunakan mode debug](https://docs.aws.amazon.com/cli//latest/userguide/cli-configure-options.html#cli-configure-options-v2-debug) upgrade.
+ Variabel lingkungan menggunakan variabel [AWS\$1CLI\$1UPGRADE\$1DEBUG\$1MODE](https://docs.aws.amazon.com/cli//latest/userguide/cli-configure-envvars.html#envvars-list-aws_cli_upgrade_debug_mode).
# Menggunakan Alat Migrasi AWS CLI v1-ke-v2 untuk meningkatkan CLI versi 1 ke CLI AWS versi 2 AWS
Topik ini menjelaskan Alat Migrasi AWS CLI v1-ke-v2.
Kami merekomendasikan agar pengguna AWS CLI versi 1 meningkatkan ke AWS CLI versi 2 untuk mengakses fitur baru dan meningkatkan kinerja. Ada perubahan perilaku antara AWS CLI versi 1 dan AWS CLI versi 2 yang mungkin mengharuskan Anda memperbarui skrip atau perintah untuk mendapatkan perilaku yang sama. Alat Migrasi AWS CLI v1-to-v2 menganalisis skrip bash yang berisi perintah AWS CLI versi 1 dan mendeteksi penggunaan fitur yang telah diperbarui dengan perubahan yang melanggar pada CLI versi 2. AWS Selain itu, alat ini dapat secara otomatis memodifikasi skrip Anda untuk memperbaiki sebagian besar masalah yang dideteksinya. Alat ini meningkatkan pengalaman peningkatan dengan secara otomatis mendeteksi dan memodifikasi perintah AWS CLI versi 1 dalam skrip bash untuk mencegah masalah tak terduga saat memutakhirkan ke versi 2.
Dibandingkan dengan Upgrade Debug Mode, AWS CLI v1-to-v2 Migration Tool adalah alat mandiri dan tidak memerlukan eksekusi perintah CLI. AWS Untuk perbandingan menyeluruh antara Upgrade Debug Mode dan AWS CLI v1-to-v2 Migration Tool lihat di. [Menggunakan Alat Migrasi AWS CLI untuk Mengurangi Kerusakan](cliv2-migration.md#using-migration-tools) [Panduan migrasi untuk AWS CLI versi 2](cliv2-migration.md)
Untuk detail lebih lanjut, lihat [Memecahkan perubahan antara AWS CLI versi 1 dan AWS CLI versi 2](cliv2-migration-changes.md#cliv2-migration-changes-breaking) di[Fitur baru dan perubahan dalam AWS CLI versi 2](cliv2-migration-changes.md).
## Cara kerjanya
Alat Migrasi AWS CLI v1-to-v2 adalah paket Python yang mampu linting skrip bash yang menggunakan CLI versi 1. AWS Menjadi linter statis, itu tidak tergantung pada versi AWS CLI versi 1 yang mungkin telah Anda instal di mesin Anda. Linter dipanggil melalui baris perintah, di mana jalur file lokal ke skrip bash disediakan sebagai parameter.
Alat migrasi juga dapat secara otomatis menghasilkan skrip bash yang dimodifikasi yang menyelesaikan sebagian besar temuan yang dideteksi dengan memodifikasi perintah AWS CLI versi 1 yang digunakan dalam skrip. Alat migrasi memodifikasi perintah sehingga kompatibel dengan AWS versi 2 dan mempertahankan perilaku versi 1.
Untuk beberapa temuan, Alat Migrasi AWS CLI v1-ke-v2 dapat mendeteksi mereka tetapi tidak menawarkan perbaikan otomatis. Dalam kasus ini, alat migrasi menandai mereka sebagai deteksi yang memerlukan peninjauan manual.
Lihat [Batasan](#migration-tool-limitations) daftar lengkap perubahan yang melanggar dan perbaikan otomatis yang didukung oleh Alat Migrasi AWS CLI v1-ke-v2.
## Prasyarat
### Python
Untuk menggunakan alat ini, Anda harus menginstal Python 3.9 atau yang lebih baru.
Untuk memverifikasi bahwa Anda memiliki versi Python yang benar diinstal, jalankan perintah berikut di terminal dan konfirmasikan output menunjukkan versi Python minimal 3.9.
```
$ python3 --version
```
Jika Anda memiliki versi Python yang lebih lama, atau tidak menginstal Python, Anda dapat mengunduh versi yang kompatibel dari halaman unduhan [Python](https://www.python.org/downloads/) resmi.
### pip
Selain menginstal versi Python yang kompatibel, Anda harus `pip` menginstal.
Untuk memverifikasi bahwa `pip` sudah diinstal, jalankan perintah berikut:
```
$ python3 -m pip --version
```
Jika Anda telah `pip` menginstal, Anda akan melihat output yang mirip dengan yang berikut:
```
pip 25.0.1 from ~/.local/lib/python3.13/site-packages (python 3.13)
```
Jika Anda belum `pip` menginstal, lihat [Instal pip](https://docs.aws.amazon.com/cli/v1/userguide/install-linux.html#install-linux-pip-pip).
## Penginstalan
Instal Alat Migrasi AWS CLI v1-ke-v2 di lingkungan virtual baru:
```
$ python3 -m venv .venv
$ source .venv/bin/activate
$ python3 -m pip install aws-cli-migrate
```
## Penggunaan
### Mode Jalankan kering (default)
Dengan mode dry-run, Anda dapat secara otomatis mendeteksi perintah AWS CLI versi 1 yang dapat merusak perubahan tanpa memodifikasi skrip input:
```
$ migrate-aws-cli --script upload_s3_files.sh
```
### Mode Perbaikan Otomatis
Dengan mode perbaikan otomatis, Anda dapat secara otomatis mendeteksi dan memperbarui perintah AWS CLI versi 1 dalam skrip input untuk mengurangi kerusakan dari perubahan yang diperkenalkan di AWS CLI versi 2, jika memungkinkan:
```
$ migrate-aws-cli --script upload_s3_files.sh --fix
```
Secara opsional, Anda dapat menyediakan jalur output melalui `--output` parameter untuk menulis skrip yang diperbarui, daripada memperbarui skrip input:
```
$ migrate-aws-cli --script upload_s3_files.sh --output upload_s3_files_v2.sh --fix
```
### Mode Interaktif
Dengan mode interaktif, Anda dapat secara otomatis mendeteksi perintah AWS CLI versi 1 yang dapat merusak perubahan. Sebagian besar temuan akan menunjukkan perbaikan yang disarankan untuk mengurangi kerusakan di CLI versi 2 AWS . Anda dapat meninjau perbaikan yang disarankan dan memutuskan apakah akan menerapkannya. Secara opsional, berikan jalur keluaran melalui `--output` parameter untuk mengontrol tempat menulis skrip yang diperbarui:
```
$ migrate-aws-cli --script upload_s3_files.sh --interactive \
--output upload_s3_files_v2.sh
```
Cuplikan keluaran berikut adalah contoh temuan dalam mode interaktif:
```
14 14│
15 15│ aws s3 ls s3://mybucket
16 16│
17 │-aws s3 cp s3://amzn-demo-bucket s3://amzn-demo-bucket2 --recursive
17│+aws s3 cp s3://amzn-demo-bucket s3://amzn-demo-bucket2 --recursive --copy-props none
18 18│
19 19│ TEMPLATE_KEY="cloudformation/$(basename "$TEMPLATE_FILE")"
20 20│
examples/upload_s3_files.sh:17 [s3-copy] In AWS CLI v2, object properties will be copied
from the source in multipart copies between S3 buckets. If a copy is or becomes multipart
after upgrading to AWS CLI v2, extra API calls will be made. See
https://docs.aws.amazon.com/cli/latest/userguide/cliv2-migration-changes.html#cliv2-migration-s3-copy-metadata.
Apply this fix? [y] yes, [n] no, [a] accept all of type, [r] reject all of type, [u] update all,
[s] save and exit, [q] quit:
```
Perbaikan yang disarankan ditampilkan dalam format yang mirip dengan perbedaan Git. Alat migrasi menyarankan penghapusan baris yang dimulai dengan a`-`, dan menyarankan menambahkan baris yang dimulai dengan a`+`. Pada contoh sebelumnya, saran dapat diartikan sebagai menambahkan `--copy-props none` parameter ke perintah AWS CLI versi 1 yang mengeksekusi salinan Amazon S3.
Untuk setiap perbaikan yang disarankan, Anda dapat memasukkan salah satu kontrol berikut:
+ Masuk `y` untuk menerima perbaikan yang disarankan.
+ Masukkan `n` untuk menolak perbaikan saat ini.
+ Masuk `a` untuk menerima semua perbaikan dengan jenis yang sama.
+ Masukkan `r` untuk menolak semua perbaikan dengan jenis yang sama.
+ Masuk `u` untuk menerima semua perbaikan yang tersisa.
+ Masuk `s` untuk menyimpan dan keluar.
+ Masuk `q` untuk berhenti tanpa menabung.
Beberapa temuan mungkin ditandai untuk tinjauan manual tanpa perbaikan yang disarankan. Anda harus meninjau temuan ini dan memverifikasi apakah Anda terpengaruh oleh perubahan melanggar yang direferensikan. Jika Anda terpengaruh oleh temuan ini, Anda harus mengikuti panduan yang ditentukan dalam deskripsi temuan untuk membuat perubahan yang diperlukan untuk menghindari atau mempersiapkan perubahan yang melanggar yang diperkenalkan dalam AWS CLI versi 2.
## Batasan
Alat Migrasi AWS CLI v1-ke-v2 saat ini tidak mendukung setiap perubahan yang melanggar yang diperkenalkan dengan AWS CLI versi 2, dan memiliki kasus positif palsu di mana ia mengeluarkan deteksi untuk perintah bahkan jika tidak ada perubahan yang melanggar yang benar-benar akan dihadapi.
Kami sangat menyarankan pelanggan memahami [Memecahkan perubahan antara AWS CLI versi 1 dan AWS CLI versi 2](cliv2-migration-changes.md#cliv2-migration-changes-breaking) dipublikasikan di[Fitur baru dan perubahan dalam AWS CLI versi 2](cliv2-migration-changes.md).
### Analisis Berbasis Teks
Alat migrasi menganalisis skrip Anda tanpa menjalankannya. Ini membatasi cara mendeteksi perintah AWS CLI untuk melanggar perubahan. Alat migrasi hanya dapat memeriksa teks perintah AWS CLI. Itu tidak dapat mendeteksi masalah yang muncul saat runtime, seperti menyimpan parameter usang dalam variabel alih-alih meneruskannya langsung ke CLI. AWS
### Deteksi Perubahan Breaking Tidak Didukung
Tingkat dukungan untuk melanggar perubahan dalam alat migrasi dirangkum dalam tabel berikut.
| Melanggar perubahan | Deteksi didukung | Perbaikan otomatis didukung |
| --- | --- | --- |
| [Variabel lingkungan ditambahkan untuk mengatur pengkodean file teks](cliv2-migration-changes.md#cliv2-migration-encodingenvvar) | Tidak | Tidak |
| [Parameter biner dilewatkan sebagai string yang dikodekan base64 secara default](cliv2-migration-changes.md#cliv2-migration-binaryparam) | Ya | Ya |
| [Peningkatan penanganan Amazon S3 dari properti file dan tag untuk salinan multipart](cliv2-migration-changes.md#cliv2-migration-s3-copy-metadata) | Ya | Ya |
| [Tidak ada pengambilan otomatis `http://` atau `https://` URLs untuk parameter](cliv2-migration-changes.md#cliv2-migration-paramfile) | Tidak | Tidak |
| [Pager digunakan untuk semua output secara default](cliv2-migration-changes.md#cliv2-migration-output-pager) | Ya | Ya |
| [Nilai keluaran stempel waktu distandarisasi ke format ISO 8601](cliv2-migration-changes.md#cliv2-migration-timestamp) | Tidak | Tidak |
| [Peningkatan penanganan CloudFormation penerapan yang tidak menghasilkan perubahan](cliv2-migration-changes.md#cliv2-migration-cfn) | Ya | Ya |
| [Mengubah perilaku default untuk titik akhir Amazon S3 Regional untuk Wilayah `us-east-1`](cliv2-migration-changes.md#cliv2-migration-s3-regional-endpoint) | Tidak | Tidak |
| [Mengubah perilaku default untuk titik AWS STS akhir Regional](cliv2-migration-changes.md#cliv2-migration-sts-regional-endpoint) | Tidak | Tidak |
| [`ecr get-login`dihapus dan diganti dengan `ecr get-login-password`](cliv2-migration-changes.md#cliv2-migration-ecr-get-login) | Ya | Tidak |
| [AWS CLI dukungan versi 2 untuk plugin berubah](cliv2-migration-changes.md#cliv2-migration-profile-plugins) | Tidak | Tidak |
| [Dukungan alias tersembunyi dihapus](cliv2-migration-changes.md#cliv2-migration-aliases) | Ya | Ya |
| [Pengaturan file `api_versions` konfigurasi tidak didukung](cliv2-migration-changes.md#cliv2-migration-api-versions) | Tidak | Tidak |
| [AWS CLI versi 2 hanya menggunakan Signature v4 untuk mengautentikasi permintaan Amazon S3](cliv2-migration-changes.md#cliv2-migration-sigv4) | Tidak | Tidak |
| [AWS CLI versi 2 lebih konsisten dengan parameter paging](cliv2-migration-changes.md#cliv2-migration-skeleton-paging) | Ya | Tidak |
| [AWS CLI versi 2 menyediakan kode pengembalian yang lebih konsisten di semua perintah](cliv2-migration-changes.md#cliv2-migration-return-codes) | Tidak | Tidak |