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

# Mengatur Wilayah AWS untuk AWS SDK for Ruby
<a name="region"></a>

Anda dapat mengakses Layanan AWS yang beroperasi di wilayah geografis tertentu dengan menggunakan Wilayah AWS. Ini dapat berguna baik untuk redundansi dan untuk menjaga data dan aplikasi Anda berjalan dekat dengan tempat Anda dan pengguna Anda mengaksesnya.

**penting**  
Sebagian besar sumber daya berada di tempat tertentu Wilayah AWS dan Anda harus menyediakan Wilayah yang benar untuk sumber daya saat menggunakan SDK.

Anda harus menetapkan default Wilayah AWS untuk SDK for Ruby untuk digunakan untuk permintaan. AWS Default ini digunakan untuk setiap panggilan metode layanan SDK yang tidak ditentukan dengan Region. 

Untuk informasi selengkapnya tentang `region` pengaturan, lihat [Wilayah AWS](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html)di *Panduan Referensi Alat AWS SDKs dan Alat*. Ini juga mencakup contoh tentang cara mengatur wilayah default melalui AWS `config` file bersama atau variabel lingkungan. 

## Urutan pencarian wilayah untuk resolusi
<a name="aws-ruby-sdk-setting-region"></a>

Anda perlu mengatur Wilayah saat menggunakan sebagian besar Layanan AWS. AWS SDK for Ruby mencari Wilayah dengan urutan sebagai berikut:

1.  Mengatur Wilayah di klien atau objek sumber daya 

1.  Mengatur Wilayah dengan menggunakan `Aws.config` 

1.  Mengatur Wilayah dengan menggunakan variabel lingkungan 

1.  Mengatur Wilayah dengan menggunakan `config` file bersama 

## Cara mengatur Wilayah
<a name="WaysToSetRegion"></a>

Bagian ini menjelaskan berbagai cara untuk mengatur Wilayah, dimulai dengan pendekatan yang paling umum.

### Mengatur Wilayah menggunakan `config` file bersama
<a name="aws-ruby-sdk-region-config"></a>

Atur wilayah dengan mengatur `region` variabel dalam AWS `config` file bersama. Untuk informasi selengkapnya tentang `config` file bersama, 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*. 

Contoh pengaturan nilai ini dalam `config` file:

```
[default]
region = us-west-2
```

`config`File bersama tidak diperiksa jika variabel lingkungan `AWS_SDK_CONFIG_OPT_OUT` disetel.

### Mengatur Wilayah menggunakan variabel lingkungan
<a name="aws-ruby-sdk-region-environment"></a>

Mengatur Region dengan mengatur variabel `AWS_REGION` lingkungan.

Gunakan `export` perintah untuk mengatur variabel ini pada sistem berbasis Unix, seperti Linux atau macOS. Contoh berikut menetapkan Region ke`us-west-2`.

```
export AWS_REGION=us-west-2
```

Untuk mengatur variabel ini pada Windows, gunakan `set` perintah. Contoh berikut menetapkan Region ke`us-west-2`.

```
set AWS_REGION=us-west-2
```

### Mengatur Wilayah dengan `Aws.config`
<a name="aws-ruby-sdk-region-aws-config"></a>

Atur Region dengan menambahkan `region` nilai ke `Aws.config` hash. Contoh berikut memperbarui `Aws.config` hash untuk menggunakan `us-west-1` Wilayah.

```
Aws.config.update({region: 'us-west-1'})
```

Setiap klien atau sumber daya yang Anda buat nanti terikat ke Wilayah ini.

### Mengatur Wilayah di klien atau objek sumber daya
<a name="aws-ruby-sdk-region-client-resource"></a>

Atur Wilayah saat Anda membuat AWS klien atau sumber daya. Contoh berikut membuat objek sumber daya Amazon S3 di Wilayah. `us-west-1` Pilih Wilayah yang tepat untuk AWS sumber daya Anda. Objek klien layanan tidak dapat diubah, jadi Anda harus membuat klien baru untuk setiap layanan yang Anda minta dan untuk membuat permintaan ke layanan yang sama menggunakan konfigurasi yang berbeda.

```
s3 = Aws::S3::Resource.new(region: 'us-west-1')
```