查询对象元数据
最近更新时间: 2024-10-17 17:10:00
功能描述
HEAD Object 接口请求可以获取对应 Object 的 meta 信息数据,HEAD 的权限与 GET 的权限一致。
请求
请求示例:
HEAD /<ObjectKey> HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: GMT Date
Authorization: Auth String
说明:
Authorization: Auth String(详情请参阅请求签名文档)。
请求头
公共头部
该请求操作的实现使用公共请求头,了解公共请求头详情请参阅 公共请求头部 文档。
非公共头部
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
If-Modified-Since | string | 否 | 当 Object 在指定时间后被修改,则返回对应 Object 的 meta 信息,否则返回304 |
请求体
该请求请求体为空。
响应
响应头
公共响应头
该响应使用公共响应头,了解公共响应头详情请参阅 公共响应头部 文档。
特有响应头
该请求操作的响应头具体数据为:
名称 | 类型 | 描述 |
---|---|---|
x-cos-meta- * | string | 用户自定义的 meta |
响应体
该请求响应体为空。
实际案例
请求
HEAD /exampleobject HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: Thu, 12 Jan 2017 17:26:53 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUjfGFO&q-sign-time=1484213210;32557109210&q-key-time=1484213210;32557109210&q-header-list=host&q-url-param-list=&q-signature=ac61b8eb61964e7e6b935e89de163a479a25c210
响应
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 16087
Connection: keep-alive
Date: Thu, 12 Jan 2017 17:26:53 GMT
ETag: \"9a4802d5c99dafe1c04da0a8e7e166bf\"
Last-Modified: Wed, 11 Jan 2017 07:30:07 GMT
Server: tencent-cos
x-cos-request-id: NTg3NzRiZGRfYmRjMzVfM2Y2OF81N2YzNA==