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****关于此命令的其他通用选项的更多信息，请参见通用选项。