stat命令用於查看指定儲存空間(Bucket)或者對象(Object)的相關資訊。例如,您可以通過該命令查看Bucket的儲存類型、Object中繼資料等 。
從ossutil 1.6.16版本開始,命令列中Binary名稱支援直接使用ossutil,您無需根據系統重新整理Binary名稱。如果您的ossutil版本低於1.6.16,則需要根據系統重新整理Binary名稱。更多資訊,請參見命令列工具ossutil命令參考。
只有Bucket擁有者及授予了
oss:GetObject
、oss:GetObjectAcl
和oss:GetBucketInfo
許可權的RAM使用者允許使用此命令查看Object中繼資料。
命令格式
ossutil stat oss://bucketname[/objectname]
[--encoding-type <value>]
[--payer <value>]
[--version-id <value>]
參數及選項說明如下:
配置項 | 說明 |
bucketname | 目標Bucket名稱。 |
objectname | 目標Object名稱。 |
--encoding-type | 對Object名稱進行編碼,取值為url。如果不指定該選項,則表示Object名稱未經過編碼。 |
--payer | 請求的支付方式。如果希望訪問指定路徑下的資源產生的流量、請求次數等費用由要求者支付,請將此選項的值設定為requester。 |
--version-id | Object的指定版本。僅適用於已開啟或暫停版本控制狀態Bucket下的Object。 |
使用樣本
查看目標儲存空間examplebucket的相關資訊。
ossutil stat oss://examplebucket
以下返回結果表明已成功擷取examplebucket的相關資訊,包括Bucket名稱、所在地區、建立時間、讀寫權限ACL等。
Name : examplebucket Location : oss-cn-hangzhou CreationDate : 2021-06-30 16:04:41 +0800 CST ExtranetEndpoint : oss-cn-hangzhou.aliyuncs.com IntranetEndpoint : oss-cn-hangzhou-internal.aliyuncs.com ACL : private Owner : 148562088256**** StorageClass : Standard RedundancyType : LRS AccessMonitor : Enabled 0.132413(s) elapsed
查看目標儲存空間examplebucket下名為exampleobject.jpg的相關資訊。
ossutil stat oss://examplebucket/exampleobject.jpg
以下返回結果表明已成功擷取exampleobject.jpg的相關資訊,包括讀寫權限ACL、Content-Type等檔案中繼資料、ETag值、最後更新時間等。
ACL : default Accept-Ranges : bytes Content-Length : 8746 Content-Md5 : cvc5wcklut76CVoEi2UW**** Content-Type : image/jpeg Etag : 72F739C1C925BADEFA095A048B65**** Last-Modified : 2021-07-27 09:53:03 +0800 CST Owner : 148562088256**** X-Oss-Hash-Crc64ecma : 56037670485008**** X-Oss-Object-Type : Normal X-Oss-Storage-Class : Standard 0.194739(s) elapsed
查看目標儲存空間examplebucket下名稱中含特殊字元的Object資訊
例如,您需要查看examplebucket下名為樣本.txt的Object資訊。由於ossutil目前只支援以URL編碼的方式輸出或輸入Object名稱,對於無法輸入或識別的特殊字元,需要對特殊字元進行URL編碼之後再輸出。
ossutil stat oss://examplebucket/%E7%A4%BA%E4%BE%8B.txt --encoding-type url
以下返回結果表明已成功擷取
樣本.txt
的相關資訊,包括讀寫權限ACL、Content-Type等檔案中繼資料、ETag值、最後更新時間等。ACL : default Accept-Ranges : bytes Content-Length : 113089 Content-Md5 : mAYgHM5cSkZNBxKDDqqW**** Content-Type : image/jpeg Etag : 9806201CCE5C4A464D0712830EAA**** Last-Modified : 2021-07-27 10:08:57 +0800 CST Owner : 148562088256**** X-Oss-Hash-Crc64ecma : 1106061527435521**** X-Oss-Object-Type : Normal X-Oss-Storage-Class : Standard 0.168335(s) elapsed
查看目標儲存空間examplebucket下指定版本Object的相關資訊
ossutil stat oss://examplebucket/test.jpg --version-id CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz****
有關擷取Object版本的具體操作,請參見ls。
以下返回結果表明已成功擷取指定版本Object的相關資訊,包括讀寫權限ACL、Content-Type等檔案中繼資料、ETag值、最後更新時間、版本ID等。
ACL : default Accept-Ranges : bytes Content-Length : 190540 Content-Md5 : aJQnxHQ2b+zW6hh0c+2y**** Content-Type : image/jpeg Etag : 689427C474366FECD6EA187473ED**** Last-Modified : 2021-07-27 10:19:25 +0800 CST Owner : 148562088256**** X-Oss-Hash-Crc64ecma : 1666171672179499**** X-Oss-Object-Type : Normal X-Oss-Storage-Class : Standard X-Oss-Version-Id : CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz**** 0.213528(s) elapsed
通用選項
當您需要通過命令列工具ossutil切換至另一個地區的Bucket時,可以通過-e選項指定該Bucket所屬的Endpoint。當您需要通過命令列工具ossutil切換至另一個阿里雲帳號下的Bucket時,可以通過-i選項指定該帳號的AccessKey ID,並通過-k選項指定該帳號的AccessKey Secret。
例如您需要擷取另一個阿里雲帳號下,華東2(上海)地區下名為testbucket的儲存空間資訊,命令如下:
ossutil stat oss://testbucket -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA**** -k 67DLVBkH7EamOjy2W5RVAHUY9H****
關於此命令的其他通用選項的更多資訊,請參見通用選項。