AWS SDK untuk JavaScript V2 telah mencapai end-of-support. Kami menyarankan Anda bermigrasi ke AWS SDK untuk JavaScript v3. Untuk detail dan informasi tambahan tentang cara bermigrasi, silakan lihat pengumuman ini.

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

Mengatur AWS Wilayah

Wilayah adalah kumpulan AWS sumber daya bernama di wilayah geografis yang sama. Contoh dari sebuah Wilayah adalahus-east-1, yang merupakan Wilayah AS Timur (Virginia N.). Anda menentukan Wilayah saat mengonfigurasi SDK JavaScript agar SDK mengakses sumber daya di Wilayah tersebut. Beberapa layanan hanya tersedia di Wilayah tertentu.

SDK for JavaScript tidak memilih Region secara default. Namun, Anda dapat mengatur Wilayah menggunakan variabel lingkungan, config file bersama, atau objek konfigurasi global.

Dalam Konstruktor Kelas Klien

Ketika Anda membuat instance objek layanan, Anda dapat menentukan Region untuk sumber daya tersebut sebagai bagian dari konstruktor kelas klien, seperti yang ditunjukkan di sini.

var s3 = new AWS.S3({apiVersion: '2006-03-01', region: 'us-east-1'});

Menggunakan Objek Konfigurasi Global

Untuk mengatur Wilayah dalam JavaScript kode Anda, perbarui objek konfigurasi AWS.Config global seperti yang ditunjukkan di sini.

AWS.config.update({region: 'us-east-1'});

Untuk informasi selengkapnya tentang Wilayah saat ini dan layanan yang tersedia di setiap Wilayah, lihat AWS Wilayah dan Titik Akhir di Referensi Umum AWS.

Menggunakan Variabel Lingkungan

Anda dapat mengatur Wilayah menggunakan variabel AWS_REGION lingkungan. Jika Anda mendefinisikan variabel ini, SDK untuk JavaScript membacanya dan menggunakannya.

Menggunakan File Config Bersama

Sama seperti file kredensial bersama yang memungkinkan Anda menyimpan kredensil untuk digunakan oleh SDK, Anda dapat menyimpan Region dan pengaturan konfigurasi lainnya dalam file bersama bernama config yang digunakan oleh. SDKs Jika variabel AWS_SDK_LOAD_CONFIG lingkungan telah disetel ke nilai apa pun, SDK untuk JavaScript secara otomatis mencari config file saat dimuat. Di mana Anda menyimpan config file tergantung pada sistem operasi Anda:

Jika Anda belum memiliki config file bersama, Anda dapat membuatnya di direktori yang ditunjuk. Dalam contoh berikut, config file menetapkan Region dan format output.

[default]
   region=us-east-1
   output=json

Untuk informasi selengkapnya tentang penggunaan file konfigurasi dan kredensial bersama, lihat Memuat Kredensial di Node.js dari File Kredensial Bersama atau File Konfigurasi dan Kredensi di Panduan Pengguna.AWS Command Line Interface

Urutan Prioritas untuk Mengatur Wilayah

Urutan prioritas untuk pengaturan Wilayah adalah sebagai berikut: