全部产品
Search

搜索本产品

    对象存储 OSS：GetObjectMeta

    文档中心

    对象存储 OSS：GetObjectMeta

    更新时间：Oct 22, 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-transition-time

    字符串

    Tue, 23 Apr 2024 07:21:42 GMT

    Object通过生命周期规则转储为冷归档或者深度冷归档存储类型的时间。

    说明

    • 如果获取的转储时间距离当前时间超过180天，则提前删除冷归档或者深度冷归档Object不会产生存储不足规定时长费用。如果转储时间距离当前时间不超过180天，则提前删除冷归档或者深度冷归档Object会产生存储不足规定时长费用。

    • 不支持通过该字段统计Object通过生命周期规则转储为低频或者归档存储类型的时间。判断低频或者归档存储类型是否满足最低存储时长的要求取决于Last-Modified时间。

    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时间。

    说明

    • 低频访问类型最低存储时间（30天）以Object存储在OSS的Last Modified时间开始计算。如果获取到Object的Last-Modified时间距离当前时间超过30天，则提前删除Object不会产生低频存储不足规定时长费用。

    • 归档类型最低存储时间（60天）以Object存储在OSS的Last Modified时间开始计算。如果获取到Object的Last-Modified时间距离当前时间超过60天，则提前删除Object不会产生归档存储不足规定时长费用。

    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 qn6q**************:77Dv****************

      返回示例

      重要

      如果您在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-transition-time: Tue, 23 Apr 2024 07:21:42 GMT
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 qn6q**************:77Dv****************

      返回示例

      • 当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不存在。