read-symlink命令用於讀取軟連結檔案的描述資訊,包括軟連結檔案的ETag值、最後更新時間等。此操作要求使用者對軟連結檔案有讀許可權。
注意事項
要讀取軟連結,您必須具有oss:GetObject許可權。具體操作,請參見為RAM使用者授權自訂的權限原則。
從ossutil 1.6.16版本開始,命令列中Binary名稱支援直接使用ossutil,您無需根據系統重新整理Binary名稱。如果您的ossutil版本低於1.6.16,則需要根據系統重新整理Binary名稱。更多資訊,請參見命令列工具ossutil命令參考。
關於軟連結的更多資訊,請參見軟連結。
命令格式
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****
關於此命令的其他通用選項的更多資訊,請參見通用選項。