文档

stat(查看Bucket和Object信息)

更新时间:

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****

关于此命令的其他通用选项的更多信息,请参见通用选项