Menggunakan Objek Konfigurasi Global - AWS SDK for JavaScript

Kami mengumumkan yang akan datang end-of-support untuk AWS SDK for JavaScript v2. Kami menyarankan Anda bermigrasi ke AWS SDK for JavaScript v3. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, silakan merujuk ke pengumuman tertaut.

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

Menggunakan Objek Konfigurasi Global

Ada dua cara untuk mengkonfigurasi SDK:

  • Atur konfigurasi global menggunakanAWS.Config.

  • Teruskan informasi konfigurasi tambahan ke objek layanan.

Menyetel konfigurasi global dengan AWS.Config seringkali lebih mudah untuk memulai, tetapi konfigurasi tingkat layanan dapat memberikan kontrol lebih besar atas layanan individual. Konfigurasi global yang ditentukan oleh AWS.Config menyediakan pengaturan default untuk objek layanan yang Anda buat selanjutnya, menyederhanakan konfigurasi mereka. Namun, Anda dapat memperbarui konfigurasi objek layanan individual ketika kebutuhan Anda bervariasi dari konfigurasi global.

Pengaturan Konfigurasi Global

Setelah Anda memuat aws-sdk paket dalam kode Anda, Anda dapat menggunakan variabel AWS global untuk mengakses kelas SDK dan berinteraksi dengan layanan individual. SDK menyertakan objek konfigurasi globalAWS.Config, yang dapat Anda gunakan untuk menentukan setelan konfigurasi SDK yang diperlukan oleh aplikasi Anda.

Konfigurasikan SDK dengan menyetel AWS.Config properti sesuai dengan kebutuhan aplikasi Anda. Tabel berikut merangkum AWS.Config properti yang biasa digunakan untuk mengatur konfigurasi SDK.

Opsi konfigurasi Deskripsi
credentials Diperlukan. Menentukan kredensil yang digunakan untuk menentukan akses ke layanan dan sumber daya.
region Diperlukan. Menentukan Wilayah di mana permintaan untuk layanan dibuat.
maxRetries Tidak wajib. Menentukan jumlah maksimum kali permintaan yang diberikan dicoba ulang.
logger Tidak wajib. Menentukan objek logger yang informasi debugging ditulis.
update Tidak wajib. Memperbarui konfigurasi saat ini dengan nilai baru.

Untuk informasi selengkapnya tentang objek konfigurasi, lihat Class: AWS.Configdi Referensi API.

Contoh Konfigurasi Global

Anda harus mengatur Wilayah dan kredensialnya. AWS.Config Anda dapat mengatur properti ini sebagai bagian dari AWS.Config konstruktor, seperti yang ditunjukkan dalam contoh skrip browser berikut:

var myCredentials = new AWS.CognitoIdentityCredentials({IdentityPoolId:'IDENTITY_POOL_ID'}); var myConfig = new AWS.Config({ credentials: myCredentials, region: 'us-west-2' });

Anda juga dapat mengatur properti ini setelah membuat AWS.Config menggunakan update metode, seperti yang ditunjukkan dalam contoh berikut yang memperbarui Wilayah:

myConfig = new AWS.Config(); myConfig.update({region: 'us-east-1'});

Anda bisa mendapatkan kredensi default dengan memanggil getCredentials metode statis: AWS.config

var AWS = require("aws-sdk"); AWS.config.getCredentials(function(err) { if (err) console.log(err.stack); // credentials not loaded else { console.log("Access key:", AWS.config.credentials.accessKeyId); } });

Demikian pula, jika Anda telah mengatur wilayah Anda dengan benar di config file Anda, Anda mendapatkan nilai itu dengan menyetel variabel AWS_SDK_LOAD_CONFIG lingkungan disetel ke nilai apa pun dan memanggil region properti statis dariAWS.config:

var AWS = require("aws-sdk"); console.log("Region: ", AWS.config.region);

Pengaturan Konfigurasi Per Layanan

Setiap layanan yang Anda gunakan dalam SDK untuk JavaScript diakses melalui objek layanan yang merupakan bagian dari API untuk layanan tersebut. Misalnya, untuk mengakses layanan Amazon S3 Anda membuat objek layanan Amazon S3. Anda dapat menentukan pengaturan konfigurasi yang spesifik untuk layanan sebagai bagian dari konstruktor untuk objek layanan tersebut. Ketika Anda menetapkan nilai konfigurasi pada objek layanan, konstruktor mengambil semua nilai konfigurasi yang digunakan olehAWS.Config, termasuk kredensil.

Misalnya, jika Anda perlu mengakses objek Amazon EC2 di beberapa Wilayah, buat objek layanan Amazon EC2 untuk setiap Wilayah, lalu atur konfigurasi Wilayah dari setiap objek layanan yang sesuai.

var ec2_regionA = new AWS.EC2({region: 'ap-southeast-2', maxRetries: 15, apiVersion: '2014-10-01'}); var ec2_regionB = new AWS.EC2({region: 'us-east-1', maxRetries: 15, apiVersion: '2014-10-01'});

Anda juga dapat mengatur nilai konfigurasi khusus untuk layanan saat mengonfigurasi SDK dengan. AWS.Config Objek konfigurasi global mendukung banyak opsi konfigurasi khusus layanan. Untuk informasi selengkapnya tentang konfigurasi khusus layanan, lihat Class: AWS.Configdi Referensi AWS SDK for JavaScript API.

Data Konfigurasi yang Tidak Dapat Diubah

Perubahan konfigurasi global berlaku untuk permintaan semua objek layanan yang baru dibuat. Objek layanan yang baru dibuat dikonfigurasi dengan data konfigurasi global saat ini terlebih dahulu dan kemudian opsi konfigurasi lokal apa pun. Pembaruan yang Anda buat ke AWS.config objek global tidak berlaku untuk objek layanan yang dibuat sebelumnya.

Objek layanan yang ada harus diperbarui secara manual dengan data konfigurasi baru atau Anda harus membuat dan menggunakan objek layanan baru yang memiliki data konfigurasi baru. Contoh berikut membuat objek layanan Amazon S3 baru dengan data konfigurasi baru:

s3 = new AWS.S3(s3.config);