接口功能
此接口用于获取对象的元数据信息,包括该Object的ETag、Size、LastModified信息,并且不返回该Object的内容。
接口约束
无
请求URI
HEAD /v1/{bucket}/{objectName}
路径参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
bucket | 是 | String | 桶名称。 | testBucket |
objectName | 是 | String | 对象名称。 | test |
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
get-metadata | 是 | String | 固定参数。 | get-metadata |
请求参数
请求头header参数
无
请求体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 /v1/testbucket/test?get-metadata HTTP/1.1
请求头header
无
请求体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对应的对象不存在。 |