軟鏈接功能用于便捷訪問Bucket內的常用Object。設置軟鏈接后,您可以使用類似于Windows的快捷方式,通過軟鏈接文件打開Object。
注意事項
使用本文示例前您需要先通過自定義域名、STS等方式新建OSSClient,具體請參見初始化。
創建軟鏈接
以下代碼用于為examplebucket中的exampleobject.txt文件創建名為examplesymlink的軟鏈接。
OSSPutSymlinkRequest *request = [OSSPutSymlinkRequest new];
// 填寫Bucket名稱,例如examplebucket。
request.bucketName = @"examplebucket";
// 填寫軟鏈接名稱。
request.objectKey = @"examplesymlink";
// 填寫軟鏈接指定的Object完整路徑,Object完整路徑中不能包含Bucket名稱。
request.targetObjectName = @"exampleobject.txt";
OSSTask *putSymlinkTask = [client putSymlink:request];
[putSymlinkTask continueWithBlock:^id _Nullable(OSSTask * _Nonnull task) {
if (!task.error) {
NSLog(@"put symlink success");
} else {
NSLog(@"put symlink failed, error: %@", task.error);
}
return nil;
}];
// 實現同步阻塞等待任務完成。
// [putSymlinkTask waitUntilFinished];
獲取軟鏈接
獲取軟鏈接要求您對該軟鏈接具有讀權限。
以下代碼用于獲取examplebucket存儲空間中軟鏈接examplesymlink指向的目標文件名稱。
OSSGetSymlinkRequest *request = [OSSGetSymlinkRequest new];
// 填寫Bucket名稱,例如examplebucket。
request.bucketName = @"examplebucket";
// 填寫軟鏈接名稱。
request.objectKey = @"examplesymlink";
OSSTask *getSymlinkTask = [client getSymlink:request];
[getSymlinkTask continueWithBlock:^id _Nullable(OSSTask * _Nonnull task) {
if (!task.error) {
OSSGetSymlinkResult *result = task.result;
NSLog(@"get symlink: %@", result.httpResponseHeaderFields[@"x-oss-symlink-target"]);
} else {
NSLog(@"get symlink failed, error: %@", task.error);
}
return nil;
}];
// 實現同步阻塞等待任務完成。
// [putSymlinkTask waitUntilFinished];
相關文檔
關于創建軟鏈接的API接口說明,請參見PutSymlink。
關于獲取軟鏈接的API接口說明,請參見GetSymlink。
關于初始化OSSClient,請參見如何初始化OSSClient實例。
文檔內容是否對您有幫助?