Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Pengaturan konfigurasi umum
catatan
Untuk bantuan dalam memahami tata letak halaman pengaturan, atau dalam menafsirkan tabel AWS Dukungan oleh SDK dan alat berikut, lihatMemahami halaman pengaturan panduan ini.
SDK mendukung beberapa pengaturan umum yang mengkonfigurasi perilaku SDK secara keseluruhan.
Konfigurasikan fungsionalitas ini dengan menggunakan yang berikut:
api_versions- pengaturan AWSconfigfile bersama-
Beberapa AWS layanan mempertahankan beberapa versi API untuk mendukung kompatibilitas mundur. Secara default, SDK dan AWS CLI operasi menggunakan versi API terbaru yang tersedia. Untuk mewajibkan versi API tertentu untuk digunakan untuk permintaan Anda, sertakan
api_versionspengaturan di profil Anda.Nilai default: Tidak ada. (Versi API terbaru digunakan oleh SDK.)
Nilai yang valid: Ini adalah pengaturan bersarang yang diikuti oleh satu atau lebih baris indentasi yang masing-masing mengidentifikasi satu AWS layanan dan versi API yang akan digunakan. Lihat dokumentasi untuk AWS layanan untuk memahami versi API mana yang tersedia.
Contoh menetapkan versi API tertentu untuk dua AWS layanan dalam
configfile. Versi API ini hanya digunakan untuk perintah yang berjalan di bawah profil yang berisi pengaturan ini. Perintah untuk layanan lain menggunakan versi terbaru dari API layanan tersebut.api_versions = ec2 =2015-03-01cloudfront =2015-09-017 ca_bundle- pengaturan AWSconfigfile bersamaAWS_CA_BUNDLE- variabel lingkungan-
Menentukan jalur ke bundel sertifikat kustom (file dengan
.pemekstensi) untuk digunakan saat membuat SSL/TLS koneksi.Nilai default: tidak ada
Nilai yang valid: T entukan jalur lengkap atau nama file dasar. Jika ada nama file dasar, sistem mencoba untuk menemukan program dalam folder yang ditentukan oleh variabel
PATHlingkungan.Contoh pengaturan nilai ini dalam
configfile:[default] ca_bundle =dev/apps/ca-certs/cabundle-2019mar05.pemKarena perbedaan dalam cara sistem operasi menangani jalur dan lolos dari karakter jalur, berikut ini adalah contoh pengaturan nilai ini dalam
configfile di Windows:[default] ca_bundle =C:\\Users\\username\\.aws\\aws-custom-bundle.pemLinux/macOS contoh pengaturan variabel lingkungan melalui baris perintah:
export AWS_CA_BUNDLE=/dev/apps/ca-certs/cabundle-2019mar05.pemContoh Windows pengaturan variabel lingkungan melalui baris perintah:
setx AWS_CA_BUNDLEC:\dev\apps\ca-certs\cabundle-2019mar05.pem output- pengaturan AWSconfigfile bersama-
Menentukan bagaimana hasil diformat dalam AWS CLI dan AWS SDK dan alat lainnya.
Nilai default:
jsonNilai yang valid:
-
yaml-stream- Output dialirkan dan diformat sebagai string YAML. Streaming memungkinkan penanganan tipe data besar yang lebih cepat. -
text- Output diformat sebagai beberapa baris nilai string yang dipisahkan tab. Ini dapat berguna untuk meneruskan output ke prosesor teks, sepertigrep,sed, atauawk. -
table— Output diformat sebagai tabel menggunakan karakter +|- untuk membentuk batas sel. Biasanya menyajikan informasi dalam format “ramah manusia” yang jauh lebih mudah dibaca daripada yang lain, tetapi tidak berguna secara terprogram.
parameter_validation- pengaturan AWSconfigfile bersama-
Menentukan apakah SDK atau alat mencoba memvalidasi parameter baris perintah sebelum mengirimnya ke titik akhir AWS layanan.
Nilai default:
trueNilai yang valid:
-
true– Default. SDK atau alat melakukan validasi sisi klien dari parameter baris perintah. Ini membantu SDK atau alat mengonfirmasi bahwa parameter valid, dan menangkap beberapa kesalahan. SDK atau alat dapat menolak permintaan yang tidak valid sebelum mengirim permintaan ke titik akhir AWS layanan. -
false— SDK atau alat tidak memvalidasi parameter baris perintah sebelum mengirimnya ke titik akhir AWS layanan. T AWS itik akhir layanan bertanggung jawab untuk memvalidasi semua permintaan dan menolak permintaan yang tidak valid.
-
Dukungan oleh AWS SDK dan alat
SDK berikut mendukung fitur dan pengaturan yang dijelaskan dalam topik ini. Setiap pengecualian sebagian dicatat. Setiap pengaturan properti sistem JVM didukung oleh AWS SDK untuk Java dan AWS SDK untuk Kotlin satu-satunya.
| SDK | Didukung | Catatan atau informasi lebih lanjut |
|---|---|---|
| AWS CLI v2 | Parsial | api_versionstidak didukung. |
| SDK untuk C++ | Ya | |
| SDK untuk Go V2 (1.x) | Parsial | api_versionsdan parameter_validation tidak didukung. |
| SDK untuk Go 1.x (V1) | Parsial | api_versionsdan parameter_validation tidak didukung. Untuk menggunakan pengaturan config file bersama, Anda harus mengaktifkan pemuatan dari file konfigurasi; lihat S esi. |
| SDK untuk Java 2.x | Tidak | |
| SDK untuk Java 1.x | Tidak | |
| SDK untuk JavaScript 3.x | Ya | |
| SDK untuk JavaScript 2.x | Ya | |
| SDK para Kotlin | Tidak | |
| SDK untuk.NET 4.x | Tidak | |
| SDK untuk.NET 3.x | Tidak | |
| SDK para PHP 3.x | Ya | |
| SDK untuk Python (Boto3) | Ya | |
| SDK para Ruby 3.x | Ya | |
| SDK para Rust | Tidak | |
| SDK para Swift | Tidak | |
| Alat untuk PowerShell V5 | Tidak | |
| Alat untuk PowerShell V4 | Tidak |