调用 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 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-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
相关文档
关于文件元数据的更多信息，请参见 管理文件元数据 。
错误码
|
错误码 |
HTTP状态码 |
描述 |
|
Not Found |
404 |
目标Object不存在。 |