全部產品
Search
文件中心

Object Storage Service:stat(查看Bucket和Object資訊)

更新時間:Jul 31, 2024

stat命令用於查看指定儲存空間(Bucket)或者對象(Object)的相關資訊。例如,您可以通過該命令查看Bucket的儲存類型、Object中繼資料等 。

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

  • 只有Bucket擁有者及授予了oss:GetObjectoss:GetObjectAcloss: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****

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