Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Opsi baris perintah di AWS CLI
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.
**Topics**
+ [Cara menggunakan opsi baris perintah](#cli-configure-options-how)
+ [AWS CLI mendukung opsi baris perintah global](#cli-configure-options-list)
+ [Penggunaan umum opsi baris perintah](#cli-configure-options-common)
## Cara menggunakan opsi baris perintah
Sebagian besar opsi baris perintah adalah string sederhana, seperti nama profil `profile1` dalam contoh berikut:
```
$ aws s3 ls --profile profile1
amzn-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, lihat[Menentukan nilai parameter dalam AWS CLI](cli-usage-parameters.md).
## 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 ****
Menentukan bundel sertifikat otoritas sertifikat (CA) yang akan digunakan saat memverifikasi sertifikat SSL.
Jika ditentukan, opsi ini mengesampingkan nilai untuk pengaturan profil `ca\$1bundle` dan variabel `AWS\$1CA\$1BUNDLE` lingkungan.
**--cli-auto-prompt**
Mengaktifkan mode auto-prompt untuk satu perintah. Seperti yang ditunjukkan contoh berikut, Anda dapat menentukannya kapan saja.
```
$ aws --cli-auto-prompt
$ aws dynamodb --cli-auto-prompt
$ aws dynamodb describe-table --cli-auto-prompt
```
Opsi ini mengesampingkan variabel `aws\$1cli\$1auto\$1prompt` lingkungan dan pengaturan `cli\$1auto\$1prompt` profil.
Untuk informasi tentang fitur prompt otomatis AWS CLI versi 2, lihat[Mengaktifkan dan menggunakan command prompt di AWS CLI](cli-usage-parameters-prompting.md).
**--cli-binary-format**
Menentukan bagaimana AWS CLI versi 2 menafsirkan parameter input biner. Ini bisa menjadi salah satu nilai berikut:
+ **base64** - Ini adalah nilai default. Parameter input yang diketik sebagai objek besar biner (BLOB) menerima string yang dikodekan base64. Untuk meneruskan konten biner yang benar, letakkan konten dalam file dan berikan path dan nama file dengan `fileb://` awalan sebagai nilai parameter. Untuk meneruskan teks berenkode base64 yang terdapat dalam file, berikan path dan nama file dengan `file://` awalan sebagai nilai parameter.
+ **raw-in-base64-out** - Default untuk AWS CLI versi 1. Jika nilai pengaturan adalah`raw-in-base64-out`, file yang direferensikan menggunakan `file://` awalan dibaca sebagai teks dan kemudian AWS CLI upaya untuk menyandikannya ke biner.
Ini mengesampingkan pengaturan konfigurasi `cli\$1binary\$1format` file.
```
$ aws lambda invoke \
--cli-binary-format raw-in-base64-out \
--function-name my-function \
--invocation-type Event \
--payload '{ "name": "Bob" }' \
response.json
```
Jika Anda mereferensikan nilai biner dalam file menggunakan notasi `fileb://` awalan, AWS CLI *selalu* mengharapkan file tersebut berisi konten biner mentah dan tidak mencoba mengonversi nilainya.
Jika Anda mereferensikan nilai biner dalam file menggunakan notasi `file://` awalan, AWS CLI menangani file sesuai dengan pengaturan saat ini`cli_binary_format`. Jika nilai pengaturan itu `base64` (default saat tidak disetel secara eksplisit), file tersebut AWS CLI mengharapkan file berisi teks yang dikodekan base64. Jika nilai pengaturan itu`raw-in-base64-out`, file AWS CLI mengharapkan berisi konten biner mentah.
**--cli-connect-timeout ****
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. Nilai bawaannya adalah 60 detik.
**--cli-read-timeout ****
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. Nilai bawaannya adalah 60 detik.
**--warna ****
Menentukan dukungan untuk output warna. Nilai yang valid adalah `on`, `off`, dan `auto`. Nilai default-nya adalah `auto`.
**--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. `--debug`Opsi ini menyediakan log Python lengkap. Ini termasuk informasi `stderr` diagnostik 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 `stderr` diagnostik, tambahkan `2> debug.txt` di mana nama `debug.txt` yang ingin Anda gunakan untuk file debug Anda:
```
$ aws servicename commandname options --debug 2> debug.txt
```
**Untuk mengirim informasi output dan `stderr` diagnostik, tambahkan `&> debug.txt` di mana nama `debug.txt` yang ingin Anda gunakan untuk file debug Anda:**
```
$ aws servicename commandname options --debug &> debug.txt
```
**--titik akhir-url ****
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](https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html#what-is-privatelink), yang mungkin perlu ditentukan.
Contoh perintah berikut menggunakan URL endpoint Amazon S3 kustom.
```
$ aws s3 ls --endpoint-url http://localhost:4567
```
**Prioritas titik akhir**
Pengaturan 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. Ini AWS CLI memeriksa pengaturan titik akhir ini dalam urutan tertentu, dan menggunakan pengaturan titik akhir dengan prioritas tertinggi. Untuk daftar prioritas titik akhir, lihat. [Konfigurasi titik akhir dan pengaturan diutamakan](cli-configure-endpoints.md#endpoints-precedence)
**--no-cli-auto-prompt**
Menonaktifkan mode prompt otomatis untuk satu perintah.
```
$ aws dynamodb describe-table --table-name Table1 --no-cli-auto-prompt
```
Opsi ini mengesampingkan variabel `aws\$1cli\$1auto\$1prompt` lingkungan dan pengaturan `cli\$1auto\$1prompt` profil.
Untuk informasi tentang fitur prompt otomatis AWS CLI versi 2, lihat[Mengaktifkan dan menggunakan command prompt di AWS CLI](cli-usage-parameters-prompting.md).
**--no-cli-pager**
Sakelar Boolean yang menonaktifkan menggunakan pager untuk output perintah.
**--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.
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](cli-chap-troubleshooting.md#tshoot-certificate-verify-failed)
**--keluaran ****
Menentukan format output yang akan digunakan untuk perintah ini. Anda dapat menentukan salah satu nilai berikut:
+ **[`json`](cli-usage-output-format.md#json-output)**— Output diformat sebagai string [JSON](https://json.org/).
+ **[`yaml`](cli-usage-output-format.md#yaml-output)**— Output diformat sebagai string [YAMG.](https://yaml.org/)
+ **[`yaml-stream`](cli-usage-output-format.md#yaml-stream-output)**— Output dialirkan dan diformat sebagai string [YAMB](https://yaml.org/). Streaming memungkinkan penanganan tipe data besar yang lebih cepat.
+ **[`text`](cli-usage-output-format.md#text-output)**- Output diformat sebagai beberapa baris nilai string yang dipisahkan tab. Ini dapat berguna untuk meneruskan output ke prosesor teks, seperti`grep`,`sed`, atau`awk`.
+ **[`table`](cli-usage-output-format.md#table-output)**— Output diformat sebagai tabel menggunakan karakter \$1\$1- 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.
+ **[`off`](cli-usage-output-format.md#off-output)**— Output menekan semua output perintah ke stdout. Ini berguna dalam skrip otomatisasi dan CI/CD saluran pipa di mana Anda hanya perlu memeriksa kode keluar perintah tanpa memproses output.
**--profil ****
Menentukan [profil bernama](cli-configure-files.md#cli-configure-files-using-profiles) untuk digunakan untuk perintah ini. Untuk mengatur profil bernama tambahan, Anda dapat menggunakan `aws configure` perintah dengan `--profile` opsi.
```
$ aws configure --profile
```
**--kueri ****
Menentukan [JMESPath query](https://jmespath.org/) untuk digunakan dalam penyaringan data respon. Untuk informasi selengkapnya, lihat [Output penyaringan di AWS CLI](cli-usage-filter.md).
**--wilayah ****
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](https://docs.aws.amazon.com/general/latest/gr/rande.html) di *Referensi Umum Amazon Web Services*.
**--versi**
Switch 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 --region us-west-1
-------------------
|DescribeInstances|
+-----------------+
$ aws ec2 describe-instances --output table --region us-west-2
------------------------------------------------------------------------------
| DescribeInstances |
+----------------------------------------------------------------------------+
|| Reservations ||
|+-------------------------------------+------------------------------------+|
|| OwnerId | 012345678901 ||
|| ReservationId | r-abcdefgh ||
|+-------------------------------------+------------------------------------+|
||| Instances |||
||+------------------------+-----------------------------------------------+||
||| AmiLaunchIndex | 0 |||
||| Architecture | x86_64 |||
...
```