文档首页/ 对象存储服务 OBS/ 工具指南/ obsutil/ 对象相关命令/ 查询对象属性
更新时间：2025-07-11 GMT+08:00
查看PDF
分享

查询对象属性

功能说明

查询对象的基本属性。

命令结构

  • Windows操作系统 
    obsutil stat obs://bucket/key [-acl][-bf=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  • macOS/Linux操作系统 
    ./obsutil stat obs://bucket/key [-acl][-bf=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例

  • 以Windows操作系统为例，运行obsutil stat obs://bucket-test/key，查询对象基本属性。 
    obsutil stat obs://bucket-test/key

Start at 2024-09-25 04:48:10.1147483 +0000 UTC

Key:
  obs://bucket-test/key
LastModified:
  2018-11-16T02:15:49Z
Size:
  7
StorageClass:
  standard
ETag:
  43d93b553855b0e1fc67e31c28c07b65
ContentType:
  text/plain
Type:
  file
Metadata:
  key=value

参数说明

参数

约束

描述

bucket

必选

对象所属的桶的名称。

key

必选

待查询属性的对象名称。

acl

可选

同时查询对象的访问策略。

bf

附加参数，可选

对象大小字节数的显示格式。支持的值：

  • human-readable：以易于人理解的方式显示对象存储大小。例如，显示为1GB（千字节，MB，GB，TB等），而不是显示一个很大的数字（如：1073741824）。
  • raw：直接显示字节数，不经过任何形式的转换或格式化。例如，如果一个对象占用的空间是1GB，它会直接显示为1073741824字节。

对于普通用户来说，human-readable 更易于理解；而对于需要进行精确计算或自动化处理的场景，raw 格式则更为合适。

如果未设置该参数，则对象大小字节数的显示格式由配置文件中的humanReadableFormat参数决定。

config

附加参数，可选

运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。

e

附加参数，可选

指定终端节点。

i

附加参数，可选

指定用户的AK。

k

附加参数，可选

指定用户的SK。

t

附加参数，可选

指定用户的securitytoken。

响应结果

字段名

描述

Key

对象名称。

LastModified

对象的最后修改时间。

Size

对象的大小。

单位：字节。

StorageClass

对象的存储类别。

支持的值：

  • standard：标准存储，访问时延低、吞吐量高，适用于有大量热点文件（平均一个月多次）或小文件（小于1MB）。
  • warm：低频访问存储，，可用性略低于standard，适用于不频繁访问（平均一年少于12次）但在需要时也要求快速访问数据的业务场景。
  • cold：归档存储，，安全、持久且成本极低，适用于很少访问（平均一年访问一次）数据的业务场景。存储类别为cold的对象，必须先恢复该对象再修改其存储类别，否则无法修改成功。

MD5

对象真实的MD5值。用来确保数据的完整性和验证数据的完整性。

仅当使用cp命令并且配置了-vmd5选项上传对象后，才能查询到该值。

ETag

服务端计算的对象ETag值。

ContentType

对象的文件类型。文件类型决定了浏览器将以什么形式、什么编码读取文件。

常见的ContentType类型，请参见Content-Type介绍。

Type

文件的类型。

Metadata

对象的自定义元数据。对象有自定义元数据后，才能查询到该值。

关于对象的自定义元数据，请参见自定义元数据。
父主题： 对象相关命令

相关文档