Mengatur AWS Wilayah - AWS SDK for JavaScript
Dalam konstruktor kelas klienGunakan variabel lingkunganGunakan file konfigurasi bersamaUrutan prioritas untuk pengaturan Wilayah

Panduan Referensi API AWS SDK for JavaScript V3 menjelaskan secara rinci semua operasi API untuk AWS SDK for JavaScript versi 3 (V3).

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

Mengatur AWS Wilayah

AWS 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 Region saat membuat klien layanan di SDK JavaScript agar SDK mengakses layanan di Wilayah tersebut. Beberapa layanan hanya tersedia di Wilayah tertentu.

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

Dalam konstruktor kelas klien

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

const s3Client = new S3.S3Client({region: 'us-west-2'});

Gunakan variabel lingkungan

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

Gunakan file konfigurasi bersama

Sama seperti file kredensial bersama yang memungkinkan Anda menyimpan kredensional untuk digunakan oleh SDK, Anda dapat menyimpan AWS Region dan pengaturan konfigurasi lainnya dalam file bersama yang diberi nama config untuk digunakan SDK. Jika variabel AWS_SDK_LOAD_CONFIG lingkungan disetel ke nilai kebenaran, 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-west-2
   output=json

Untuk informasi selengkapnya tentang menggunakan file bersama config dan credentials file, lihat File konfigurasi dan kredensial bersama di Panduan Referensi AWS SDK dan Alat.

Urutan prioritas untuk pengaturan Wilayah

Berikut ini adalah urutan prioritas untuk pengaturan Wilayah:

  1. Jika Region diteruskan ke konstruktor kelas klien, Region itu digunakan.

  2. Jika Region diatur dalam variabel lingkungan, Region yang digunakan.

  3. Jika tidak, Wilayah yang ditentukan dalam file konfigurasi bersama akan digunakan.