全部產品
Search
文件中心

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

更新時間:Nov 29, 2025

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

注意事項

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

範例程式碼

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

import AlibabaCloudOSS
import Foundation

@main
struct Main {
    static func main() async {
        do {
            // 填寫Bucket所在地區。以華東1(杭州)為例,Region填寫為cn-hangzhou。
            let region = "cn-hangzhou"
            // 填寫Bucket名稱。
            let bucket = "yourBucketName"
            // 可選項,指定訪問OSS服務的網域名稱。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com
            let endpoint: String? = nil

            // 從環境變數載入憑證(需提前設定 OSS_ACCESS_KEY_ID 和 OSS_ACCESS_KEY_SECRET)
            let credentialsProvider = EnvironmentCredentialsProvider()

            // 配置OSS用戶端參數
            let config = Configuration.default()
                .withRegion(region) // 設定地區
                .withCredentialsProvider(credentialsProvider) // 設定憑證
                
            // 設定Endpoint
            if let endpoint = endpoint {
                config.withEndpoint(endpoint)
            }

            // 建立OSS用戶端執行個體
            let client = Client(config)

            // 執行擷取儲存空間統計資訊操作
            let result = try await client.getBucketStat(
                GetBucketStatRequest(
                    bucket: bucket
                )
            )

            // 輸出操作結果
            print("result:\n\(result)")

        } catch {
            // 捕獲並處理異常
            print("error:\n\(error)")
        }
    }
}

常用儲存容量資訊列表

參數

描述

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數量

相關文檔

  • 關於擷取儲存空間資訊的完整範例程式碼,請參見Github樣本

  • 關於擷取儲存空間資訊的API介面,請參見GetBucketStat