

 [Panduan Referensi API AWS SDK untuk JavaScript V3](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/) menjelaskan secara rinci semua operasi API untuk AWS SDK untuk 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
<a name="setting-region"></a>

 AWS Wilayah adalah kumpulan AWS sumber daya bernama di wilayah geografis yang sama. Contoh dari sebuah Wilayah adalah`us-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
<a name="setting-region-constructor"></a>

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
<a name="setting-region-environment-variable"></a>

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

## Gunakan file konfigurasi bersama
<a name="setting-region-config-file"></a>

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 penggunaan bersama `config` dan `credentials` file, lihat [File konfigurasi dan kredensial bersama](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) di Panduan Referensi *Alat AWS SDKs dan Alat*.

## Urutan prioritas untuk pengaturan Wilayah
<a name="setting-region-order-of-precedence"></a>

Berikut ini adalah urutan prioritas untuk pengaturan Wilayah:

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

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

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