軟連結（Symlink）功能用於快速存取雲盒Bucket內的熱門檔案（Object）。通過PutSymlink介面設定軟連結後，您可以通過軟連結快速開啟目標檔案。
注意事項
使用PutSymlink介面建立軟連結時不會檢查目標檔案是否存在、目標檔案類型是否合法以及目標檔案是否有存取權限。
Symlink自身的存取權限（ACL）以及目標檔案的ACL檢查僅會在GetObject等需要訪問目標檔案的API中進行。
使用PutSymlink介面時，攜帶以x-oss-meta-為首碼的參數，則被視為user meta，例如x-oss-meta-location。一個Object可以有多個類似的參數，但所有的user meta總大小不能超過8 KB。
預設情況下，如果試圖添加的檔案已經存在，並且有存取權限，則新添加的檔案將覆蓋原來的檔案，成功添加後將返回200 OK。
操作步驟
使用阿里雲SDK
僅支援通過Java SDK建立軟連結，Java SDK要求3.15.0及以上版本。
import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.*;
import com.aliyun.oss.common.auth.DefaultCredentialProvider;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.ClientBuilderConfiguration;
import com.aliyun.oss.common.auth.CredentialsProviderFactory;
import com.aliyun.oss.common.auth.EnvironmentVariableCredentialsProvider;
public class Demo {
public static void main(String[] args) throws Exception {
// 填寫雲盒Bucket的資料網域名稱。
String endpoint = "https://cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com";
// 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
// 填寫雲盒Bucket名稱，例如examplebucket。
String bucketName = "examplebucket";
// 填寫雲盒Bucket所在地區。
String region = "cn-hangzhou";
// 填寫雲盒ID。
String cloudBoxId = "cb-f8z7yvzgwfkl9q0h****";
// 指定軟連結名稱。
String symLink = "yourSymLink";
// 指定軟連結指向的目標Object名稱。
String destinationObjectName = "yourDestinationObjectName";
// 建立OSSClient執行個體。
// 當OSSClient執行個體不再使用時，調用shutdown方法以釋放資源。
ClientBuilderConfiguration conf = new ClientBuilderConfiguration();
conf.setSignatureVersion(SignVersion.V4);
OSS ossClient = OSSClientBuilder.create()
.endpoint(endpoint)
.credentialsProvider(new DefaultCredentialProvider(credentialsProvider.getCredentials()))
.clientConfiguration(conf)
.region(region)
.cloudBoxId(cloudBoxId)
.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();
}
}
}
} 使用命令列工具ossutil
關於使用ossutil設定軟連結的具體步驟，請參見put-symlink。
使用REST API
如果您的程式自訂要求較高，您可以直接發起REST API請求。直接發起REST API請求需要手動編寫代碼計算簽名。更多資訊，請參見PutSymlink。