HeadObject

HeadObject只返回某个Object的元数据信息，不返回文件内容。

请求语法

HEAD /objectName HTTP/1.1
Host: bucketname.cos.chinac.com
Date: GMT Date
Authorization: SignatureValue

请求Header

Name	Type	Description
If-Modified-Since	String	如果指定的时间早于实际修改时间，则返回200 OK和Object Meta；否则返回304 not modified

细节分析

1. 不论正常返回200 OK还是非正常返回，Head Object都不返回消息体
2. HeadObject支持在头中设定If-Modified-Since。如果没有修改，返回304 Not Modified
3. 如果用户在PutObject的时候传入以x-cos-meta-为开头的user metadata，比如x-cos-meta-location，返回消息时，返回这些user metadata
4. 如果文件不存在返回404 Not Found错误

示例

请求示例

HEAD /cos.jpg HTTP/1.1
Host: test-bucket.cos.chinac.com
Date: Fri, 24 Feb 2012 07:32:52 GMT
Authorization: COS qn6qrrqxo2oawuk53otfjbyc:JbzF2LxZUtanlJ5dLA092wpDC/E=

返回示例

HTTP/1.1 200 OK
x-cos-request-id: 559CC9BDC755F95A64485981
Date: Fri, 24 Feb 2012 07:32:52 GMT
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a39863328"
Content-Type: image/jpg
Content-Length: 344606
Connection: keep-alive
Server: COS