AWS SDK untuk JavaScript V2 telah mencapai akhir dukungan. Kami menyarankan Anda bermigrasi ke AWS SDK untuk JavaScript v3. Untuk detail dan informasi tambahan tentang cara bermigrasi, silakan lihat pengumuman 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

Contoh Node.js kode ini menunjukkan:

Skenario

Contoh menunjukkan cara mengatur dan menjalankan Node.js modul 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 Node.js modul 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 menyelesaikan tugas ini terlebih dahulu:

Langkah 1: Instal SDK dan Dependensi

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

Dari awsnodesample direktori dalam paket, ketik berikut ini di baris perintah.

npm install aws-sdk

Perintah ini menginstal SDK untuk JavaScript dalam proyek Anda, dan memperbarui package.json untuk mencantumkan SDK sebagai ketergantungan 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 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 terkait diinstal di node_modules subdirektori proyek Anda.

Untuk informasi selengkapnya tentang menginstal Node.js paket, lihat Mengunduh dan menginstal paket secara lokal dan Node.js Membuat Modul di situs web https://www.npmjs.com npm (manajer Node.js paket). Untuk informasi tentang mengunduh dan menginstal AWS SDK untuk JavaScript, lihatMenginstal SDK untuk JavaScript.

Langkah 2: Konfigurasikan Kredensibilitas Anda

Anda perlu memberikan kredenSIAL AWS agar hanya akun Anda dan sumber dayanya yang diakses oleh SDK. Untuk informasi selengkapnya tentang mendapatkan kredenSIAL akun Anda, lihatOtentikasi SDK dengan AWS.

Untuk menyimpan informasi ini, kami sarankan Anda membuat file kredenSIAL 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 kredenSIAL Anda dengan benar dengan menjalankan 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 menyet AWS_SDK_LOAD_CONFIG el variabel lingkungan ke nilai apa pun dan menggunakan kode berikut:

var AWS = require("aws-sdk");

console.log("Region: ", AWS.config.region);

Langkah 3: Buat Paket JSON untuk Proyek

Setelah Anda membuat direktori awsnodesample proyek, Anda membuat dan menambahkan package.json file untuk menyimpan metadata untuk Node.js proyek Anda. Untuk detail tentang penggunaan package.json dalam Node.js proyek, 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 GitHub sini.

Langkah 4: Tulis Node.js Kode

Buat file baru bernama sample.js untuk 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 'node-sdk-sample-' ini. 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 memang createBucket gil 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 bucket.

// 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 sampel 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.