本文介紹如何擷取指定儲存空間(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。