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.
# Menggunakan Objek Konfigurasi Global
Ada dua cara untuk mengkonfigurasi SDK:
+ Atur konfigurasi global menggunakan`AWS.Config`.
+ Teruskan informasi konfigurasi tambahan ke objek layanan.
Menyetel konfigurasi global dengan `AWS.Config` seringkali lebih mudah untuk memulai, tetapi konfigurasi tingkat layanan dapat memberikan kontrol lebih besar atas layanan individual. Konfigurasi global yang ditentukan oleh `AWS.Config` menyediakan pengaturan default untuk objek layanan yang Anda buat selanjutnya, menyederhanakan konfigurasi mereka. Namun, Anda dapat memperbarui konfigurasi objek layanan individual ketika kebutuhan Anda bervariasi dari konfigurasi global.
## Pengaturan Konfigurasi Global
Setelah Anda memuat `aws-sdk` paket dalam kode Anda, Anda dapat menggunakan variabel ` AWS` global untuk mengakses kelas SDK dan berinteraksi dengan layanan individual. SDK menyertakan objek konfigurasi global`AWS.Config`, yang dapat Anda gunakan untuk menentukan setelan konfigurasi SDK yang diperlukan oleh aplikasi Anda.
Konfigurasikan SDK dengan menyetel `AWS.Config` properti sesuai dengan kebutuhan aplikasi Anda. Tabel berikut merangkum `AWS.Config` properti yang biasa digunakan untuk mengatur konfigurasi SDK.
****
| Opsi konfigurasi | Deskripsi |
| --- | --- |
| credentials | Diperlukan. Menentukan kredensil yang digunakan untuk menentukan akses ke layanan dan sumber daya. |
| region | Diperlukan. Menentukan Wilayah di mana permintaan untuk layanan dibuat. |
| maxRetries | Tidak wajib. Menentukan jumlah maksimum kali permintaan yang diberikan dicoba ulang. |
| logger | Tidak wajib. Menentukan objek logger yang informasi debugging ditulis. |
| update | Tidak wajib. Memperbarui konfigurasi saat ini dengan nilai baru. |
Untuk informasi selengkapnya tentang objek konfigurasi, lihat [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html)di Referensi API.
### Contoh Konfigurasi Global
Anda harus mengatur Wilayah dan kredensialnya. `AWS.Config` Anda dapat mengatur properti ini sebagai bagian dari `AWS.Config` konstruktor, seperti yang ditunjukkan dalam contoh skrip browser berikut:
```
var myCredentials = new AWS.CognitoIdentityCredentials({IdentityPoolId:'IDENTITY_POOL_ID'});
var myConfig = new AWS.Config({
credentials: myCredentials, region: 'us-west-2'
});
```
Anda juga dapat mengatur properti ini setelah membuat `AWS.Config` menggunakan `update` metode, seperti yang ditunjukkan dalam contoh berikut yang memperbarui Wilayah:
```
myConfig = new AWS.Config();
myConfig.update({region: 'us-east-1'});
```
Anda bisa mendapatkan kredensi default dengan memanggil ` getCredentials` metode statis: `AWS.config`
```
var AWS = require("aws-sdk");
AWS.config.getCredentials(function(err) {
if (err) console.log(err.stack);
// credentials not loaded
else {
console.log("Access key:", AWS.config.credentials.accessKeyId);
}
});
```
Demikian pula, jika Anda telah mengatur wilayah Anda dengan benar di `config` file Anda, Anda mendapatkan nilai itu dengan menyetel variabel `AWS_SDK_LOAD_CONFIG` lingkungan disetel ke nilai apa pun dan memanggil `region` properti statis dari`AWS.config`:
```
var AWS = require("aws-sdk");
console.log("Region: ", AWS.config.region);
```
## Pengaturan Konfigurasi Per Layanan
Setiap layanan yang Anda gunakan dalam SDK untuk JavaScript diakses melalui objek layanan yang merupakan bagian dari API untuk layanan tersebut. Misalnya, untuk mengakses layanan Amazon S3 Anda membuat objek layanan Amazon S3. Anda dapat menentukan pengaturan konfigurasi yang spesifik untuk layanan sebagai bagian dari konstruktor untuk objek layanan tersebut. Ketika Anda menetapkan nilai konfigurasi pada objek layanan, konstruktor mengambil semua nilai konfigurasi yang digunakan oleh`AWS.Config`, termasuk kredensil.
Misalnya, jika Anda perlu mengakses objek Amazon EC2 di beberapa Wilayah, buat objek layanan Amazon EC2 untuk setiap Wilayah, lalu atur konfigurasi Wilayah dari setiap objek layanan yang sesuai.
```
var ec2_regionA = new AWS.EC2({region: 'ap-southeast-2', maxRetries: 15, apiVersion: '2014-10-01'});
var ec2_regionB = new AWS.EC2({region: 'us-east-1', maxRetries: 15, apiVersion: '2014-10-01'});
```
Anda juga dapat menyetel nilai konfigurasi khusus untuk layanan saat mengonfigurasi SDK dengan. `AWS.Config` Objek konfigurasi global mendukung banyak opsi konfigurasi khusus layanan. Untuk informasi selengkapnya tentang konfigurasi khusus layanan, lihat [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html)di Referensi AWS SDK untuk JavaScript API.
## Data Konfigurasi yang Tidak Dapat Diubah
Perubahan konfigurasi global berlaku untuk permintaan semua objek layanan yang baru dibuat. Objek layanan yang baru dibuat dikonfigurasi dengan data konfigurasi global saat ini terlebih dahulu dan kemudian opsi konfigurasi lokal apa pun. Pembaruan yang Anda buat ke `AWS.config` objek global tidak berlaku untuk objek layanan yang dibuat sebelumnya.
Objek layanan yang ada harus diperbarui secara manual dengan data konfigurasi baru atau Anda harus membuat dan menggunakan objek layanan baru yang memiliki data konfigurasi baru. Contoh berikut membuat objek layanan Amazon S3 baru dengan data konfigurasi baru:
```
s3 = new AWS.S3(s3.config);
```