head-object

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的版本号。

说明

使用示例

  • 获取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"