HEAD Object

最近更新时间:2019-08-13 11:44:29

功能描述

HEAD Object 接口请求可以判断指定对象是否存在和有权限,并在指定对象可访问时获取其元数据。该 API 的请求者需要对目标对象有读取权限,或者目标对象向所有人开放了读取权限(公有读)。

版本控制

当启用版本控制时,该 HEAD 操作返回最新版本的元数据。要返回历史版本的元数据,请使用 versionId 请求参数。

请求

请求示例

HEAD /<ObjectKey> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
说明:

Authorization: Auth String (详情请参见 请求签名 文档)。

请求参数

名称 描述 类型 是否必选
versionId 指定要查询的对象的版本 ID string

请求头

此接口除使用公共请求头部外,还支持以下请求头部,了解公共请求头部详情请参见 公共请求头部 文档。

名称 描述 类型 是否必选
If-Modified-Since 当对象在指定时间后被修改,则返回 HTTP 状态码为200(OK),否则返回 HTTP 状态码为304(Not Modified) string
If-Unmodified-Since 当对象在指定时间后未被修改,则返回 HTTP 状态码为200(OK),否则返回 HTTP 状态码为412(Precondition Failed) string
If-Match 当对象的 ETag 与指定的值一致,则返回 HTTP 状态码为200(OK),否则返回 HTTP 状态码为412(Precondition Failed) string
If-None-Match 当对象的 ETag 与指定的值不一致,则返回 HTTP 状态码为200(OK),否则返回 HTTP 状态码为304(Not Modified) string

服务端加密相关头部

如果指定的对象使用了服务端加密且加密方式为 SSE-C 时,则需要指定服务端加密的相关头部来解密对象,请参见 服务端加密专用头部

请求体

此接口无请求体。

响应

响应头

此接口除返回公共响应头部外,还返回以下响应头部,了解公共响应头部详情请参见 公共响应头部 文档。

名称 描述 类型
Cache-Control RFC 2616 中定义的缓存指令,仅当对象元数据包含此项时才会返回该头部 string
Content-Disposition RFC 2616 中定义的文件名称,仅当对象元数据包含此项时才会返回该头部 string
Content-Encoding RFC 2616 中定义的编码格式,仅当对象元数据包含此项时才会返回该头部 string
Expires RFC 2616 中定义的缓存失效时间,仅当对象元数据包含此项时才会返回该头部 string
x-cos-meta-* 包括用户自定义元数据头部后缀和用户自定义元数据信息 string
x-cos-storage-class 对象存储类型。枚举值请参见 存储类型 文档,例如 STANDARD_IA,ARCHIVE。仅当对象不是标准存储(STANDARD)时才会返回该头部 Enum

版本控制相关头部

使用版本控制的对象将返回下列响应头部:

名称 描述 类型
x-cos-version-id 对象的版本 ID string

服务端加密相关头部

如果指定的对象使用了服务端加密,则此接口将返回服务端加密专用头部,请参见 服务端加密专用头部

响应体

此接口响应体为空。

错误码

此接口无特殊错误信息,全部错误信息请参见 错误码 文档。

实际案例

请求

HEAD /exampleobject HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Fri, 09 Aug 2019 10:21:01 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1565346061;1565353261&q-key-time=1565346061;1565353261&q-header-list=date;host&q-url-param-list=&q-signature=82f401cf54cd6ad0331d1c0b8c827bf8f2f9****
Connection: close

响应

HTTP/1.1 200 OK
Content-Type: image/jpeg
Content-Length: 13
Connection: close
Date: Fri, 09 Aug 2019 10:21:01 GMT
ETag: "b62e10bcab55a88240bd9c436cffdcf9"
Last-Modified: Fri, 09 Aug 2019 10:20:56 GMT
Server: tencent-cos
x-cos-request-id: NWQ0ZDQ5MGRfNmRjMDJhMDlfOThjMl8xNzE2****