Download versi current atau spesifik dari objek menggunakan Node.js SDK - Object Storage Service

Secara default, ketika Anda memanggil operasi GetObject untuk suatu objek di bucket yang telah diaktifkan fitur Pengendalian versi, hanya versi terkini dari objek tersebut yang dikembalikan.

Informasi latar belakang

Ketika Anda memanggil operasi GetObject pada suatu bucket, salah satu dari tiga kasus berikut berlaku:

Jika versi terkini dari objek tersebut adalah penanda hapus, OSS mengembalikan respons 404 Not Found.
Jika Anda menentukan versionId objek dalam parameter kueri, versi yang ditentukan akan dikembalikan. Jika Anda mengatur versionId ke "null", versi objek yang memiliki versionId null akan dikembalikan.
Jika Anda mencoba mengambil penanda hapus dengan menentukan versionId-nya, OSS mengembalikan respons 405 Method Not Allowed.

Izin

Secara default, Akun Alibaba Cloud memiliki izin penuh. Pengguna RAM atau Peran RAM di bawah Akun Alibaba Cloud tidak memiliki izin apa pun secara default. Akun Alibaba Cloud atau administrator akun harus memberikan izin operasi melalui RAM Policy atau Bucket policies.

API	Action	Definisi
GetObject	`oss:GetObject`	Mengunduh objek.
	`oss:GetObjectVersion`	Saat mengunduh objek, jika Anda menentukan versi objek melalui versionId, izin ini diperlukan.
	`kms:Decrypt`	Saat mengunduh objek, jika metadata objek berisi X-Oss-Server-Side-Encryption: KMS, izin ini diperlukan.

Kode contoh

Kode contoh berikut menunjukkan cara mengunduh file:

const OSS = require('ali-oss');

const client = new OSS({
  // Setel yourregion ke wilayah tempat bucket berada. Misalnya, untuk wilayah China (Hangzhou), setel Region ke oss-cn-hangzhou.
  region: 'yourregion',
  // Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Setel yourbucketname ke nama bucket.
  bucket: 'yourbucketname'
});

async function get() {
  // Nama file.
  const result = await client.get('filename', {    
      // ID versi file yang akan diunduh.
      versionId: 'versionid',
  });
  console.log(result.content);
}
get();

Referensi

Untuk informasi selengkapnya tentang operasi API yang digunakan untuk mengunduh file, lihat GetObject.