Object Storage Service：Buat bucket (Node.js SDK)

Catatan

• Topik ini menggunakan titik akhir publik wilayah China (Hangzhou). Untuk mengakses OSS dari layanan Alibaba Cloud lainnya di wilayah yang sama, gunakan titik akhir internal. Untuk informasi selengkapnya mengenai wilayah dan titik akhir yang didukung, lihat Wilayah dan titik akhir.

• Mulai pukul 10.00 (UTC+8) pada 13 Oktober 2025, OSS akan menerapkan penyesuaian bertahap di semua wilayah untuk mengaktifkan fitur Block Public Access secara default untuk bucket baru yang dibuat melalui API, OSS SDK, atau ossutil. Untuk informasi selengkapnya mengenai waktu pasti penerapan penyesuaian tersebut di setiap wilayah, lihat [Pengumuman Resmi] Penyesuaian Konfigurasi Pemblokiran Akses Publik untuk Bucket Baru. Setelah Block Public Access diaktifkan, Anda tidak dapat mengonfigurasi izin akses publik, termasuk ACL publik (baca-publik dan baca/tulis publik) serta kebijakan bucket yang mengizinkan akses publik. Anda dapat menonaktifkan fitur ini setelah bucket dibuat jika bisnis Anda memerlukan akses publik.

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 Kebijakan RAM atau Kebijakan bucket.

Kode contoh

Kode berikut menunjukkan contoh cara membuat bucket bernama examplebucket.

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

const client = new OSS({
  // Tentukan wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur region menjadi oss-cn-hangzhou.
  region: 'yourregion',
  // Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Tentukan nama bucket.
  bucket: 'yourBucketName',
});

// Buat bucket.
async function putBucket() {
  try {
    const options = {
      storageClass: 'Standard', // Kelas penyimpanan default bucket adalah Standard. Untuk mengatur kelas penyimpanan menjadi Archive, ganti Standard dengan Archive.
      acl: 'private', // Daftar kontrol akses (ACL) default bucket adalah private. Untuk mengatur ACL menjadi public-read, ganti private dengan public-read.
      dataRedundancyType: 'LRS' // Jenis pemulihan bencana data default bucket adalah penyimpanan redundan lokal (LRS). Untuk mengatur jenis pemulihan bencana data menjadi penyimpanan redundan zona (ZRS), ganti LRS dengan ZRS.
    }
    // Tentukan nama bucket.
    const result = await client.putBucket('examplebucket', options);
    console.log(result);
  } catch (err) {
    console.log(err);
  }
}

putBucket();        

Referensi

Untuk informasi selengkapnya mengenai operasi API untuk membuat bucket, lihat PutBucket.