軟鏈接功能用于便捷訪問Bucket內的常用Object。設置軟鏈接后,您可以通過類似于Windows的快捷方式,打開軟鏈接文件來訪問Object。
注意事項
對標準存儲或低頻訪問類型的Object設置軟鏈接后,可通過軟鏈接文件訪問Object。
對歸檔存儲、冷歸檔存儲或者深度冷歸檔存儲類型Object設置軟鏈接后,如果需要通過軟鏈接文件訪問Object,則Object需要先完成解凍操作。更多信息,請參見解凍文件。
軟鏈接存儲的是目標文件的路徑名,而非文件內容。因此,軟鏈接占用的存儲容量主要取決于其指向的目標文件路徑的長度,而非目標文件的實際大小。例如,軟鏈接指向一個大小為1MB,名稱為image.jpg的目標文件,軟鏈接本身占用的存儲容量約為0.009KB。
軟鏈接的訪問權限遵循最小權限原則。如果軟鏈接設置為私有,即使目標文件為公共讀,用戶也無法通過該軟鏈接訪問目標文件;同樣,即使軟鏈接設置為公共讀,但目標文件為私有,用戶仍無法訪問目標文件。
操作步驟
使用OSS控制臺
登錄OSS管理控制臺。
單擊Bucket 列表,然后單擊目標Bucket名稱。
在左側導航欄,選擇文件管理>文件列表。
在目標文件右側的操作欄下,選擇 。
在設置軟鏈接面板,設置軟鏈接文件目錄,然后單擊確定。
設置軟鏈接文件目錄名稱時,請遵循界面提示的命名規范。假設您當前的文件在/test/目錄下:
如果選擇絕對路徑,命名為t1-symlink,則軟連接所在路徑是
/t1-symlink
。如果選擇相對路徑,命名為t2-symlink,則軟連接所在路徑是
/test/t2-symlink
。
重要如果設置的軟鏈接文件名未包含文件擴展名,例如文件myphoto.jpg的軟鏈接文件名為myphoto,通過控制臺或URL訪問該軟鏈接文件時可正常預覽。通過工具或控制臺下載該軟鏈接文件時,因文件無文件擴展名,下載后是一個未知文件,無法直接打開。如需打開文件,請添加正確的文件擴展名。
使用圖形化管理工具ossbrowser
ossbrowser支持的Object級別的操作與控制臺支持的操作類似,請按照ossbrowser界面指引完成設置軟鏈接的操作。關于如何使用ossbrowser,請參見快速使用ossbrowser。
使用阿里云SDK
以下僅列舉常見SDK的設置軟鏈接的代碼示例。關于其他SDK的設置軟鏈接的代碼示例,請參見SDK簡介。
import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.*;
public class Demo {
public static void main(String[] args) throws Exception {
// Endpoint以華東1(杭州)為例,其它Region請按實際情況填寫。
String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 從環境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
// 填寫Bucket名稱,例如examplebucket。
String bucketName = "examplebucket";
// 指定軟鏈接名稱。
String symLink = "yourSymLink";
// 指定軟鏈接指向的目標Object名稱。
String destinationObjectName = "yourDestinationObjectName";
// 填寫Bucket所在地域。以華東1(杭州)為例,Region填寫為cn-hangzhou。
String region = "cn-hangzhou";
// 創建OSSClient實例。
ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
OSS ossClient = OSSClientBuilder.create()
.endpoint(endpoint)
.credentialsProvider(credentialsProvider)
.clientConfiguration(clientBuilderConfiguration)
.region(region)
.build();
try {
// 創建上傳文件元數據。
ObjectMetadata metadata = new ObjectMetadata();
metadata.setContentType("text/plain");
// 設置自定義元數據property的值為property-value。
metadata.addUserMetadata("property", "property-value");
// 指定創建軟鏈接時是否覆蓋同名Object。
// metadata.setHeader("x-oss-forbid-overwrite", "true");
// 指定Object的訪問權限。
// metadata.setHeader(OSSHeaders.OSS_OBJECT_ACL, CannedAccessControlList.Default);
// 指定Object的存儲類型。
// metadata.setHeader(OSSHeaders.OSS_STORAGE_CLASS, StorageClass.Standard);
// 創建CreateSymlinkRequest。
CreateSymlinkRequest createSymlinkRequest = new CreateSymlinkRequest(bucketName, symLink, destinationObjectName);
// 設置元數據。
createSymlinkRequest.setMetadata(metadata);
// 創建軟鏈接。
ossClient.createSymlink(createSymlinkRequest);
} catch (OSSException oe) {
System.out.println("Caught an OSSException, which means your request made it to OSS, "
+ "but was rejected with an error response for some reason.");
System.out.println("Error Message:" + oe.getErrorMessage());
System.out.println("Error Code:" + oe.getErrorCode());
System.out.println("Request ID:" + oe.getRequestId());
System.out.println("Host ID:" + oe.getHostId());
} catch (ClientException ce) {
System.out.println("Caught an ClientException, which means the client encountered "
+ "a serious internal problem while trying to communicate with OSS, "
+ "such as not being able to access the network.");
System.out.println("Error Message:" + ce.getMessage());
} finally {
if (ossClient != null) {
ossClient.shutdown();
}
}
}
}
<?php
if (is_file(__DIR__ . '/../autoload.php')) {
require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
require_once __DIR__ . '/../vendor/autoload.php';
}
use OSS\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;
use OSS\CoreOssException;
// 從環境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// Endpoint以華東1(杭州)為例,其他Region請按實際情況填寫。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 填寫Bucket名稱,例如examplebucket。
$bucket= "examplebucket";
// 指定軟鏈接指向的目標Object名稱,例如exampleobject.txt。
$object = "exampleobject.txt";
// 指定軟鏈接名稱,例如examplesymlink.txt。
$symlink = "examplesymlink.txt";
$options[OssClient::OSS_HEADERS] = array(
// 指定創建軟鏈接時是否允許覆蓋同名目標Object。此處設置為true,表示禁止覆蓋同名目標Object。
'x-oss-forbid-overwrite'=>"true",
// 指定Object的訪問權限。此處設置為private,表示私有權限。即只有Object的擁有者和授權用戶有該Object的讀寫權限,其他用戶沒有權限操作該Object。
'x-oss-object-acl' =>"private",
// 指定Object的存儲類型。此處設置為Standard,表示標準存儲類型。
'x-oss-storage-class' =>"Standard"
);
try {
$config = array(
"provider" => $provider,
"endpoint" => $endpoint,
"signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
"region"=> "cn-hangzhou"
);
$ossClient = new OssClient($config);
$ossClient->putSymlink($bucket, $symlink, $object,$options);
} catch (OssException $e) {
printf($e->getMessage() . "\n");
return;
}
const OSS = require('ali-oss')
const client = new OSS({
// yourregion填寫Bucket所在地域。以華東1(杭州)為例,Region填寫為oss-cn-hangzhou。
region: 'yourRegion',
// 從環境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
authorizationV4: true,
// 填寫Bucket名稱。
bucket: 'examplebucket',
});
const headers = {
// 指定Object的存儲類型。
'x-oss-storage-class':'Standard',
// 指定Object的訪問權限。
'x-oss-object-acl':'private',
// 指定創建軟鏈接時是否覆蓋同名Object。設置為true,表示禁止覆蓋同名Object。
'x-oss-forbid-overwrite': 'true '
};
async function put () {
try {
// 分別指定軟鏈接名稱為symlinkobject.txt、軟鏈接指向的目標Object名稱為exampleobject.txt。
const result = await client.putSymlink('symlinkobject.txt', 'exampleobject.txt'
// ,{ headers }
);
console.log(result);
} catch (e) {
console.log(e);
}
}
put();
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# 從環境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# 填寫Bucket所在地域對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region信息,例如cn-hangzhou。注意,v4簽名下,必須填寫該參數
region = "cn-hangzhou"
# examplebucket填寫存儲空間名稱。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# 指定軟鏈接指向的目標Object名稱,例如exampleobject.txt。關于Object名稱命名規范的更多信息,請參見Object。
object_name = 'exampleobject.txt'
# 指定軟鏈接名稱,例如examplesymlick.txt。
symlink = 'examplesymlick.txt'
# headers = dict()
# 指定創建軟鏈接時是否允許覆蓋同名目標Object。此處設置為true,表示禁止覆蓋同名目標Object。
# headers['x-oss-forbid-overwrite'] = 'true'
# 指定Object的訪問權限。此處設置為OBJECT_ACL_PRIVATE,表示私有權限。即只有Object的擁有者和授權用戶有該Object的讀寫權限,其他用戶沒有權限操作該Object。
# headers[OSS_OBJECT_ACL] = oss2.OBJECT_ACL_PRIVATE
# 指定Object的存儲類型。此處設置為BUCKET_STORAGE_CLASS_STANDARD,表示標準存儲類型。
# headers['x-oss-storage-class'] = oss2.BUCKET_STORAGE_CLASS_STANDARD
# bucket.put_symlink(object_name, symlink, headers=headers)
# 創建軟鏈接。
bucket.put_symlink(object_name, symlink)
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<title>Document</title>
</head>
<body>
<button id='upload'>上傳</button>
<button id='symlink'>創建軟鏈接</button>
<!--導入SDK文件-->
<script type="text/javascript" src="https://gosspublic.alicdn.com/aliyun-oss-sdk-6.18.0.min.js"></script>
<script type="text/javascript">
const client = new OSS({
// yourRegion填寫Bucket所在地域。以華東1(杭州)為例,yourRegion填寫為oss-cn-hangzhou。
region: 'yourRegion',
authorizationV4: true,
// 從STS服務獲取的臨時訪問密鑰(AccessKey ID和AccessKey Secret)。
accessKeyId: 'yourAccessKeyId',
accessKeySecret: 'yourAccessKeySecret',
// 從STS服務獲取的安全令牌(SecurityToken)。
stsToken: 'yourSecurityToken',
// 填寫Bucket名稱,例如examplebucket。
bucket: "examplebucket",
});
const upload = document.getElementById('upload')
const symlink = document.getElementById('symlink')
const getSymlink = document.getElementById("getSymlink")
// 指定待上傳的文件內容。
const file = new Blob(['examplecontent'])
// 指定上傳至Bucket中的Object名稱。
const fileName = 'exampleobject.txt'
// 上傳文件。
upload.addEventListener('click', () => {
client.put(fileName, file).then(r => console.log(r))
})
// 創建名為symlink.txt的軟鏈接。
symlink.addEventListener('click', () => {
client.putSymlink('symlink.txt', fileName).then(r => console.log(r))
})
</script>
</body>
</html>
using Aliyun.OSS;
using System.Text;
// yourEndpoint填寫Bucket所在地域對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
var endpoint = "yourEndpoint";
// 從環境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// 填寫Bucket名稱,例如examplebucket。
var bucketName = "examplebucket";
var targetObjectName = "yourTargetObjectName";
var symlinkObjectName = "yourSymlinkObjectName";
var objectContent = "More than just cloud.";
// 填寫Bucket所在地域對應的Region。以華東1(杭州)為例,Region填寫為cn-hangzhou。
const string region = "cn-hangzhou";
// 創建ClientConfiguration實例,按照您的需要修改默認參數。
var conf = new ClientConfiguration();
// 設置v4簽名。
conf.SignatureVersion = SignatureVersion.V4;
// 創建OssClient實例。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
c.SetRegion(region);
try
{
// 上傳目標文件。
byte[] binaryData = Encoding.ASCII.GetBytes(objectContent);
MemoryStream requestContent = new MemoryStream(binaryData);
client.PutObject(bucketName, targetObjectName, requestContent);
// 創建軟鏈接。
client.CreateSymlink(bucketName, symlinkObjectName, targetObjectName);
// 獲取軟鏈接指向的目標文件名稱。
var ossSymlink = client.GetSymlink(bucketName, symlinkObjectName);
Console.WriteLine("Target object is {0}", ossSymlink.Target);
}
catch (Exception ex)
{
Console.WriteLine("Failed with error info: {0}", ex.Message);
}
// 構建請求。
PutSymlinkRequest putSymlink = new PutSymlinkRequest();
// 填寫Bucket名稱。
putSymlink.setBucketName("yourBucketName");
// 設置軟鏈接名稱。
putSymlink.setObjectKey("yourSymLink");
// 指定軟鏈接指向的目標Object名稱。
putSymlink.setTargetObjectName("yourTargetObjectName");
ObjectMetadata metadata = new ObjectMetadata();
// 設置是否禁止覆蓋同名Object。此處設置為true,表示禁止覆蓋同名Object。
//metadata.setHeader("x-oss-forbid-overwrite", "true");
// 指定Object的訪問權限。此處設置為private,表示私有權限。
//metadata.setHeader("x-oss-object-acl", "private");
// 指定Object存儲類型。此處設置為Standard,表示標準存儲。
//metadata.setHeader("x-oss-storage-class", "Standard");
putSymlink.setMetadata(metadata);
OSSAsyncTask task = oss.asyncPutSymlink(putSymlink, new OSSCompletedCallback<PutSymlinkRequest, PutSymlinkResult>() {
@Override
public void onSuccess(PutSymlinkRequest request, PutSymlinkResult result) {
Log.d("PutSymlink", "PutSymlink success");
}
@Override
public void onFailure(PutSymlinkRequest request, ClientException clientException,
ServiceException serviceException) {
// 請求異常。
if (clientException != null) {
// 客戶端異常,例如網絡異常等。
clientException.printStackTrace();
}
if (serviceException != null) {
// 服務端異常。
Log.e("ErrorCode", serviceException.getErrorCode());
Log.e("RequestId", serviceException.getRequestId());
Log.e("HostId", serviceException.getHostId());
Log.e("RawMessage", serviceException.getRawMessage());
}
}
});
task.waitUntilFinished();
package main
import (
"log"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
// 從環境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
log.Fatalf("Failed to create credentials provider: %v", err)
}
// 創建OSSClient實例。
// yourEndpoint填寫Bucket對應的Endpoint,以華東1(杭州)為例,填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
// yourRegion填寫Bucket所在地域,以華東1(杭州)為例,填寫為cn-hangzhou。其它Region請按實際情況填寫。
clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
clientOptions = append(clientOptions, oss.Region("yourRegion"))
// 設置簽名版本
clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
client, err := oss.New("yourEndpoint", "", "", clientOptions...)
if err != nil {
log.Fatalf("Failed to create OSS client: %v", err)
}
// 填寫Bucket名稱,例如examplebucket。
bucketName := "examplebucket"
// 指定軟鏈接名稱,例如examplesymlink。
symObjectKey := "examplesymlink.txt"
// 指定軟鏈接指向的目標Object名稱,例如exampleobject.txt。
objectName := "exampleobject.txt"
bucket, err := client.Bucket(bucketName)
if err != nil {
log.Fatalf("Failed to get bucket '%s': %v", bucketName, err)
}
// 創建軟鏈接。
options := []oss.Option{
// 指定創建軟鏈接時是否覆蓋同名Object。true表示覆蓋,false表示不覆蓋。
oss.ForbidOverWrite(true),
// 指定Object的訪問權限。此處指定為Private,表示私有訪問權限。
oss.ObjectACL(oss.ACLPrivate),
// 指定Object的存儲類型。此處指定為Standard,表示標準存儲類型。
oss.StorageClass(oss.StorageStandard),
}
err = bucket.PutSymlink(symObjectKey, objectName, options...)
if err != nil {
log.Fatalf("Failed to create symlink '%s' pointing to '%s': %v", symObjectKey, objectName, err)
}
log.Println("Symlink created successfully")
}
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];
#include <alibabacloud/oss/OssClient.h>
using namespace AlibabaCloud::OSS;
int main(void)
{
/* yourEndpoint填寫Bucket所在地域對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。*/
std::string Endpoint = "yourEndpoint";
/* yourRegion填寫Bucket所在地域對應的Region。以華東1(杭州)為例,Region填寫為cn-hangzhou。*/
std::string Region = "yourRegion";
/* 填寫Bucket名稱,例如examplebucket。*/
std::string BucketName = "examplebucket";
/* 填寫Object完整路徑,例如exampledir/exampleobject.txt。Object完整路徑中不能包含Bucket名稱。*/
std::string ObjectName = "exampledir/exampleobject.txt";
/* 填寫軟鏈接完整路徑,例如shortcut/myobject.txt。*/
std::string LinkName = "shortcut/myobject.txt";
/* 初始化網絡等資源。*/
InitializeSdk();
ClientConfiguration conf;
conf.signatureVersion = SignatureVersionType::V4;
/* 從環境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。*/
auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
OssClient client(Endpoint, credentialsProvider, conf);
client.SetRegion(Region);
/* 設置HTTP header。*/
auto meta = ObjectMetaData();
meta.setContentType("text/plain");
/* 設置自定義文件元數據。*/
meta.UserMetaData()["meta"] = "meta-value";
/* 創建軟鏈接。*/
CreateSymlinkRequest request(BucketName, ObjectName, meta);
request.SetSymlinkTarget(LinkName);
auto outcome = client.CreateSymlink(request);
if (!outcome.isSuccess()) {
/* 異常處理。*/
std::cout << "CreateSymlink fail" <<
",code:" << outcome.error().Code() <<
",message:" << outcome.error().Message() <<
",requestId:" << outcome.error().RequestId() << std::endl;
return -1;
}
/* 釋放網絡等資源。*/
ShutdownSdk();
return 0;
}
#include "oss_api.h"
#include "aos_http_io.h"
/* yourEndpoint填寫Bucket所在地域對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。*/
const char *endpoint = "yourEndpoint";
/* 填寫Bucket名稱,例如examplebucket。*/
const char *bucket_name = "examplebucket";
/* 填寫Object完整路徑,完整路徑中不能包含Bucket名稱,例如exampledir/exampleobject.txt。*/
const char *object_name = "exampledir/exampleobject.txt";
/* 填寫軟鏈接完整路徑。*/
const char *link_object_name = "yourLinkObjectName";
/* yourRegion填寫Bucket所在地域對應的Region。以華東1(杭州)為例,Region填寫為cn-hangzhou。*/
const char *region = "yourRegion";
void init_options(oss_request_options_t *options)
{
options->config = oss_config_create(options->pool);
/* 用char*類型的字符串初始化aos_string_t類型。*/
aos_str_set(&options->config->endpoint, endpoint);
/* 從環境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。*/
aos_str_set(&options->config->access_key_id, getenv("OSS_ACCESS_KEY_ID"));
aos_str_set(&options->config->access_key_secret, getenv("OSS_ACCESS_KEY_SECRET"));
//需要額外配置以下兩個參數
aos_str_set(&options->config->region, region);
options->config->signature_version = 4;
/* 是否使用了CNAME。0表示不使用。*/
options->config->is_cname = 0;
/* 用于設置網絡相關參數,比如超時時間等。*/
options->ctl = aos_http_controller_create(options->pool, 0);
}
int main(int argc, char *argv[])
{
/* 在程序入口調用aos_http_io_initialize方法來初始化網絡、內存等全局資源。*/
if (aos_http_io_initialize(NULL, 0) != AOSE_OK) {
exit(1);
}
/* 用于創建內存管理的內存池(pool),等價于apr_pool_t。其實現代碼在apr庫中。*/
aos_pool_t *pool;
/* 重新創建一個內存池,第二個參數是NULL,表示沒有繼承其它內存池。*/
aos_pool_create(&pool, NULL);
/* 創建并初始化options,該參數包括endpoint、access_key_id、access_key_secret、is_cname、curl等全局配置信息。*/
oss_request_options_t *oss_client_options;
/* 在內存池中分配內存給options。*/
oss_client_options = oss_request_options_create(pool);
/* 初始化Client的選項oss_client_options。*/
init_options(oss_client_options);
/* 初始化參數。*/
aos_string_t bucket;
aos_string_t object;
aos_string_t sym_object;
aos_table_t *resp_headers = NULL;
aos_status_t *resp_status = NULL;
aos_str_set(&bucket, bucket_name);
aos_str_set(&object, object_name);
aos_str_set(&sym_object, link_object_name);
resp_status = oss_put_symlink(oss_client_options, &bucket, &sym_object, &object, &resp_headers);
if (aos_status_is_ok(resp_status)) {
printf("put symlink succeeded\n");
} else {
printf("put symlink failed\n");
}
/* 釋放內存池,相當于釋放了請求過程中各資源分配的內存。*/
aos_pool_destroy(pool);
/* 釋放之前分配的全局資源。*/
aos_http_io_deinitialize();
return 0;
}
使用命令行工具ossutil
關于使用ossutil創建軟鏈接的具體操作,請參見create-symlink(創建軟鏈接)。
使用REST API
如果您的程序自定義要求較高,您可以直接發起REST API請求。直接發起REST API請求需要手動編寫代碼計算簽名。更多信息,請參見PutSymlink。
常見問題
私有文件可以設置軟鏈接么?
可以。設置軟鏈接與Object讀寫權限無關,讀寫權限為繼承Bucket、私有、公共讀、公共讀寫的Object均可以設置軟鏈接。
如何判斷objectkey是不是軟鏈接?
您可以調用HeadObject或GetObject接口查看響應信息。
如果Object類型為軟鏈接,則返回目標Object的內容。響應頭中Content-Length
、ETag
、Content-Md5
為目標Object的元數據。
刪除OSS中的軟鏈接是否會刪除源文件?
不會,刪除OSS中的軟鏈接僅會刪除鏈接本身,不會影響源文件。