全部产品
Search
文档中心

Object Storage Service:Daftar bucket (Node.js SDK)

更新时间:Nov 30, 2025

Bucket adalah wadah untuk menyimpan objek. Semua objek harus disimpan dalam sebuah bucket, yang ditampilkan secara alfabetis. Anda dapat menampilkan daftar bucket yang dimiliki oleh Akun Alibaba Cloud Anda di seluruh wilayah dan memfilternya berdasarkan kondisi tertentu.

Daftar semua bucket

Kode berikut menunjukkan cara menampilkan daftar semua bucket di seluruh wilayah dalam Akun Alibaba Cloud saat ini.

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

const client = new OSS({
  // Setel region ke wilayah tempat bucket berada. Misalnya, jika bucket berada di 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 bucket ke nama bucket Anda.
  bucket: 'yourBucketName',
});

async function listBuckets() {
  try {
    // Tampilkan daftar semua bucket di semua wilayah dalam akun Anda.
    const result = await client.listBuckets();
    console.log(result);
  } catch (err) {
    console.log(err);
  }
}

listBuckets();

Daftar bucket dengan awalan tertentu

Kode berikut menunjukkan cara menampilkan daftar bucket yang memiliki awalan "example" di seluruh wilayah dalam Akun Alibaba Cloud saat ini.

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

const client = new OSS({
  // Setel region ke wilayah tempat bucket berada. Misalnya, jika bucket berada di 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 bucket ke nama bucket Anda.
  bucket: 'yourBucketName',
});

async function listBuckets() {
  try {
    const result = await client.listBuckets({
      // Tentukan awalan.
      prefix: 'example' 
    });
    // Tampilkan daftar bucket dengan awalan yang ditentukan di semua wilayah dalam akun Anda.
    console.log(result);
  } catch (err) {
    console.log(err);
  }
}

listBuckets();

Daftar bucket setelah penanda tertentu

Kode berikut menunjukkan cara menampilkan daftar bucket yang namanya secara alfabetis berada setelah "examplebucket" di seluruh wilayah dalam Akun Alibaba Cloud saat ini.

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

const client = new OSS({
  // Setel region ke wilayah tempat bucket berada. Misalnya, jika bucket berada di 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 bucket ke nama bucket Anda.
  bucket: 'yourBucketName',
});

async function listBuckets() {
  try {
    const result = await client.listBuckets({
      // Tentukan penanda.
      marker: 'examplebucket' 
    });
    // Tampilkan daftar bucket yang muncul setelah examplebucket dalam urutan alfabetis di semua wilayah dalam akun Anda.
    console.log(result);
  } catch (err) {
    console.log(err);
  }
}

listBuckets();

Daftar jumlah bucket tertentu

Kode berikut menunjukkan cara menampilkan daftar bucket di seluruh wilayah dalam Akun Alibaba Cloud saat ini dengan membatasi jumlah bucket yang dikembalikan maksimal 500.

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

const client = new OSS({
  // Setel region ke wilayah tempat bucket berada. Misalnya, jika bucket berada di 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 bucket ke nama bucket Anda.
  bucket: 'yourBucketName',
});

async function listBuckets() {
  try {
    const result = await client.listBuckets({
      // Parameter max-keys menentukan jumlah maksimum bucket yang dikembalikan. Nilai max-keys tidak boleh melebihi 1.000. Jika Anda tidak menentukan max-keys, maksimal 100 bucket akan dikembalikan secara default.
      // Tampilkan 500 bucket.
      'max-keys': 500
    });
    console.log(result);
  } catch (err) {
    console.log(err);
  }
}

listBuckets();

Referensi

  • Untuk kode contoh lengkap tentang penayangan daftar bucket, lihat contoh GitHub.

  • Untuk informasi selengkapnya mengenai operasi API untuk menampilkan daftar bucket, lihat ListBuckets (GetService).