View a markdown version of this page

Pengaturan konfigurasi umum - AWS SDK dan Alat

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 AWS config file 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_versions pengaturan 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 config file. 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-01 cloudfront = 2015-09-017
ca_bundle- pengaturan AWS config file bersama
AWS_CA_BUNDLE- variabel lingkungan

Menentukan jalur ke bundel sertifikat kustom (file dengan .pem ekstensi) 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 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 lolos 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- pengaturan AWS config file bersama

Menentukan bagaimana hasil diformat dalam AWS CLI dan AWS SDK dan alat lainnya.

Nilai default: json

Nilai yang valid:

  • json- Output diformat sebagai string JSON.

  • yaml- Output diformat sebagai string YAML.

  • 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 AWS config file bersama

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

Nilai default: true

Nilai 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