接口功能介绍
此接口用于获取对象的元数据信息，包括该Object的ETag、Size、LastModified信息，并且不返回该Object的内容。
接口约束
无
URI
HEAD /{bucket}/{objectName}
路径参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名称 | testBucket |
| objectName | 是 | String | 对象名称 | test |
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| get-metadata | 是 | String | 固定参数 | get-metadata |
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| Authorization | 是 | String | 用于验证请求合法性的认证信息 |
请求体body参数
无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| Last-Modified | String | 对象最新修改时间 | Mon, 02 Jan 2006 15:04:05 GMT | |
| x-amz-storage-class | String | 对象存储类型 | STANDARD | |
| x-amz-version-id | String | Object的版本ID。只有查看Object指定版本的元数据信息时才显示该字段 | dfafdsa21******** | |
| x-gw-object-atime | String | Object的最后一次访问时间。时间格式为HTTP 1.1协议中规定的GMT时间。开启访问追踪时，该字段的值会随着文件被访问的时间持续更新。注意： Object的最后一次访问时间是异步更新的，会保证在24小时内完成Object最后一次访问时间的更新。对于24小时内多次访问同一个Object，仅更新该Object的最早一次访问时间 | Mon, 02 Jan 2006 15:04:05 GMT | |
| x-amz-bucket-owner | String | 桶的拥有者 | test | |
| ETag | String | Object生成时会创建ETag (entity tag)，ETag用于标识一个Object的内容 | tx00000000000000000**** |
请求示例
HEAD /testbucket/test?get-metadata HTTP/1.1
请求头header
Authorization: authorization string
请求体body
无
响应示例
HTTP/1.1 200 OK
x-amz-request-id: tx00000000000000000****
x-amz-bucket-owner: test
Date: Thu, 15 Sep 2022 08:36:33 GMT
Last-Modified: Mon, 02 Jan 2006 15:04:05 GMT
ETag: "a6ba847a297266fc647c263b9xxxx"
Content-Length: 344606
Connection: keep-alive
x-amz-storage-class: STANDARD
状态码
| 状态码 | 错误码 | 描述 |
|---|---|---|
| 200 | 操作成功 | |
| 403 | AccessDenied | 用户没有权限执行操作 |
| 404 | NoSuchBucket | 操作指定的桶不存在 |
| 404 | NoSuchKey | key对应的对象不存在 |
错误码
请参考 请求错误码（原生接口）。
