AWS SDK untuk JavaScript V2 telah mencapai end-of-support. Kami menyarankan Anda bermigrasi ke [AWS SDK untuk JavaScript v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/). Untuk detail dan informasi tambahan tentang cara bermigrasi, silakan lihat [pengumuman](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/) ini.

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>

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

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
<a name="setting-region-config-object"></a>

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](https://docs.aws.amazon.com/general/latest/gr/rande.html) di *Referensi Umum AWS*.

## Menggunakan 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.

## Menggunakan File Config Bersama
<a name="setting-region-config-file"></a>

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:
+ 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](loading-node-credentials-shared.md) atau File [Konfigurasi dan Kredenal di Panduan Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html).AWS Command Line Interface *

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

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](https://developer.mozilla.org/en-US/docs/Glossary/Truthy), 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/credentials`atau jalur yang ditunjukkan oleh`AWS_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/config`atau jalur yang ditunjukkan oleh`AWS_CONFIG_FILE`) berisi Wilayah untuk profil yang dikonfigurasi, Wilayah tersebut akan digunakan.