全部产品
Search
文档中心

Object Storage Service:Mendapatkan kapasitas penyimpanan bucket (Node.js SDK)

更新时间:Nov 30, 2025

Topik ini menjelaskan cara mendapatkan total kapasitas penyimpanan bucket tertentu serta jumlah dan kapasitas penyimpanan objek untuk setiap kelas penyimpanan dalam bucket tersebut.

Perhatian

Anda harus memiliki izin oss:GetBucketStat untuk mendapatkan kapasitas penyimpanan bucket. Untuk informasi selengkapnya, lihat Contoh umum kebijakan RAM.

Kode contoh

Kode berikut menunjukkan cara mendapatkan total kapasitas penyimpanan bucket bernama examplebucket serta jumlah dan kapasitas penyimpanan objek untuk setiap kelas penyimpanan dalam bucket tersebut.

Penting

Hanya Node.js SDK versi 6.18.0 atau yang lebih baru yang mendukung semua properti yang dikembalikan dalam kode contoh berikut.

const OSS = require("ali-oss");
const client = new OSS({
  // Setel yourRegion ke wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), setel wilayah menjadi oss-cn-hangzhou.
  region: "oss-cn-hangzhou",
  // 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,
  // Setel yourBucketName ke nama bucket.
  bucket: 'yourBucketName',
});

async function getBucketStat() {
  // Tentukan nama bucket. Misalnya, examplebucket.
  const bucket = "examplebucket";
  try {
    const stat = await client.getBucketStat(bucket);
    console.log("Total kapasitas penyimpanan bucket", stat.stat.Storage);
    console.log("Total jumlah objek dalam bucket", stat.stat.ObjectCount);
    console.log(
      "Jumlah unggah multi-bagian yang telah dimulai tetapi belum diselesaikan atau dibatalkan",
      stat.stat.MultipartUploadCount
    );
    console.log("Jumlah LiveChannel", stat.stat.LiveChannelCount);
    console.log("Semua bagian yang berhasil diunggah", stat.stat.MultipartPartCount);
    console.log("Jumlah penanda hapus", stat.stat.DeleteMarkerCount);
    console.log("Waktu saat informasi penyimpanan diambil", stat.stat.LastModifiedTime);
    console.log("Kapasitas penyimpanan kelas penyimpanan Standard", stat.stat.StandardStorage);
    console.log("Jumlah objek dalam kelas penyimpanan Standard", stat.stat.StandardObjectCount);
    console.log("Kapasitas penyimpanan yang ditagih untuk kelas penyimpanan Infrequent Access", stat.stat.InfrequentAccessStorage);
    console.log(
      "Kapasitas penyimpanan aktual untuk kelas penyimpanan Infrequent Access",
      stat.stat.InfrequentAccessRealStorage
    );
    console.log(
      "Jumlah objek dalam kelas penyimpanan Infrequent Access",
      stat.stat.InfrequentAccessObjectCount
    );
    console.log("Kapasitas penyimpanan yang ditagih untuk kelas penyimpanan Archive Storage", stat.stat.ArchiveStorage);
    console.log("Kapasitas penyimpanan aktual untuk kelas penyimpanan Archive Storage", stat.stat.ArchiveRealStorage);
    console.log("Jumlah objek dalam kelas penyimpanan Archive Storage", stat.stat.ArchiveObjectCount);
    console.log("Kapasitas penyimpanan yang ditagih untuk kelas penyimpanan Cold Archive", stat.stat.ColdArchiveStorage);
    console.log("Kapasitas penyimpanan aktual untuk kelas penyimpanan Cold Archive", stat.stat.ColdArchiveRealStorage);
    console.log("Jumlah objek dalam kelas penyimpanan Cold Archive", stat.stat.ColdArchiveObjectCount);
    console.log(
      "Kapasitas penyimpanan yang ditagih untuk kelas penyimpanan Deep Cold Archive",
      stat.stat.DeepColdArchiveStorage
    );
    console.log(
      "Kapasitas penyimpanan aktual untuk kelas penyimpanan Deep Cold Archive",
      stat.stat.DeepColdArchiveRealStorage
    );
    console.log(
      "Jumlah objek dalam kelas penyimpanan Deep Cold Archive",
      stat.stat.DeepColdArchiveObjectCount
    );
  } catch (error) {
    console.error("Kesalahan saat mendapatkan statistik bucket:", error);
  }
}
getBucketStat();

Referensi

Untuk informasi selengkapnya mengenai operasi API, lihat GetBucketStat.