軟連結功能用於便捷訪問儲存空間內的熱門檔案。設定軟連結後,您可以使用類似於Windows的捷徑,通過軟連結開啟檔案。本文介紹如何使用OSS Swift SDK建立軟連結和擷取軟連結。
注意事項
本文範例程式碼以華東1(杭州)的地區ID
cn-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_symlink和get_symlink。
關於軟連結的更多操作資訊,請參見軟連結。
關於建立軟連結的API介面說明,請參見PutSymlink。
關於擷取軟連結的API介面說明,請參見GetSymlink。