如何查看Bucket的存储类型及Object元等信息 - 对象存储 OSS

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

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