Pengaturan konfigurasi umum - AWS SDKsdan Alat
Kompatibilitas dengan AWS SDKs

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pengaturan konfigurasi umum

SDKsmendukung beberapa pengaturan umum yang mengonfigurasi SDK perilaku keseluruhan.

Konfigurasikan fungsi ini dengan menggunakan yang berikut ini:

api_versions- dibagikan AWS configpengaturan file

Beberapa AWS layanan mempertahankan beberapa API versi untuk mendukung kompatibilitas mundur. Secara default, SDK dan AWS CLI operasi menggunakan API versi terbaru yang tersedia. Untuk meminta API versi tertentu untuk digunakan untuk permintaan Anda, sertakan api_versions pengaturan di profil Anda.

Nilai default: Tidak ada. (APIVersi terbaru digunakan olehSDK.)

Nilai yang valid: Ini adalah pengaturan bersarang yang diikuti oleh satu atau lebih baris indentasi yang masing-masing mengidentifikasi satu AWS layanan dan API versi yang akan digunakan. Lihat dokumentasi untuk AWS layanan untuk memahami API versi mana yang tersedia.

Contoh menetapkan API versi tertentu untuk dua AWS layanan dalam config file. APIVersi ini hanya digunakan untuk perintah yang berjalan di bawah profil yang berisi pengaturan ini. Perintah untuk layanan lain menggunakan versi terbaru dari layanan ituAPI.

api_versions =
    ec2 = 2015-03-01
    cloudfront = 2015-09-017
ca_bundle- dibagikan AWS configpengaturan file
AWS_CA_BUNDLE- variabel lingkungan

Menentukan jalur ke bundel sertifikat kustom (file dengan .pem ekstensi) untuk digunakan saat membuatSSL/TLSkoneksi.

Nilai default: tidak ada

Nilai yang valid: Tentukan jalur lengkap atau nama file dasar. Jika ada nama file dasar, sistem mencoba untuk menemukan program dalam folder yang ditentukan oleh variabel PATH lingkungan.

Contoh pengaturan nilai ini dalam config file:

[default]
ca_bundle = dev/apps/ca-certs/cabundle-2019mar05.pem

Karena perbedaan dalam cara sistem operasi menangani jalur dan melarikan diri dari karakter jalur, berikut ini adalah contoh pengaturan nilai ini dalam config file di Windows:

[default]
ca_bundle = C:\\Users\\username\\.aws\\aws-custom-bundle.pem

Linux/macOS contoh pengaturan variabel lingkungan melalui baris perintah:

export AWS_CA_BUNDLE=/dev/apps/ca-certs/cabundle-2019mar05.pem

Contoh Windows pengaturan variabel lingkungan melalui baris perintah:

setx AWS_CA_BUNDLE C:\dev\apps\ca-certs\cabundle-2019mar05.pem
output- dibagikan AWS configpengaturan file

Menentukan bagaimana hasil diformat dalam AWS CLI dan lainnya AWS SDKsdan alat-alat.

Nilai default: json

Nilai yang valid:

  • json— Output diformat sebagai JSONstring.

  • yaml— Output diformat sebagai YAMLstring.

  • yaml-stream— Output dialirkan dan diformat sebagai YAMLstring. 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. Ini biasanya menyajikan informasi dalam format “ramah manusia” yang jauh lebih mudah dibaca daripada yang lain, tetapi tidak berguna secara terprogram.

parameter_validation- dibagikan AWS configpengaturan file

Menentukan apakah SDK atau alat mencoba untuk memvalidasi parameter baris perintah sebelum mengirim mereka ke AWS titik akhir layanan.

Nilai default: true

Nilai yang valid:

  • true – Default. Alat SDK or melakukan validasi sisi klien dari parameter baris perintah. Ini membantu SDK atau alat mengkonfirmasi bahwa parameter valid, dan menangkap beberapa kesalahan. Alat SDK atau dapat menolak permintaan yang tidak valid sebelum mengirim permintaan ke AWS titik akhir layanan.

  • false— Alat SDK atau tidak memvalidasi parameter baris perintah sebelum mengirimnya ke AWS titik akhir layanan. Bagian AWS titik akhir layanan bertanggung jawab untuk memvalidasi semua permintaan dan menolak permintaan yang tidak valid.

Kompatibilitas dengan AWS SDKs

Berikut ini SDKs mendukung fitur dan pengaturan yang dijelaskan dalam topik ini. Setiap pengecualian sebagian dicatat. Pengaturan properti JVM sistem apa pun didukung oleh AWS SDK for Java dan AWS SDK for Kotlin hanya.

SDK Didukung Catatan atau informasi lebih lanjut
AWS CLI v2 Parsial api_versionstidak didukung.
SDKuntuk C ++ Ya
SDKuntuk Go V2 (1.x) Parsial api_versionsdan parameter_validation tidak didukung.
SDKuntuk 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 Sesi.
SDKuntuk Java 2.x Tidak
SDKuntuk Java 1.x Tidak
SDKuntuk JavaScript 3.x Ya
SDKuntuk JavaScript 2.x Ya
SDKuntuk Kotlin Tidak
SDKuntuk. NET3.x Tidak
SDKuntuk PHP 3.x Ya
SDKuntuk Python (Boto3) Ya
SDKuntuk Ruby 3.x Ya
SDKuntuk Rust Tidak
SDKuntuk Swift Tidak
Alat untuk PowerShell Tidak