获取元数据 (HEAD Object)
客户端使用该接口获取对象 (Object) 的元数据，如 文件大小 (Content-Length)，文件 MIME 类型 (Content-Type)，文件 HASH 值 (ETag) 等。
请求定义
HEAD /<BucketName>/<ObjectName> HTTP/1.1
Host: api-s3.qiniu.com
Date: <date>
Authorization: <YourAuthenticatingString>
请求参数
该接口未定义请求参数
请求头
除 请求头 (HTTP Request Header) 外，该接口定义了以下请求头:
| 名称 | 描述 | 要求 |
|---|---|---|
| If-Modified-Since | 仅当对象的最后修改时间大于指定的时间时返回，否则服务器端返回 HTTP 状态码 304 | N |
| If-Unmodified-Since | 仅当对象的最后修改时间小于指定的时间时返回，否则服务器端返回 HTTP 状态码 412 | N |
| If-Match | 仅当对象的 ETag 等于指定的值时返回，否则服务器端返回 HTTP 状态码 412 | N |
| If-None-Match | 仅当对象的 ETag 不定义指定的值时返回，否则服务器端返回 HTTP 状态码 304 | N |
请求数据
该接口未定义请求数据
响应定义
该接口未定义响应数据
- 服务器端正确处理请求时响应 HTTP 状态码为 200
该接口定义了以下 HTTP 响应头数据
| 名称 | 描述 |
|---|---|
| Content-Type | 对象的 MIME 类型，如 image/png |
| Content-Length | 对象大小，单位为 byte |
| Last-Modified | 对象最后修改日期 |
| ETag | 对象内容的 HASH 值 |