# 查询对象属性
#### 功能说明
查询对象的基本属性。
#### 命令结构
- 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参数决定。 |
| bucket-cname | 附加参数，可选 | 指定桶绑定的自定义域名 说明： Util 5.7.9版本及以上支持该参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| config       | 附加参数，可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| e            | 附加参数，可选 | 指定终端节点。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| i            | 附加参数，可选 | 指定用户的AK。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| k            | 附加参数，可选 | 指定用户的SK。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| t            | 附加参数，可选 | 指定用户的securitytoken。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   
#### 响应结果
| **字段名**      | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|
| Key          | 对象名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| LastModified | 对象的最后修改时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Size         | 对象的大小。 单位：字节。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| StorageClass | 对象的存储类别。 支持的值： - standard：标准存储，访问时延低、吞吐量高，适用于有大量热点文件（平均一个月多次）或小文件（小于1MB）。  - warm：低频访问存储，可用性略低于standard，适用于不频繁访问（平均一年少于12次）但在需要时也要求快速访问数据的业务场景。  - cold：归档存储，安全、持久且成本极低，适用于很少访问（平均一年访问一次）数据的业务场景。**存储类别为cold的对象，必须先恢复该对象再修改其存储类别，否则无法修改成功。**  - deep-archive：深度归档存储，适用于长期不访问（平均几年访问一次）数据的业务场景，其成本相比归档存储更低，但相应的数据恢复时间将更长，一般为数小时。   |
| MD5          | 对象真实的MD5值。用来确保数据的完整性和验证数据的完整性。 仅当使用cp命令并且配置了-vmd5选项上传对象后，才能查询到该值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ETag         | 服务端计算的对象ETag值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ContentType  | 对象的文件类型。文件类型决定了浏览器将以什么形式、什么编码读取文件。 常见的ContentType类型，请参见[Content-Type介绍](https://support.huaweicloud.com/usermanual-obs/obs_03_0324.html#section1)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Type         | 文件的类型。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Metadata     | 对象的自定义元数据。对象有自定义元数据后，才能查询到该值。 关于对象的自定义元数据，请参见[自定义元数据](https://support.huaweicloud.com/usermanual-obs/obs_03_0324.html#section1)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |