ConfigError: Wilayah tidak ada di konfigurasi

TL;DR — AWS SDK tidak mengetahui wilayah mana yang harus diajak bicara. Setel secara eksplisit di klien (new DynamoDBClient({ region: 'us-east-1' })), atau melalui variabel lingkungan AWS_REGION, atau di ~/.aws/config.

Apa artinya

ConfigError: Missing region in config

Mengapa itu terjadi

Tidak ada wilayah yang diteruskan ke klien dan tidak ada AWS_REGION di lingkungan (JavaScript SDK membaca AWS_REGION; CLI AWS juga menghormati AWS_DEFAULT_REGION dan --region).
Wilayah di ~/.aws/config yang tidak pernah dibaca oleh SDK — JavaScript SDK v2 hanya memuat file konfigurasi bersama ketika variabel lingkungan AWS_SDK_LOAD_CONFIG disetel; tanpanya, garis region = yang sangat bagus akan diabaikan.
Salah ketik pada nama env var (AWS_REGIONS, REGION).

Cara memperbaikinya (salah satu dari ini)

Setel di klien (paling eksplisit):

import {DynamoDBClient} from '@aws-sdk/client-dynamodb';
const client = new DynamoDBClient({region: 'us-east-1'});

Variabel lingkungan:
```
export AWS_REGION=us-east-1
```
File konfigurasi AWS (~/.aws/config):
```
[default]
region = us-east-1
```
Pada JavaScript SDK v2, atur juga AWS_SDK_LOAD_CONFIG=1 sehingga SDK benar-benar membaca file ini (CLI dan sebagian besar SDK lainnya membacanya secara default).
DynamoDB Lokal? Masih memerlukan a string wilayah (nilai apa pun — hanya digunakan untuk memberi nama file database lokal) ditambah endpoint:
```
const client = new DynamoDBClient({region: 'local', endpoint: 'http://localhost:8000'});
```

Arahkan DynoTable ke Local

DynoTable menyimpan wilayah di setiap profil AWS — Pengaturan → Profil → Tambah Profil, lalu pilih wilayah dari dropdown sebelum Anda menyimpannya. Chip profil di bagian bawah sidebar menunjukkan wilayah aktif; tekan ⌘P untuk beralih. Tes Koneksi gagal dengan cepat ketika wilayah kosong atau file konfigurasi bersama diabaikan oleh SDK yang memerlukan AWS_SDK_LOAD_CONFIG.

Untuk Lokal, gunakan Unduh Lokal (atau arahkan titik akhir profil ke http://localhost:8000) dan setel string wilayah mana pun — DynoTable mempertahankan titik akhir dan wilayah pada profil yang sama sehingga tidak dapat menyimpang. Setelah terhubung, buka tabel dengan ⌘K dan konfirmasikan permintaan masuk ke wilayah yang Anda harapkan. Visual pembuat kueri berguna untuk membuktikan wilayah profil sebelum Anda menempelkan pengaturan yang sama ke dalam kode aplikasi.

Saat men-debug perbedaan resolusi wilayah SDK v2 vs v3, bandingkan pengaturan profil yang digunakan DynoTable dengan env vars aplikasi Anda secara berdampingan. Staging (⌘S) memungkinkan Anda menguji penulisan terhadap profil yang dikonfigurasi sebelum tugas batch Anda dijalankan.

Sumber

Mengatur Wilayah AWS — AWS SDK untuk JavaScript v2 (diverifikasi 13-07-2026)
Pemecahan masalah kesalahan untuk AWS CLI (diverifikasi 13-07-2026)

Kesalahan terkait

Token keamanan tidak valid
ResourceNotFoundException — sering kali suatu wilayah tidak cocok setelah suatu wilayah is ditetapkan.
Tidak dapat memulai proses Lokal DynamoDB
Pelajari: Hubungkan ke DynamoDB Local & LocalStack

Referensi

Terakhir diverifikasi 2026-07-13 berdasarkan dokumentasi resmi AWS yang ditautkan di atas.