HEAD Object

最近更新时间:2019-01-14 10:10:58

HEAD Object


描述

此HEAD操作将会在不返回 object 的情况下获取对象的元数据信息。如果你只需要对象的元数据信息,那么这个方法非常合适。 使用此接口,你需要具有对对象的 READ 权限。

一个对象的HEAD请求与GET请求具有相同的操作,唯一的区别是响应回复中HEAD请求不具有响应体。

权限

该接口操作需要用户对Object拥有READ权限。如果请求的 object 不存在,KS3将根据你是否拥有对权限返回相应信息。

  • 如果你拥有该Bucket的READ权限,KS3将会返回的 HTTP 状态码为404(no such key)错误。
  • 如果你并不拥有该Bucket的READ权限,KS3将会返回的 HTTP 状态码为403(access denied)错误。

请求

语法

HEAD /{ObjectKey} HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

注意:

请求参数

该接口不使用请求头部。

请求头部

该接口可以使用所有常用请求头部,此外,也可以使用下表所列请求头部。获取更多信息,请点击常用请求头部

名称 描述 必须
Range 下载指定 range 字节的 object。更多关于HTTP Range 头部信息,请访问http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html## sec14.35
类型:String
默认值:None
约束条件:无
If-Modified-Since 如果 object 在指定时间后被改变,则返回 object。否则,返回304状态码
类型:String
默认值:None
约束条件:无
If-Unmodified-Since 如果 object 在指定时间后没有被改变,则返回 object。否则,返回412状态码
类型:String
默认值:None
约束条件:无
If-Match 如果 objectETag(entity tag)与指定值一致,则返回 object。否则,返回412状态码
类型:String
默认值:None
约束条件:无
If-None-Match 如果 objectETag(entity tag)与指定值不一致,则返回 object。否则,返回304状态码
类型:String
默认值:None
约束条件:无

请求内容

该接口不使用请求内容。

响应

响应头部

名称 描述
Content-MD5 返回文件md5值的base64编码,前提条件为文件是通过PUT或POST上传到KS3;如果是分块上传的文件,将不会返回此响应头
x-kss-meta-* 如果你在PUT Object中使用了用户元数据,格式为前缀 x-kss-meta- 后缀为你自定的字段,那么响应头部会返回它,并不解析。
类型:String
x-kss-restore 对解冻中的或已解冻的归档文件进行head请求时,会增加x-kss-restore请求头,请求头的内容指明解冻的状态以及解冻过期时间,解冻中的文件会返回x-kss-restore: ongoing-request="true",已解冻的文件会返回,例如:x-kss-restore: ongoing-request="false", expiry-date="Sun, 16 Apr 2017 08:12:33 GMT";对标准存储文件、低频存储文件和未解冻的归档文件,进行Head请求时,不会增加x-kss-restore请求头
类型:String

响应内容

该接口不返回响应内容。

特殊错误

该接口不返回任何特殊错误。

示例

请求示例

HEAD /my-image.jpg HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyun.com
Date: Wed, 28 Oct 2009 22:32:00 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Date: Wed, 28 Oct 2009 22:32:00 GMT
Last-Modified: Sun, 1 Jan 2006 12:00:00 GMT
ETag: "54a3be97af36cdc9f2516c74550fa95d"
Content-Length: 434234
Content-Type: text/plain
Connection: close
Server: Tengine
Content-MD5:VKO+l682zcnyUWx0VQ+pXQ==

注意:

1、如果文件通过分块上传保存在KS3,对文件调用GET接口时将不会返回Content_MD5响应头;

2、如果文件通过PUT或POST接口上传到KS3,对文件调用GET接口将会返回Content_MD5响应头。

接口细节分析

  • HEAD Object不论请求成功与否,都不会返回body
  • 使用该接口可以用来判断object是否存在
  • 使用该接口可以用来获取object的元数据

金山云,开启您的云计算之旅

立即注册