Kami mengumumkan yang akan datang end-of-support untuk AWS SDK for JavaScript v2. Kami menyarankan Anda bermigrasi ke AWS SDK for JavaScript v3. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, silakan merujuk ke pengumuman tertaut.

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

Memulai di Node.js

Contoh kode Node.js ini menunjukkan:

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 namauuid.

Tugas Prasyarat

Untuk mengatur dan menjalankan contoh ini, Anda harus terlebih dahulu menyelesaikan tugas-tugas ini:

Langkah 1: Instal SDK dan Dependensi

Anda menginstal SDK untuk JavaScript paket menggunakan npm (manajer paket Node.js).

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.

Selanjutnya, instal uuid modul ke proyek dengan mengetikkan yang berikut ini di baris perintah, yang menginstal modul dan pembaruanpackage.json. Untuk informasi lebih lanjut tentanguuid, lihat halaman modul di 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 dan Membuat Modul Node.js di situs web npm (Node.js package manager). Untuk informasi tentang mengunduh dan menginstal AWS SDK for JavaScript, lihatMenginstal SDK untuk JavaScript.

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

Untuk menyimpan informasi ini, kami sarankan Anda membuat file kredensyal bersama. Untuk mempelajari caranya, lihat Memuat Kredensial di Node.js dari File Kredensial Bersama. 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 mengatur 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.

Di direktori proyek, buat file baru bernamapackage.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

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.

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.