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****
關于此命令的其他通用選項的更多信息,請參見通用選項。