全部產品
Search
文件中心

Object Storage Service:判斷儲存空間是否存在(Swift SDK)

更新時間:Nov 29, 2025

本文介紹如何判斷指定的儲存空間是否存在。

注意事項

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

  • 要判斷儲存空間是否存在,您必須具有oss:GetBucketAcl許可權。具體操作,請參見為RAM使用者授予自訂的權限原則

範例程式碼

您可以使用以下代碼判斷儲存空間是否存在。

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)

            // 執行Bucket存在性檢查
            let result = try await client.isBucketExist(bucket)
            print("result:\n\(result)") // 輸出檢查結果

        } catch {
            // 終止程式並輸出錯誤資訊
            print("error:\(error)")
        }
    }
}

相關文檔

  • 關於判斷儲存空間是否存在的完整範例程式碼,請參見isBucketExist