Mengkonfigurasi AWS SDK for Ruby klien layanan secara eksternal - AWS SDK for Ruby
AWS Variabel lingkungan SDK for Ruby

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

Mengkonfigurasi AWS SDK for Ruby klien layanan secara eksternal

Banyak pengaturan konfigurasi dapat ditangani di luar kode Anda. Ketika konfigurasi ditangani secara eksternal, konfigurasi diterapkan di semua aplikasi Anda. Sebagian besar pengaturan konfigurasi dapat diatur sebagai variabel lingkungan atau dalam AWS config file bersama yang terpisah. configFile bersama dapat mempertahankan set pengaturan terpisah, yang disebut profil, untuk menyediakan konfigurasi yang berbeda untuk lingkungan atau pengujian yang berbeda.

Variabel lingkungan dan pengaturan config file bersama distandarisasi dan dibagikan di seluruh AWS SDKs dan alat untuk mendukung fungsionalitas yang konsisten di berbagai bahasa pemrograman dan aplikasi.

Lihat Panduan Referensi Alat AWS SDKs dan untuk mempelajari tentang mengonfigurasi aplikasi Anda melalui metode ini, ditambah detail pada setiap setelan lintas sdk. Untuk melihat semua pengaturan yang dapat diselesaikan SDK dari variabel lingkungan atau file konfigurasi, lihat referensi Pengaturan di Panduan Referensi Alat AWS SDKs dan.

Untuk membuat permintaan ke Layanan AWS, pertama-tama Anda membuat instance klien untuk layanan itu. Anda dapat mengonfigurasi pengaturan umum untuk klien layanan seperti batas waktu, klien HTTP, dan konfigurasi coba lagi.

Setiap klien layanan membutuhkan Wilayah AWS dan penyedia kredensi. SDK menggunakan nilai-nilai ini untuk mengirim permintaan ke Wilayah yang benar untuk sumber daya Anda dan untuk menandatangani permintaan dengan kredenal yang benar. Anda dapat menentukan nilai-nilai ini secara terprogram dalam kode atau membuatnya dimuat secara otomatis dari lingkungan.

SDK memiliki serangkaian tempat (atau sumber) yang diperiksa untuk menemukan nilai untuk pengaturan konfigurasi.

  1. Pengaturan eksplisit apa pun yang disetel dalam kode atau pada klien layanan itu sendiri lebih diutamakan daripada yang lain.

  2. Variabel-variabel lingkungan

    • Untuk detail tentang pengaturan variabel lingkungan, lihat variabel lingkungan di Panduan Referensi Alat AWS SDKs dan Alat.

    • Perhatikan bahwa Anda dapat mengonfigurasi variabel lingkungan untuk shell pada tingkat cakupan yang berbeda: seluruh sistem, seluruh pengguna, dan untuk sesi terminal tertentu.

  3. Berbagi config dan credentials file

  4. Setiap nilai default yang disediakan oleh kode sumber SDK itu sendiri digunakan terakhir.

    • Beberapa properti, seperti Region, tidak memiliki default. Anda harus menentukannya secara eksplisit dalam kode, dalam pengaturan lingkungan, atau dalam file bersamaconfig. Jika SDK tidak dapat menyelesaikan konfigurasi yang diperlukan, permintaan API dapat gagal saat runtime.

AWS Variabel lingkungan SDK for Ruby

Di luar variabel lingkungan cross-sdk yang didukung di sebagian besar AWS SDKs, AWS SDK for Ruby mendukung beberapa variabel unik:

AWS_SDK_CONFIG_OPT_OUT

Jika variabel AWS_SDK_CONFIG_OPT_OUT lingkungan AWS SDK for Ruby disetel, file bersama, AWS config ~/.aws/config biasanya di, tidak akan digunakan untuk nilai konfigurasi apa pun.

AMAZON_REGION

Variabel lingkungan alternatif AWS_REGION untuk pengaturan Wilayah AWS. Nilai ini hanya diperiksa jika AWS_REGION tidak digunakan.