全部产品
Search
文档中心

对象存储 OSS:GetObjectMeta

更新时间:Jan 15, 2024

调用GetObjectMeta接口获取一个文件(Object)的元数据信息,包括该Object的ETag、Size、LastModified信息,并且不返回该Object的内容。

注意事项

说明

如果Object类型为软链接,则返回软链接信息。

当Bucket未启用版本控制时,要获取文件的元数据信息,您必须有oss:GetObject权限。当Bucket已启用版本控制时,要获取文件指定版本(请求中携带了x-oss-version-id请求头)的元数据信息,您必须有oss:GetObjectVersion权限。具体操作,请参见为RAM用户授权自定义的权限策略

版本控制

GetObjectMeta操作默认获取Object当前版本的元数据信息。如果Object的当前版本为删除标记,则返回404 Not Found。请求参数中指定versionId则返回指定版本Object的元数据信息。

请求语法

HEAD /ObjectName?objectMeta HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)

响应头

响应头

类型

示例值

描述

Content-Length

字符串

344606

Object的文件大小,单位为字节。

ETag

字符串

5B3C1A2E053D763E1B002CC607C5****

Object生成时会创建ETag(entity tag),ETag用于标识一个Object的内容。

对于通过PutObject请求创建的Object,ETag值是其内容的MD5值;对于其他方式创建的Object,ETag值是基于一定计算规则生成的唯一值,但不是其内容的MD5值。ETag值可以用于检查Object内容是否发生变化。不建议用户使用ETag作为Object内容的MD5校验来验证数据完整性。

默认值:无

x-oss-last-access-time

字符串

Tue, 30 Mar 2021 06:07:48 GMT

Object的最后一次访问时间。时间格式为HTTP 1.1协议中规定的GMT时间。开启访问跟踪时,该字段的值会随着文件被访问的时间持续更新。如果开启后关闭了访问跟踪,该字段的值保留为上一次最后更新的值。

重要

Object的最后一次访问时间是异步更新的,OSS会保证在24小时内完成Object最后一次访问时间的更新。对于24小时内多次访问同一个Object,OSS仅更新该Object的最早一次访问时间。

Last-Modified

字符串

Fri, 24 Feb 2012 06:07:48 GMT

Object最后一次修改时间。时间格式为HTTP 1.1协议中规定的GMT时间。

x-oss-version-id

字符串

CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****

Object的版本ID。只有查看Object指定版本的元数据信息时才显示该字段。

此接口还需要包含公共响应头。更多信息,请参见公共响应头(Common Response Headers)

示例

  • 未开启版本控制

    请求示例

    HEAD /oss.jpg?objectMeta HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Date: Wed, 29 Apr 2015 05:21:12 GMT
    Authorization: OSS qn6qrrqxo2oawuk53otf****:CTkuxpLAi4XZ+WwIfNm0Fmgb****

    返回示例

    重要

    如果您在Bucket开启分层命名空间后通过CreateDirectory创建了目录,则调用GetObjectMeta接口获取目录信息时,ETag将返回“null”。

    • 当Bucket未开启访问跟踪

      HTTP/1.1 200 OK
      x-oss-request-id: 559CC9BDC755F95A6448****
      Date: Wed, 29 Apr 2015 05:21:12 GMT
      ETag: "5B3C1A2E053D763E1B002CC607C5****"
      Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
      Content-Length: 344606
      Connection: keep-alive
      Server: AliyunOSS
    • Bucket已开启访问跟踪

      HTTP/1.1 200 OK
      x-oss-request-id: 559CC9BDC755F95A6448****
      Date: Wed, 29 Apr 2015 05:21:12 GMT
      ETag: "5B3C1A2E053D763E1B002CC607C5****"
      x-oss-last-access-time: Thu, 14 Oct 2021 11:49:05 GMT
      Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
      Content-Length: 344606
      Connection: keep-alive
      Server: AliyunOSS
  • 已开启版本控制

    请求示例

    GET /example?objectMeta&versionId=CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk**** HTTP/1.1
    Host: versioning-test.oss-cn-hangzhou.aliyuncs.com
    Date: Tue, 09 Apr 2019 06:24:00 GMT
    Authorization: OSS 5n4nrhyqrcs****:i/M/c36KzrOEA/bBSHLllIAt****

    返回示例

    • 当Bucket未开启访问跟踪

      HTTP/1.1 200 OK
      x-oss-version-id: CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****
      x-oss-request-id: 5CAC3A80B7AEADE0170005F6
      Date: Tue, 09 Apr 2019 06:24:00 GMT
      ETag: "1CF5A685959CA2ED8DE6E5F8ACC2****"
      Last-Modified: Tue, 09 Apr 2019 06:24:00 GMT
      Content-Length: 119914
      Connection: keep-alive
      Server: AliyunOSS
    • 当Bucket已开启访问跟踪

      HTTP/1.1 200 OK
      x-oss-version-id: CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****
      x-oss-request-id: 5CAC3A80B7AEADE0170005F6
      Date: Tue, 09 Apr 2019 06:24:00 GMT
      ETag: "1CF5A685959CA2ED8DE6E5F8ACC2****"
      x-oss-last-access-time: Thu, 14 Oct 2021 11:49:05 GMT
      Last-Modified: Tue, 09 Apr 2019 06:24:00 GMT
      Content-Length: 119914
      Connection: keep-alive
      Server: AliyunOSS

SDK

此接口对应的各语言SDK如下:

相关文档

关于文件元数据的更多信息,请参见管理文件元数据

错误码

错误码

HTTP状态码

描述

Not Found

404

目标Object不存在。