Mengatur AWS Wilayah - AWS SDK for JavaScript
Dalam Konstruktor Kelas KlienMenggunakan Objek Konfigurasi GlobalMenggunakan Variabel LingkunganMenggunakan File Config BersamaUrutan Prioritas untuk Mengatur Wilayah

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.

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 SDK. 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:

  • Pengguna Linux, macOS, atau Unix: ~/.aws/config

  • Pengguna Windows: C:\Users\USER_NAME\.aws\config

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:

  • Jika Region diteruskan ke konstruktor kelas klien, Region itu digunakan. Jika tidak, maka...

  • Jika Region diatur pada objek konfigurasi global, Region tersebut akan digunakan. Jika tidak, maka...

  • Jika variabel AWS_REGION lingkungan adalah nilai yang benar, Wilayah itu digunakan. Jika tidak, maka...

  • Jika variabel AMAZON_REGION lingkungan adalah nilai yang benar, Wilayah itu digunakan. Jika tidak, maka...

  • Jika variabel AWS_SDK_LOAD_CONFIG lingkungan disetel ke nilai apa pun dan file kredensial bersama (~/.aws/credentialsatau jalur yang ditunjukkan olehAWS_SHARED_CREDENTIALS_FILE) berisi Wilayah untuk profil yang dikonfigurasi, Wilayah tersebut akan digunakan. Jika tidak, maka...

  • Jika variabel AWS_SDK_LOAD_CONFIG lingkungan disetel ke nilai apa pun dan file konfigurasi (~/.aws/configatau jalur yang ditunjukkan olehAWS_CONFIG_FILE) berisi Wilayah untuk profil yang dikonfigurasi, Wilayah tersebut akan digunakan.