全部產品
Search
文件中心

Object Storage Service:擷取儲存空間的儲存容量(Node.js SDK)

更新時間:Nov 29, 2025

本文介紹如何擷取指定儲存空間(Bucket)的總儲存容量以及Bucket內不同儲存類型檔案(Object)的數量及其儲存容量。

注意事項

要擷取儲存空間的儲存容量,您必須有oss:GetBucketStat許可權。具體操作,請參見RAM Policy常見樣本

範例程式碼

以下代碼用於擷取examplebucket的總儲存容量以及該Bucket內不同儲存類型Object的數量及其儲存容量。

重要

僅Node.js SDK 6.18.0及以上版本支援返回以下範例程式碼中包含的所有屬性。

const OSS = require("ali-oss");
const client = new OSS({
  // yourRegion填寫Bucket所在地區。以華東1(杭州)為例,Region填寫為oss-cn-hangzhou。
  region: "oss-cn-hangzhou",
  // 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // yourBucketName填寫Bucket名稱。
  bucket: 'yourBucketName',
});

async function getBucketStat() {
  // 填寫儲存空間名稱,例如examplebucket。
  const bucket = "examplebucket";
  try {
    const stat = await client.getBucketStat(bucket);
    console.log("Bucket的總儲存量", stat.stat.Storage);
    console.log("Bucket中總的Object數量", stat.stat.ObjectCount);
    console.log(
      "已經初始化但還未完成(Complete)或者還未中止(Abort)的Multipart Upload數量",
      stat.stat.MultipartUploadCount
    );
    console.log("Live Channel的數量", stat.stat.LiveChannelCount);
    console.log("所有已經成功上傳的Part", stat.stat.MultipartPartCount);
    console.log("刪除標記的數量", stat.stat.DeleteMarkerCount);
    console.log("擷取到儲存資訊的時間點", stat.stat.LastModifiedTime);
    console.log("標準儲存類型的儲存量", stat.stat.StandardStorage);
    console.log("標準儲存類型的Object數量", stat.stat.StandardObjectCount);
    console.log("低頻儲存類型的計費儲存量", stat.stat.InfrequentAccessStorage);
    console.log(
      "低頻儲存類型的實際儲存量",
      stat.stat.InfrequentAccessRealStorage
    );
    console.log(
      "低頻儲存類型的Object數量",
      stat.stat.InfrequentAccessObjectCount
    );
    console.log("Archive Storage類型的計費儲存量", stat.stat.ArchiveStorage);
    console.log("Archive Storage類型的實際儲存量", stat.stat.ArchiveRealStorage);
    console.log("Archive Storage類型的Object數量", stat.stat.ArchiveObjectCount);
    console.log("冷Archive Storage類型的計費儲存量", stat.stat.ColdArchiveStorage);
    console.log("冷Archive Storage類型的實際儲存量", stat.stat.ColdArchiveRealStorage);
    console.log("冷Archive Storage類型的Object數量", stat.stat.ColdArchiveObjectCount);
    console.log(
      "深度冷Archive Storage類型的計費儲存量",
      stat.stat.DeepColdArchiveStorage
    );
    console.log(
      "深度冷Archive Storage類型的實際儲存量",
      stat.stat.DeepColdArchiveRealStorage
    );
    console.log(
      "深度冷Archive Storage類型的Object數量",
      stat.stat.DeepColdArchiveObjectCount
    );
  } catch (error) {
    console.error("擷取Bucket統計資訊時出錯", error);
  }
}
getBucketStat();

相關文檔

關於擷取指定Bucket的儲存容量以及該Bucket內不同儲存類型Object的數量及其儲存容量的API介面說明,請參見GetBucketStat