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.
# Memulai di Node.js
![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/id_id/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)
**Contoh kode Node.js ini menunjukkan:**
+ Cara membuat `package.json` manifes untuk proyek Anda.
+ Cara menginstal dan menyertakan modul yang digunakan proyek Anda.
+ Cara membuat objek layanan Amazon Simple Storage Service (Amazon S3) dari `AWS.S3` kelas klien.
+ Cara membuat bucket Amazon S3 dan mengunggah objek ke bucket itu.
## Skenario
Contoh menunjukkan cara mengatur dan menjalankan modul Node.js sederhana yang membuat bucket Amazon S3, lalu menambahkan objek teks ke dalamnya.
Karena nama bucket di Amazon S3 harus unik secara global, contoh ini menyertakan modul Node.js pihak ketiga yang menghasilkan nilai ID unik yang dapat Anda masukkan ke dalam nama bucket. Modul tambahan ini diberi nama`uuid`.
## Tugas Prasyarat
Untuk mengatur dan menjalankan contoh ini, Anda harus terlebih dahulu menyelesaikan tugas-tugas ini:
+ Buat direktori kerja untuk mengembangkan modul Node.js Anda. Beri nama direktori ini`awsnodesample`. Perhatikan bahwa direktori harus dibuat di lokasi yang dapat diperbarui oleh aplikasi. Misalnya, di Windows, jangan buat direktori di bawah "C:\$1Program Files”.
+ Instal Node.js. Untuk informasi selengkapnya, lihat [situs web Node.js](https://nodejs.org). Anda dapat menemukan unduhan versi Node.js saat ini dan LTS untuk berbagai sistem operasi di [https://nodejs. org/en/download/current](https://nodejs.org/en/download/current/)/.
**Contents**
+ [Skenario](#getting-started-nodejs-scenario)
+ [Tugas Prasyarat](#getting-started-nodejs-prerequisites)
+ [Langkah 1: Instal SDK dan Dependensi](#getting-started-nodejs-install-sdk)
+ [Langkah 2: Konfigurasikan Kredensial Anda](#getting-started-nodejs-credentials)
+ [Langkah 3: Buat Package JSON untuk Proyek](#getting-started-nodejs-download)
+ [Langkah 4: Tulis Kode Node.js](#getting-started-nodejs-js-code)
+ [Langkah 5: Jalankan Sampel](#getting-started-nodejs-run-sample)
## Langkah 1: Instal SDK dan Dependensi
Anda menginstal SDK untuk JavaScript paket menggunakan [npm (manajer paket Node.js](https://www.npmjs.com)).
Dari `awsnodesample` direktori dalam paket, ketik berikut ini di baris perintah.
```
npm install aws-sdk
```
Perintah ini menginstal SDK untuk JavaScript proyek Anda, dan memperbarui `package.json` untuk mencantumkan SDK sebagai dependensi proyek. [Anda dapat menemukan informasi tentang paket ini dengan mencari “aws-sdk” di situs web npm.](https://www.npmjs.com)
Selanjutnya, instal `uuid` modul ke proyek dengan mengetikkan yang berikut ini di baris perintah, yang menginstal modul dan pembaruan`package.json`. Untuk informasi selengkapnya`uuid`, lihat halaman modul di [https://www.npmjs.com/package/uuid](https://www.npmjs.com/package/uuid).
```
npm install uuid
```
Paket-paket ini dan kode terkaitnya dipasang di `node_modules` subdirektori proyek Anda.
Untuk informasi selengkapnya tentang menginstal paket Node.js, lihat [Mengunduh dan menginstal paket secara lokal](https://docs.npmjs.com/getting-started/installing-npm-packages-locally) dan [Membuat Modul Node.js](https://docs.npmjs.com/getting-started/creating-node-modules) di situs web [npm (Node.js package manager)](https://www.npmjs.com). Untuk informasi tentang mengunduh dan menginstal AWS SDK untuk JavaScript, lihat[Menginstal SDK untuk JavaScript](installing-jssdk.md).
## Langkah 2: Konfigurasikan Kredensial Anda
Anda perlu memberikan kredensyal AWS agar hanya akun Anda dan sumber dayanya yang diakses oleh SDK. Untuk informasi selengkapnya tentang mendapatkan kredensyal akun Anda, lihat. [Otentikasi SDK dengan AWS](getting-your-credentials.md)
Untuk menyimpan informasi ini, kami sarankan Anda membuat file kredensyal bersama. Untuk mempelajari caranya, lihat [Memuat Kredensial di Node.js dari File Kredensial Bersama](loading-node-credentials-shared.md). File kredensial Anda harus menyerupai contoh berikut.
```
[default]
aws_access_key_id = YOUR_ACCESS_KEY_ID
aws_secret_access_key = YOUR_SECRET_ACCESS_KEY
```
Anda dapat menentukan apakah Anda telah menyetel kredensialnya dengan benar dengan mengeksekusi kode berikut dengan Node.js:
```
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 dapat menampilkan nilai itu dengan menyetel variabel `AWS_SDK_LOAD_CONFIG` lingkungan ke nilai apa pun dan menggunakan kode berikut:
```
var AWS = require("aws-sdk");
console.log("Region: ", AWS.config.region);
```
## Langkah 3: Buat Package JSON untuk Proyek
Setelah Anda membuat direktori `awsnodesample` proyek, Anda membuat dan menambahkan `package.json` file untuk menyimpan metadata untuk proyek Node.js Anda. Untuk detail tentang penggunaan `package.json` dalam proyek Node.js, lihat [Membuat file package.json.](https://docs.npmjs.com/creating-a-package-json-file)
Di direktori proyek, buat file baru bernama`package.json`. Kemudian tambahkan JSON ini ke file.
```
{
"dependencies": {},
"name": "aws-nodejs-sample",
"description": "A simple Node.js application illustrating usage of the SDK for JavaScript.",
"version": "1.0.1",
"main": "sample.js",
"devDependencies": {},
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"author": "NAME",
"license": "ISC"
}
```
Simpan file tersebut. Saat Anda menginstal modul yang Anda butuhkan, `dependencies` bagian file akan selesai. [Anda dapat menemukan file JSON yang menunjukkan contoh dependensi ini di sini. GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/nodegetstarted/example_package.json)
## Langkah 4: Tulis Kode Node.js
Buat file baru bernama `sample.js` berisi kode contoh. Mulailah dengan menambahkan panggilan `require` fungsi untuk menyertakan SDK for JavaScript dan `uuid` modul sehingga tersedia untuk Anda gunakan.
Buat nama bucket unik yang digunakan untuk membuat bucket Amazon S3 dengan menambahkan nilai ID unik ke awalan yang dapat dikenali, dalam hal ini. `'node-sdk-sample-'` Anda menghasilkan ID unik dengan memanggil `uuid` modul. Kemudian buat nama untuk `Key` parameter yang digunakan untuk mengunggah objek ke bucket.
Buat `promise` objek untuk memanggil `createBucket` metode objek `AWS.S3` layanan. Pada respons yang berhasil, buat parameter yang diperlukan untuk mengunggah teks ke bucket yang baru dibuat. Menggunakan janji lain, panggil `putObject` metode untuk mengunggah objek teks ke ember.
```
// Load the SDK and UUID
var AWS = require("aws-sdk");
var uuid = require("uuid");
// Create unique bucket name
var bucketName = "node-sdk-sample-" + uuid.v4();
// Create name for uploaded object key
var keyName = "hello_world.txt";
// Create a promise on S3 service object
var bucketPromise = new AWS.S3({ apiVersion: "2006-03-01" })
.createBucket({ Bucket: bucketName })
.promise();
// Handle promise fulfilled/rejected states
bucketPromise
.then(function (data) {
// Create params for putObject call
var objectParams = {
Bucket: bucketName,
Key: keyName,
Body: "Hello World!",
};
// Create object upload promise
var uploadPromise = new AWS.S3({ apiVersion: "2006-03-01" })
.putObject(objectParams)
.promise();
uploadPromise.then(function (data) {
console.log(
"Successfully uploaded data to " + bucketName + "/" + keyName
);
});
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/nodegetstarted/sample.js).
## Langkah 5: Jalankan Sampel
Ketik perintah berikut untuk menjalankan sampel.
```
node sample.js
```
Jika unggahan berhasil, Anda akan melihat pesan konfirmasi di baris perintah. Anda juga dapat menemukan bucket dan objek teks yang diunggah di konsol [Amazon S3](https://console.aws.amazon.com/s3/).