read-symlink命令用于讀取軟鏈接文件的描述信息，包括軟鏈接文件的ETag值、最后更新時間等。此操作要求用戶對軟鏈接文件有讀權限。
注意事項
要讀取軟鏈接，您必須具有oss:GetObject權限。具體操作，請參見為RAM用戶授權自定義的權限策略。
從ossutil 1.6.16版本開始，命令行中Binary名稱支持直接使用ossutil，您無需根據系統刷新Binary名稱。如果您的ossutil版本低于1.6.16，則需要根據系統刷新Binary名稱。更多信息，請參見命令行工具ossutil命令參考。
當您在OSS ON云盒中使用該命令時：
將配置文件中的Endpoint替換為云盒Endpoint。更多信息，請參見云盒Endpoint。
在本文已有示例的基礎上添加--sign-version、--region以及--cloudbox-id選項。關于這三個選項的具體用法，請參見通用選項。
關于軟鏈接的更多信息，請參見軟鏈接。
命令格式
ossutil read-symlink oss://bucketname/objectname [--encoding-type <value>] [--payer <value>]參數及選項說明如下：
配置項 | 說明 |
bucketname | Bucket名稱。 |
objectname | 軟鏈接文件名稱。 |
--encoding-type | 對軟鏈接文件名稱進行編碼，取值為url。如果不指定該選項，則表示文件名稱未經過編碼。 |
--payer | 請求的支付方式。如果希望訪問指定路徑下的資源產生的流量、請求次數等費用由請求者支付，請將此選項的值設置為requester。 |
使用示例
以下示例用于讀取目標存儲空間examplebucket下軟鏈接文件test.jpg的描述信息。
ossutil read-symlink oss://examplebucket/test.jpg以下輸出結果表明已成功獲取軟鏈接文件test.jpg的ETag值、最后更新時間（Last-Modified）以及指向的目標文件（X-Oss-Symlink-Target）為example.jpg。
Etag : 938F26218CE422CBEEE0B6543A2B2D
Last-Modified : 2021-04-21 18:00:13 +0800 CST
X-Oss-Symlink-Target : example.jpg
0.217317(s) elapsed如果此命令操作的文件類型不是軟鏈接文件，將返回錯誤NotSymlink。
通用選項
當您需要通過命令行工具ossutil切換至另一個地域的Bucket時，可以通過-e選項指定該Bucket所屬的Endpoint。當您需要通過命令行工具ossutil切換至另一個阿里云賬號下的Bucket時，可以通過-i選項指定該賬號的AccessKey ID，并通過-k選項指定該賬號的AccessKey Secret。
例如您需要獲取另一個阿里云賬號下，華東2（上海）地域下目標存儲空間testbucket中名為testobject.png軟鏈接文件的信息，命令如下：
ossutil read-symlink oss://testbucket/testobject.png -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA**** -k 67DLVBkH7EamOjy2W5RVAHUY9H****關于此命令的其他通用選項的更多信息，請參見通用選項。