如何通過create-symlink命令建立軟連結 - Object Storage Service

軟連結功能用於快速存取儲存空間（Bucket）內的熱門檔案（Object）。通過create-symlink建立軟連結後，您可以通過軟連結檔案快速開啟源檔案，類似於Windows的捷徑。

注意事項

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

從ossutil 1.6.16版本開始，命令列中Binary名稱支援直接使用ossutil，您無需根據系統重新整理Binary名稱。如果您的ossutil版本低於1.6.16，則需要根據系統重新整理Binary名稱。更多資訊，請參見命令列工具ossutil命令參考。

命令格式

ossutil create-symlink cloud_url target_object
[--encoding-type <value>] 
[--payer <value>]

參數及選項說明如下：

配置項	說明
cloud_url	軟連結檔案所在Bucket的完整路徑。
target_object	軟連結檔案指向的目標Object所在Bucket的完整路徑。軟連結檔案與目標Object必須屬於同一個Bucket。
--encoding-type	對`cloud_url`以及`target_object`中包含的檔案名稱進行編碼，取值為url。如果不指定該選項，則表示檔案名稱未經過編碼。
--payer	請求的支付方式。如果希望訪問指定路徑下的資源產生的流量、請求次數等費用由要求者支付，請將此選項的值設定為requester。

使用樣本

使用此命令建立軟連結時不會檢查目標檔案是否存在。如果目標檔案存在，通過建立的軟連結檔案可直接存取目標檔案。如果目標檔案不存在，通過建立的軟連結檔案無法找到目標檔案。當您無法判斷目標檔案是否存在時，請通過ls（列舉）命令擷取目標Bucket內包含的所有檔案。

為已存在的目標檔案建立軟連結檔案樣本如下：

重要

如果新添加的軟連結檔案名稱與已有的軟連結檔案重名，則新添加的軟連結檔案將覆蓋已有的軟連結檔案。

為目標儲存空間examplebucket根目錄下的exampleobject.jpg檔案建立名為test.jpg的軟連結檔案，並將軟連結檔案儲存至該Bucket的根目錄。
```
ossutil create-symlink  oss://examplebucket/test.jpg  oss://examplebucket/exampleobject.jpg
```
在開啟要求者付費模式下，為目標儲存空間examplebucket根目錄下的test.jpg檔案建立名為example.jpg的軟連結檔案，並將軟連結檔案儲存至該Bucket下的destfolder目錄。
```
ossutil create-symlink  oss://examplebucket/destfolder/example.jpg  oss://examplebucket/test.jpg --payer requester
```
以下輸出結果表明已為目標檔案成功建立軟連結檔案。
```
0.106744(s) elapsed
```
軟連結檔案建立成功後，您可以通過read-symlink（讀取軟連結）或stat（查看Bucket和Object資訊）命令擷取軟連結檔案相關資訊，例如ETag值、檔案最後更新時間等。

通用選項

當您需要通過命令列工具ossutil切換至另一個地區的Bucket時，可以通過-e選項指定該Bucket所屬的Endpoint。當您需要通過命令列工具ossutil切換至另一個阿里雲帳號下的Bucket時，可以通過-i選項指定該帳號的AccessKey ID，並通過-k選項指定該帳號的AccessKey Secret。

例如，您需要為另一個阿里雲帳號下，華東2（上海）地區下目標儲存空間testbucket下的exampleobject.png檔案建立名為testobject.png的軟連結，命令如下：

ossutil create-symlink  oss://testbucket/testobject.png  oss://testbucket/exampleobject.png -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA****  -k 67DLVBkH7EamOjy2W5RVAHUY9H****

關於此命令的其他通用選項的更多資訊，請參見通用選項。