get-object-meta

get-object-meta用于获取文件(Object)的元数据信息,包括该Object的ETag、Size、LastModified信息,并且不返回该Object的内容。

注意事项

  • 阿里云账号默认拥有获取Object元信息的权限。如果您需要通过RAM用户或者STS的方式进行获取,您必须拥有oss:GetObject权限。具体操作,请参见为RAM用户授权自定义的权限策略

  • 文件(Object)的元数据信息包括该Object的ETag、Size、LastModified信息,且不返回该Object的内容。如果Object类型为软链接,则会返回软链接自身信息。

命令格式

ossutil api get-object-meta --bucket value --key value [flags]

参数

类型

说明

--bucket

string

Bucket名称。

--key

string

Object的完整路径。

--version-id

string

获取Object的元数据信息的版本号。

说明

使用示例

  • 获取exampleobject对象的部分元信息。

    ossutil api get-object-meta --bucket examplebucket --key exampleobject
  • 获取exampleobject对象的部分元信息,以JSON格式显示。

    ossutil api get-object-meta --bucket examplebucket --key exampleobject --output-format json
  • 获取版本号为123的exampleobject的部分元信息。

    ossutil api get-object-meta --bucket examplebucket --key exampleobject --version-id 123