aws cli

Kode sumber lainnya

1.0.0

Unduh

aws-cli

Paket ini menyediakan antarmuka baris perintah terpadu ke Amazon Web Services.

Langsung ke:

Memulai
Mendapatkan Bantuan
Lebih Banyak Sumber Daya

Memulai

README ini untuk AWS CLI versi 1. Jika Anda mencari informasi tentang AWS CLI versi 2, silakan kunjungi cabang v2.

Persyaratan

Paket aws-cli berfungsi pada versi Python:

3.8.x dan lebih tinggi
3.9.x dan lebih tinggi
3.10.x dan lebih tinggi
3.11.x dan lebih tinggi
3.12.x dan lebih tinggi

Pemberitahuan

Pada 30-05-2022, dukungan untuk Python 3.6 telah dihentikan. Hal ini menyusul berakhirnya dukungan Python Software Foundation untuk runtime yang terjadi pada 23-12-2021.

Pada 13-12-2023, dukungan untuk Python 3.7 telah dihentikan. Hal ini menyusul berakhirnya dukungan Python Software Foundation untuk runtime yang terjadi pada 27-06-2023. Untuk informasi lebih lanjut, lihat posting blog ini.

Perhatian!

Kami menyarankan agar semua pelanggan memantau situs web Buletin Keamanan Amazon Web Services secara berkala untuk mengetahui buletin keamanan penting apa pun yang terkait dengan aws-cli.

Pemeliharaan dan Dukungan untuk CLI Versi Utama

AWS CLI versi 1 tersedia secara umum pada 02/09/2013 dan saat ini berada dalam fase dukungan penuh dari siklus hidup ketersediaan.

Untuk informasi tentang pemeliharaan dan dukungan untuk versi utama SDK dan dependensi yang mendasarinya, lihat bagian Kebijakan Pemeliharaan di Panduan Referensi Konfigurasi dan Kredensial Bersama SDK dan Alat AWS .

Instalasi

Instalasi AWS CLI dan dependensinya menggunakan serangkaian fitur pengemasan yang disediakan oleh pip dan setuptools . Untuk memastikan kelancaran instalasi, disarankan untuk menggunakan:

pip : 9.0.2 atau lebih tinggi
setuptools : 36.2.0 atau lebih tinggi

Cara teraman untuk menginstal AWS CLI adalah dengan menggunakan pip di virtualenv :

 $ python -m pip instal awscli

atau, jika Anda tidak menginstal di virtualenv , untuk menginstal secara global:

 $ sudo python -m pip instal awscli

atau untuk pengguna Anda:

 $ python -m pip install --pengguna awscli

Jika Anda telah menginstal paket aws-cli dan ingin meningkatkan ke versi terbaru, Anda dapat menjalankan:

 $ python -m pip install --upgrade awscli

Ini akan menginstal paket aws-cli serta semua dependensi.

Catatan

Di macOS, jika Anda melihat kesalahan terkait versi six yang disertakan dengan distutils di El Capitan, gunakan opsi --ignore-installed :

 $ sudo python -m pip install awscli --ignore-installed enam

Di Linux dan Mac OS, AWS CLI dapat diinstal menggunakan penginstal yang dibundel. AWS CLI juga dapat diinstal di Windows melalui Penginstal MSI.

Jika Anda ingin menjalankan cabang develop AWS CLI, lihat bagian Versi Pengembangan pada panduan berkontribusi.

Lihat bagian instalasi Panduan Pengguna AWS CLI untuk informasi lebih lanjut.

Konfigurasi

Sebelum menggunakan AWS CLI, Anda perlu mengonfigurasi kredensial AWS Anda. Anda dapat melakukannya dengan beberapa cara:

Perintah konfigurasi
Variabel lingkungan
File kredensial bersama
File konfigurasi
Peran IAM

Cara tercepat untuk memulai adalah dengan menjalankan perintah aws configure :

 $aws konfigurasikan
ID Kunci Akses AWS: MYACCESSKEY
Kunci Akses Rahasia AWS: MYSECRETKEY
Nama wilayah default [us-west-2]: us-west-2
Format keluaran default [Tidak Ada]: json

Untuk menggunakan variabel lingkungan, lakukan hal berikut:

 $ ekspor AWS_ACCESS_KEY_ID=
$ ekspor AWS_SECRET_ACCESS_KEY=

Untuk menggunakan file kredensial bersama, buat file berformat INI seperti ini:

 [bawaan]
aws_access_key_id=MYACCESSKEY
aws_secret_access_key=MYSECRETKEY

[pengujian]
aws_access_key_id=MYACCESSKEY
aws_secret_access_key=MYSECRETKEY

dan letakkan di ~/.aws/credentials (atau di %UserProfile%.aws/credentials di Windows). Jika Anda ingin menempatkan file kredensial bersama di lokasi berbeda dari yang ditentukan di atas, Anda perlu memberi tahu aws-cli di mana menemukannya. Lakukan ini dengan mengatur variabel lingkungan yang sesuai:

 $ ekspor AWS_SHARED_CREDENTIALS_FILE=/path/ke/shared_credentials_file

Untuk menggunakan file konfigurasi, buat file berformat INI seperti ini:

 [bawaan]
aws_access_key_id=
aws_secret_access_key=
# Opsional, untuk menentukan wilayah default untuk profil ini.
wilayah=kita-barat-1

[pengujian profil]
aws_access_key_id=
aws_secret_access_key=
wilayah=kita-barat-2

dan letakkan di ~/.aws/config (atau di %UserProfile%.awsconfig di Windows). Jika Anda ingin menempatkan file konfigurasi di lokasi yang berbeda dari yang ditentukan di atas, Anda perlu memberi tahu AWS CLI di mana menemukannya. Lakukan ini dengan mengatur variabel lingkungan yang sesuai:

 $ ekspor AWS_CONFIG_FILE=/path/ke/config_file

Seperti yang Anda lihat, Anda dapat menentukan beberapa profiles di file kredensial bersama dan file konfigurasi. Anda kemudian dapat menentukan profil mana yang akan digunakan dengan menggunakan opsi --profile . Jika tidak ada profil yang ditentukan, profil default akan digunakan.

Dalam file konfigurasi, kecuali untuk profil default, Anda harus mengawali setiap bagian konfigurasi grup profil dengan profile . Misalnya, jika Anda memiliki profil bernama "pengujian" maka header bagiannya adalah [profile testing] .

Opsi terakhir untuk kredensial sangat disarankan jika Anda menggunakan AWS CLI pada instans EC2. Peran IAM adalah cara terbaik untuk menginstal kredensial secara otomatis pada instans Anda. Jika Anda menggunakan IAM Roles, AWS CLI akan menemukan dan menggunakannya secara otomatis.

Selain kredensial, sejumlah variabel lain dapat dikonfigurasi dengan variabel lingkungan, entri file konfigurasi, atau keduanya. Lihat Panduan Referensi Konfigurasi dan Kredensial Bersama Alat dan SDK AWS untuk informasi lebih lanjut.

Untuk informasi selengkapnya tentang opsi konfigurasi, silakan lihat topik Variabel Konfigurasi AWS CLI. Anda juga dapat mengakses topik ini dari AWS CLI dengan menjalankan aws help config-vars .

Perintah Dasar

Perintah AWS CLI memiliki struktur berikut:

 $ aws   [opsi dan parameter]

Misalnya, untuk membuat daftar bucket S3, perintahnya adalah:

 $ aws s3 ls

Untuk melihat dokumentasi bantuan, gunakan salah satu dari yang berikut ini:

 $aws bantuan
$ aws  bantuan
$ aws   bantuan

Untuk mendapatkan versi AWS CLI:

 $ aws --versi

Untuk mengaktifkan keluaran debug:

 $ aws --debug

Anda dapat membaca informasi selengkapnya di bab Menggunakan AWS CLI di Panduan Pengguna AWS CLI.

Penyelesaian Perintah

Paket aws-cli menyertakan fitur penyelesaian perintah untuk sistem mirip Unix. Fitur ini tidak diinstal secara otomatis sehingga Anda perlu mengkonfigurasinya secara manual. Untuk mempelajari lebih lanjut, baca topik penyelesaian Perintah AWS CLI.

Mendapatkan Bantuan

Cara terbaik untuk berinteraksi dengan tim kami adalah melalui GitHub. Anda dapat membuka masalah dan memilih salah satu templat kami untuk panduan, laporan bug, atau permintaan fitur.

Anda dapat menemukan bantuan dari komunitas di Stack Overflow dengan tag aws-cli atau di Forum Diskusi AWS untuk CLI. Jika Anda memiliki rencana dukungan dengan AWS Support, Anda juga dapat membuat kasus dukungan baru.

Silakan periksa masalah serupa yang terbuka sebelum membuka masalah lain.

AWS CLI mengimplementasikan API layanan AWS. Untuk masalah umum mengenai layanan atau batasannya, Forum Diskusi Amazon Web Services mungkin berguna bagi Anda.