Dokumentasi ini AWS CLI hanya untuk Versi 1. Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna Versi 2.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Di AWS CLI, opsi baris perintah adalah parameter global yang dapat Anda gunakan untuk mengganti pengaturan konfigurasi default, pengaturan profil yang sesuai, atau pengaturan variabel lingkungan untuk perintah tunggal itu. Anda tidak dapat menggunakan opsi baris perintah untuk menentukan kredensil secara langsung, meskipun Anda dapat menentukan profil mana yang akan digunakan.
Topik
Cara menggunakan opsi baris perintah
Sebagian besar opsi baris perintah adalah string sederhana, seperti nama profil profile1 dalam contoh berikut:
$aws s3 ls --profileprofile1amzn-s3-demo-bucket1 amzn-s3-demo-bucket2 ...
Setiap opsi yang mengambil argumen memerlukan spasi atau sama dengan tanda (=) yang memisahkan argumen dari nama opsi. Jika nilai argumen adalah string yang berisi spasi, Anda harus menggunakan tanda kutip di sekitar argumen. Untuk detail tentang tipe argumen dan pemformatan parameter, lihatMenentukan nilai parameter dalam AWS CLI.
AWS CLI mendukung opsi baris perintah global
Di dalam AWS CLI Anda dapat menggunakan opsi baris perintah berikut untuk mengganti pengaturan konfigurasi default, pengaturan profil yang sesuai, atau pengaturan variabel lingkungan untuk perintah tunggal itu.
- --ca-bundel
<string> -
Menentukan bundel sertifikat otoritas sertifikat (CA) yang akan digunakan saat memverifikasi sertifikat SSL.
Jika ditentukan, opsi ini mengesampingkan nilai untuk pengaturan profil
ca_bundledan variabelAWS_CA_BUNDLElingkungan. - --cli-connect-timeout
<integer> -
Menentukan waktu koneksi soket maksimum dalam hitungan detik. Jika nilainya disetel ke nol (0), sambungan soket menunggu tanpa batas waktu (memblokir) dan tidak batas waktu.
- --cli-read-timeout
<integer> -
Menentukan waktu baca soket maksimum dalam hitungan detik. Jika nilai disetel ke nol (0) pembacaan soket menunggu tanpa batas waktu (memblokir) dan tidak batas waktu.
- --warna
<string> -
Menentukan dukungan untuk output warna. Nilai yang valid adalah
on,off, danauto. Nilai default-nya adalahauto. - --debug
-
Sakelar Boolean yang memungkinkan logging debug. Secara AWS CLI default menyediakan informasi yang dibersihkan mengenai keberhasilan atau kegagalan terkait hasil perintah dalam output perintah.
--debugOpsi ini menyediakan log Python lengkap. Ini termasuk informasistderrdiagnostik tambahan tentang pengoperasian perintah yang dapat berguna saat memecahkan masalah mengapa perintah memberikan hasil yang tidak terduga. Untuk melihat log debug dengan mudah, kami sarankan mengirim log ke file agar lebih mudah mencari informasi. Anda dapat melakukan ini dengan menggunakan salah satu dari berikut ini.Untuk mengirim hanya informasi
stderrdiagnostik, tambahkan2> debug.txtdi mana namadebug.txtyang ingin Anda gunakan untuk file debug Anda:$aws2>servicenamecommandnameoptions--debugdebug.txtUntuk mengirim informasi output dan
stderrdiagnostik, tambahkan&> debug.txtdi mana namadebug.txtyang ingin Anda gunakan untuk file debug Anda:$aws&>servicenamecommandnameoptions--debugdebug.txt - --titik akhir-url
<string> -
Menentukan URL untuk mengirim permintaan ke. Untuk sebagian besar perintah, AWS CLI secara otomatis menentukan URL berdasarkan layanan yang dipilih dan AWS Wilayah yang ditentukan. Namun, beberapa perintah mengharuskan Anda menentukan URL khusus akun. Anda juga dapat mengonfigurasi beberapa AWS layanan untuk meng-host titik akhir langsung di dalam VPC pribadi Anda, yang mungkin perlu ditentukan.
Contoh perintah berikut menggunakan URL endpoint Amazon S3 kustom.
$aws s3 ls --endpoint-urlhttp://localhost:4567Pengaturan konfigurasi titik akhir terletak di beberapa tempat, seperti variabel sistem atau lingkungan pengguna, file AWS konfigurasi lokal, atau dinyatakan secara eksplisit pada baris perintah sebagai parameter. Pengaturan konfigurasi AWS CLI titik akhir diutamakan dalam urutan sebagai berikut:
-
Opsi baris
--endpoint-urlperintah. -
Jika diaktifkan, variabel lingkungan endpoint
AWS_IGNORE_CONFIGURED_ENDPOINT_URLSglobal atau pengaturan profilignore_configure_endpoint_urlsuntuk mengabaikan endpoint kustom. -
Nilai yang diberikan oleh variabel lingkungan khusus layanan
AWS_ENDPOINT_URL_<SERVICE>, seperti.AWS_ENDPOINT_URL_DYNAMODB -
Nilai yang disediakan oleh
AWS_USE_DUALSTACK_ENDPOINT,AWS_USE_FIPS_ENDPOINT, dan variabelAWS_ENDPOINT_URLlingkungan. -
Nilai endpoint khusus layanan yang disediakan oleh
endpoint_urlpengaturan dalamservicesbagian file bersama.config -
Nilai yang diberikan oleh
endpoint_urlpengaturanprofiledalamconfigfile bersama. -
use_dualstack_endpoint,use_fips_endpoint, danendpoint_urlpengaturan. -
URL endpoint default untuk masing-masing Layanan AWS digunakan terakhir. Untuk daftar titik akhir layanan standar yang tersedia di setiap Wilayah, lihat AWS Wilayah dan Titik Akhir di. Referensi Umum Amazon Web Services
-
- --no-paginate
-
Sakelar Boolean yang menonaktifkan beberapa panggilan yang dilakukan secara otomatis AWS CLI untuk menerima semua hasil perintah yang membuat pagination output. Ini berarti hanya halaman pertama output Anda yang ditampilkan.
- --no-sign-request
-
Sakelar Boolean yang menonaktifkan penandatanganan permintaan HTTP ke titik akhir AWS layanan. Ini mencegah kredensil dimuat.
- --no-verify-ssl
-
Secara default, AWS CLI menggunakan SSL saat berkomunikasi dengan AWS layanan. Untuk setiap koneksi SSL dan panggilan, AWS CLI memverifikasi sertifikat SSL. Menggunakan opsi ini mengesampingkan perilaku default untuk memverifikasi sertifikat SSL.
Awas
Opsi ini bukan praktik terbaik. Jika Anda menggunakannya
--no-verify-ssl, lalu lintas antara klien dan AWS layanan Anda tidak lagi aman. Ini berarti lalu lintas Anda berisiko keamanan dan rentan terhadap man-in-the-middle eksploitasi. Jika Anda mengalami masalah dengan sertifikat, sebaiknya selesaikan masalah tersebut. Untuk langkah pemecahan masalah sertifikat, lihat. Kesalahan sertifikat SSL - --keluaran
<string> -
Menentukan format output yang akan digunakan untuk perintah ini. Anda dapat menentukan salah satu nilai berikut:
-
text- Output diformat sebagai beberapa baris nilai string yang dipisahkan tab. Ini dapat berguna untuk meneruskan output ke prosesor teks, seperti
grep,sed, atauawk. -
table— Output diformat sebagai tabel menggunakan karakter +|- untuk membentuk batas sel. Ini biasanya menyajikan informasi dalam format “ramah manusia” yang jauh lebih mudah dibaca daripada yang lain, tetapi tidak berguna secara terprogram.
- --profil
<string> -
Menentukan profil bernama untuk digunakan untuk perintah ini. Untuk mengatur profil bernama tambahan, Anda dapat menggunakan
aws configureperintah dengan--profileopsi.$aws configure --profile<profilename> - --kueri
<string> -
Menentukan JMESPath query
untuk digunakan dalam penyaringan data respon. Untuk informasi selengkapnya, lihat Output penyaringan di AWS CLI. - --wilayah
<string> -
Menentukan AWS Region mana untuk mengirim AWS permintaan perintah ini ke. Untuk daftar semua Wilayah yang dapat Anda tentukan, lihat AWS Wilayah dan Titik Akhir di Referensi Umum Amazon Web Services.
- --versi
-
Sakelar Boolean yang menampilkan versi saat ini dari AWS CLI program yang sedang berjalan.
Penggunaan umum opsi baris perintah
Penggunaan umum untuk opsi baris perintah termasuk memeriksa sumber daya Anda di beberapa AWS Wilayah, dan mengubah format output untuk keterbacaan atau kemudahan penggunaan saat membuat skrip. Dalam contoh berikut, kita menjalankan perintah describe-instance terhadap setiap Region sampai kita menemukan Region mana instance kita berada.
$aws ec2 describe-instances --output table --regionus-west-1------------------- |DescribeInstances| +-----------------+$aws ec2 describe-instances --output table --regionus-west-2------------------------------------------------------------------------------ | DescribeInstances | +----------------------------------------------------------------------------+ || Reservations || |+-------------------------------------+------------------------------------+| || OwnerId | 012345678901 || || ReservationId | r-abcdefgh || |+-------------------------------------+------------------------------------+| ||| Instances ||| ||+------------------------+-----------------------------------------------+|| ||| AmiLaunchIndex | 0 ||| ||| Architecture | x86_64 ||| ...
