全部產品
Search
文件中心

Object Storage Service:管理軟連結(Swift SDK)

更新時間:Nov 29, 2025

軟連結功能用於便捷訪問儲存空間內的熱門檔案。設定軟連結後,您可以使用類似於Windows的捷徑,通過軟連結開啟檔案。本文介紹如何使用OSS Swift SDK建立軟連結和擷取軟連結。

注意事項

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

  • 要建立軟連結,您必須具有oss:PutObject許可權;要擷取軟連結,您必須具有oss:GetObject許可權。具體操作,請參見為RAM使用者授予自訂的權限原則

範例程式碼

建立軟連結

您可以使用以下代碼建立軟連結。

import AlibabaCloudOSS
import Foundation

@main
struct Main {
    static func main() async {
        do {
            // 填寫Bucket所在地區(樣本:華東1為cn-hangzhou)
            let region = "cn-hangzhou"
            // 填寫Bucket名稱
            let bucket = "yourBucketName"
            // 可選項,指定訪問OSS服務的網域名稱。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com
            let endpoint: String? = nil
            // 填寫要建立的軟連結名稱(如:symlink.txt)
            let key = "yourSymlinkName"
            // 填寫軟連結的目標物件路徑(如:/path/to/target.txt)
            let symlinkTarget = "yourTargetObjectPath"

            // 初始化憑證提供器(從環境變數載入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.putSymlink(
                PutSymlinkRequest(
                    bucket: bucket,
                    key: key,
                    symlinkTarget: symlinkTarget
                )
            )
            print("result:\n\(result)")

        } catch {
            // 輸出錯誤資訊並繼續執行
            print("error:\(error)")
        }
    }
}

擷取軟連結

您可以使用以下代碼擷取軟連結以及軟連結指向的目標檔案名稱。

import AlibabaCloudOSS
import Foundation

@main
struct Main {
    static func main() async {

        do {
            // 填寫Bucket所在地區(樣本:華東1為cn-hangzhou)
            let region = "cn-hangzhou" // 替換為實際地區代碼
            // 填寫Bucket名稱
            let bucket = "yourBucketName" // 替換為實際Bucket名稱
            // 可選項,指定訪問OSS服務的網域名稱。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com
            let endpoint: String? = nil
            // 填寫要設定標籤的對象名稱(如:document.txt)
            let key = "yourObjectName" // 替換為實際對象名稱

            // 初始化憑證提供器(從環境變數載入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.getSymlink(
                GetSymlinkRequest(
                    bucket: bucket,
                    key: key
                )
            )
            print("result:\n\(result)")

        } catch {
            // 輸出錯誤資訊並繼續執行
            print("error:\(error)")
        }
    }
}

相關文檔

  • 關於軟連結的完整範例程式碼,請參見GitHub樣本put_symlinkget_symlink

  • 關於軟連結的更多操作資訊,請參見軟連結

  • 關於建立軟連結的API介面說明,請參見PutSymlink

  • 關於擷取軟連結的API介面說明,請參見GetSymlink