stat 命令用于查询对象元数据。
注意：如需使用此命令，在你进行 授权策略 时，action 需要设置为cos:HeadObject，更多授权请参见 支持 CAM 的业务接口。
一、命令格式
stat 命令包含以下参数：
| 参数格式 | 参数用途 | 示例 |
| cos://<bucket-name> | 指定需要访问的存储桶。支持使用 配置参数 中的桶别名，或桶名称进行访问。如使用桶名称访问，需要额外携带 endpoint flag | 使用桶别名访问：cos://example-alias使用桶名称访问：cos://examplebucket-1250000000 |
stat 命令包含以下可选 flag：
| flag 简写 | flag 全称 | flag 用途 |
| 无 | –version-id | 指定对象版本 |
注意：说明：
注意：关于此命令的其他通用选项（例如切换存储桶、切换用户账号等），请参见 通用选项 文档。
二、设置存储桶清单
查询存储桶 testbucket 下 file1文件的元数据：
./coscli stat cos://testbucket/file1
输出以下结果：
INFO[2026-08-25 11:48:32] Object: cos://testbucket/file1 INFO[2026-08-25 11:48:32] ETag: "asdhashahashdhahqwhqwhehq" INFO[2026-08-25 11:48:32] Content-Type: application/octet-stream INFO[2026-08-25 11:48:32] Content-Length: 1024 INFO[2026-08-25 11:48:32] Last-Modified: Sun, 27 Apr 2025 03:24:01 GMT INFO[2026-08-25 11:48:32] Cache-Control: INFO[2026-08-25 11:48:32] Content-Disposition: INFO[2026-08-25 11:48:32] Content-Encoding: INFO[2026-08-25 11:48:32] Content-Language: INFO[2026-08-25 11:48:32] Expires: INFO[2026-08-25 11:48:32] x-cos-storage-class: INFO[2026-08-25 11:48:32] x-cos-version-id: null INFO[2026-08-25 11:48:32] x-cos-object-type: INFO[2026-08-25 11:48:32] x-cos-hash-crc64ecma: 90818123123131313