head-object用于获取某个文件(Object)的元信息。
注意事项
阿里云账号默认拥有获取Object元信息的权限。如果您需要通过RAM用户或者STS的方式进行获取,您必须拥有
oss:GetObject
权限。具体操作,请参见为RAM用户授权自定义的权限策略。使用此命令不会返回文件内容。
命令格式
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"