帮助与文档

我们为你提供丰富、详尽的使用指南以及产品文档

HEAD Object

只返回对象的元信息,不返回对象内容。此操作要求请求者对存储空间拥有可读权限。

如果存储空间被设置为对匿名用户可读,则请求不需要携带认证信息。然而如果携带了认证信息,但是认证用户不拥有该存储空间的可读权限,则请求该接口会返回权限错误。

如果你只需要获取对象的元信息,或者检查对象是否存在,可使用该接口。

Request Syntax

HEAD /<object-name> HTTP/1.1
Host: <bucket-name>.pek3a.qingstor.com
Date: <date>
Authorization: <authorization-string>
Range: bytes=<byte-range>

Request Parameters

没有请求参数

Request Elements

没有请求消息体

Request Headers

参见公共请求头

对象加密,参见加密请求头

若对象附有标准 HTTP 头或自定义元数据,参见如何获取对象元数据`

Header Name Type Description Required
If-Modified-Since Date 如果该对象自从指定时间往后被修改过,则正常下载对象,并返回 200 OK;否则返回 304 NOT MODIFIED No
If-Unmodified-Since Date 如果该对象自从指定时间往后没有被修改过,则正常下载对象,并返回 200 OK;否则返回 412 PRECONDITION FAILED No
If-Match String 如果对象内容的 ETag 值符合给定的值,则正常下载对象,并返回 200 OK;否则返回 412 PRECONDITION FAILED No
If-None-Match String 如果对象内容的 ETag 值不同于给定的值,则正常下载对象,并返回 200 OK;否则返回 304 NOT MODIFIED No

Response Headers

参见公共响应头

若对象被加密,服务端将返回加密响应头, 具体请参见加密响应头

Name Type Description
Content-Type String 对象类型
Content-Length String 对象大小
Last-Modified Date 对象更新时间
ETag String 服务器端为对象内容生成的唯一标志
x-qs-storage-class String 该对象的存储级别,支持的存储级别为 “STANDARD” 和 “STANDARD_IA”

Response Elements

没有响应消息体

Example

Example Request

HEAD /myphoto.jpg HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2015 09:05:00 GMT
Authorization: authorization string

Example Response

HTTP/1.1 200 OK
Server: QingStor
Date: Sun, 16 Aug 2015 09:05:00 GMT
Last-Modified: Fri, 14 Aug 2015 09:10:39 GMT
ETag: "0c2f573d81194064b129e940edcefe9b"
Content-Type: image/jpeg
Content-Length: 7987
Connection: close
x-qs-storage-class: STANDARD
x-qs-request-id: aa08cf7a43f611e5886952542e6ce14b