Object Storage Service：擷取對象標籤（Swift SDK）

注意事項

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

• 要擷取對象標籤，您必須具有oss:GetObjectTagging許可權。具體操作，請參見為RAM使用者授予自訂的權限原則。

範例程式碼

您可以使用以下代碼擷取儲存空間中的指定檔案的標籤資訊。

import AlibabaCloudOSS
import Foundation

@main
struct Main {
    static func main() async {
        do {
            // 填寫Bucket所在地區（樣本：華東1為cn-hangzhou）
            let region = "cn-hangzhou" // 實際地區代碼（華東1）
            // 填寫Bucket名稱
            let bucket = "your-bucket-name" // 實際Bucket名稱
            // 可選項，指定訪問OSS服務的網域名稱。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com
            let endpoint: String? = nil
            // 填寫要查詢標籤的對象名稱（如：document.txt）
            let key = "document.txt" // 實際對象名稱

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

            // 配置OSS用戶端參數（鏈式調用確保所有設定生效）
            let config = Configuration.default()
                .withRegion(region)          // 設定Bucket所在地區
                .withCredentialsProvider(credentialsProvider)  // 設定訪問憑證
                
            // 設定Endpoint
            if let endpoint = endpoint {
                config.withEndpoint(endpoint)
            }

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

            // 擷取指定對象的標籤資訊
            let result = try await client.getObjectTagging(
                GetObjectTaggingRequest(
                    bucket: bucket,
                    key: key
                )
            )
            print("result:\n\(result)") // 輸出標籤資訊

        } catch {
            // 錯誤輸出
            print("error：\(error)")
        }
    }
}
-

相關文檔

• 關於擷取對象標籤的完整範例程式碼，請參見GitHub樣本。

• 關於擷取對象標籤的API介面，請參見GetObjectTagging。