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: ChinacCOS

results matching ""

    No results matching ""