全部產品
Search
文件中心

Object Storage Service:擷取儲存空間的儲存容量(C# SDK V2)

更新時間:Aug 06, 2025

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

注意事項

本文範例程式碼以華東1(杭州)的地區IDcn-hangzhou為例,預設使用外網Endpoint,如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS,請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係,請參見OSS地區和訪問網域名稱

範例程式碼

您可以使用以下代碼擷取儲存空間的儲存容量資訊。

using OSS = AlibabaCloud.OSS.V2; // 為阿里雲OSS SDK建立別名,簡化後續使用

var region = "cn-hangzhou"; // 必須項,設定Bucket所在的地區(Region)。以華東1(杭州)為例,Region填寫為cn-hangzhou
var bucket = "your bucket name";  // 必須項,設定目標Bucket名稱  
var endpoint = null as string;  // 可選項,指定訪問OSS服務的網域名稱。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com

// 載入OSS SDK的預設配置,此配置會自動從環境變數中讀取憑證資訊(如AccessKey)
var cfg = OSS.Configuration.LoadDefault();
// 顯式設定使用環境變數擷取憑證,用於身分識別驗證(格式:OSS_ACCESS_KEY_ID、OSS_ACCESS_KEY_SECRET)
cfg.CredentialsProvider = new OSS.Credentials.EnvironmentVariableCredentialsProvider();
// 設定配置的Bucket地區
cfg.Region = region;
// 若已指定了endpoint,則覆蓋預設的endpoint
if(endpoint != null)
{
    cfg.Endpoint = endpoint;
} 

// 使用配置資訊建立OSS用戶端執行個體
using var client = new OSS.Client(cfg);

// 調用GetBucketStatAsync方法,擷取指定Bucket的儲存容量資訊
var result = await client.GetBucketStatAsync(new OSS.Models.GetBucketStatRequest()
{
    Bucket = bucket
});

// 列印結果資訊
Console.WriteLine("GetBucketStat done");  // 提示操作完成
Console.WriteLine($"StatusCode: {result.StatusCode}");  // HTTP狀態代碼
Console.WriteLine($"RequestId: {result.RequestId}");  // RequestId,用於阿里雲排查問題
Console.WriteLine("Response Headers:");  // 回應標頭資訊
result.Headers.ToList().ForEach(x => Console.WriteLine(x.Key + " : " + x.Value));  // 遍曆並列印所有回應標頭
Console.WriteLine($"Storage: {result.BucketStat!.Storage}");  //  列印Bucket總儲存量
Console.WriteLine($"ObjectCount: {result.BucketStat!.ObjectCount}");  //  列印Bucket中總的Object數量

常用儲存容量資訊列表

參數

描述

Storage

儲存空間總儲存量,單位為位元組

ObjectCount

儲存空間中總的Object數量

MultipartUploadCount

儲存空間中已經初始化但還未完成或者還未中止的分區上傳數量

LiveChannelCount

儲存空間中Live Channel的數量

LastModifiedTime

此次調用擷取到的儲存資訊的時間點,格式為時間戳記,單位為秒

StandardStorage

標準儲存類型Object的儲存量,單位為位元組

StandardObjectCount

標準儲存類型Object數量

InfrequentAccessStorage

低頻儲存類型Object的計費儲存量,單位為位元組

InfrequentAccessRealStorage

低頻儲存類型Object的實際儲存量,單位為位元組

InfrequentAccessObjectCount

低頻儲存類型Object數量

ArchiveStorage

Archive Storage類型Object的計費儲存量,單位為位元組

ArchiveRealStorage

Archive Storage類型Object的實際儲存量,單位為位元組

ArchiveObjectCount

Archive Storage類型Object數量

ColdArchiveStorage

冷Archive Storage類型Object的計費儲存量,單位為位元組

ColdArchiveRealStorage

冷Archive Storage類型Object的實際儲存量,單位為位元組

ColdArchiveObjectCount

冷Archive Storage類型Object數量

相關文檔

關於擷取儲存空間資訊的完整範例程式碼,請參見GetBucketStat.cs