head-object用于获取某个文件（Object）的元信息。
注意事项
使用此命令不会返回文件内容。
权限说明
阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。
API | Action | 说明 |
HeadObject |
| 获取某个Object的元数据。 |
命令格式
ossutil api head-object --bucket value --key value [flags]参数 | 类型 | 说明 |
--bucket | string | Bucket名称。 |
--key | string | Object的完整路径。 |
--if-match | string | 如果传入期望的ETag和Object的 ETag匹配，则返回200 OK和Object Meta；否则返回412 precondition failed。 |
--if-modified-since | string | 如果传入参数中的时间早于实际修改时间，则返回200 OK和Object Meta；否则返回304 not modified。 |
--if-none-match | string | 如果传入期望的ETag值和Object的ETag不匹配，则返回200 OK和Object Meta；否则返回304 Not Modified。 |
--if-unmodified-since | string | 如果传入参数中的时间等于或者晚于文件实际修改时间，则返回200 OK和Object Meta；否则返回412 Precondition Failed。 |
--version-id | string | Obejct的版本号。 |
head-object命令对应API接口HeadObject。关于API中的具体参数含义，请参见HeadObject。
关于支持的全局命令行选项，请参见支持的全局命令行选项。
使用示例
获取
exampleobject对象的元信息。ossutil api head-object --bucket examplebucket --key exampleobject获取
exampleobject对象的元信息，以JSON格式显示。ossutil api head-object --bucket examplebucket --key exampleobject --output-format json获取版本号为123的
exampleobject的元信息。ossutil api head-object --bucket examplebucket --key exampleobject --version-id 123获取
exampleobject对象且ETag等于123的元信息。ossutil api head-object --bucket examplebucket --key exampleobject --if-match 123获取
exampleobject对象且对象实际修改时间早于"Thu, 11 Jul 2024 06:36:31 GMT"的元信息。ossutil api head-object --bucket examplebucket --key exampleobject --if-modified-since "Thu, 11 Jul 2024 06:36:31 GMT"