获取对象元数据
功能介绍
拥有对象读权限的用户可以执行HEAD操作命令获取对象元数据，返回信息包含对象的元数据信息。
多版本
默认情况下，获取的是最新版本的对象元数据。如果最新版本的对象是删除标记，则返回404。如果要获取指定版本的对象元数据，请求可携带versionId消息参数。
请求消息样式
1 2 3 4 |
HEAD /ObjectName HTTP/1.1 Host: bucketname.obs.region.example.com Date: date Authorization: authorization |
请求消息元素
该请求消息中不使用消息元素。
响应消息样式
1 2 3 4 5 6 |
HTTP/1.1 status_code Content-Type: type Date: date Content-Length: length Etag: etag Last-Modified: time |
响应消息头
该请求的响应消息使用公共消息头，具体请参考表1。
除公共响应消息头之外，还可能使用如下表3中的消息头。
|
消息头名称 |
描述 |
|---|---|
|
x-obs-expiration |
当对象单独设置了对象lifecycle，过期时间以对象lifecycle为准，该消息头用expiry-date描述对象的详细过期信息；如果对象没有设置对象lifecycle，设置了桶级别lifecycle，过期时间以桶级别lifecycle为准，该消息头用expiry-date和rule-id两个键值对描述对象的详细过期信息；否则不显示该头域。 类型：String |
|
x-obs-website-redirect-location |
当桶设置了Website配置，就可以设置对象元数据的这个属性，Website接入点返回301重定向响应，将请求重定向到该属性指定的桶内的另一个对象或外部的URL。 类型：String |
|
x-obs-version-id |
对象的版本号。如果该对象无版本号，则响应中不会出现该消息头。 类型：String 默认值：无 |
|
Access-Control-Allow-Origin |
当桶设置了CORS配置，如果请求的Origin满足服务端的CORS配置，则在响应中包含这个Origin。 类型：String |
|
Access-Control-Allow-Headers |
当桶设置了CORS配置，如果请求的headers满足服务端的CORS配置，则在响应中包含这个headers。 类型：String |
|
Access-Control-Max-Age |
当桶设置了CORS配置，服务端CORS配置中的MaxAgeSeconds。 类型：Integer |
|
Access-Control-Allow-Methods |
当桶设置了CORS配置，如果请求的Access-Control-Request-Method满足服务端的CORS配置，则在响应中包含这条rule中的Methods。 类型：String 有效值：GET、PUT、HEAD、POST 、DELETE |
|
Access-Control-Expose-Headers |
当桶设置了CORS配置，服务端CORS配置中的ExposeHeader。 类型：String |
|
x-obs-object-type |
对象为非Normal对象时，会返回此头域，可取值为：Appendable 类型：String |
|
x-obs-next-append-position |
对象为Appendable对象时，会返回此头域 类型：Integer |
|
x-obs-uploadId |
对象为多段上传任务合并而来时，会返回此头域，头域值表示对应的多段任务ID 类型：String |
响应消息元素
该请求的响应消息中不带消息元素。
错误响应消息
无特殊错误；所有错误已经包含在表2中。
请求示例
1 2 3 4 5 6 |
HEAD /object1 HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.example.com Accept: */* Date: WED, 01 Jul 2015 04:19:25 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:/cARjk81l2iExMfQqn6iT3qEZ74= |
响应示例
1 2 3 4 5 6 7 8 9 10 |
HTTP/1.1 200 OK Server: OBS x-obs-request-id: 8DF400000163D3E4BB5905C41B6E65B6 Accept-Ranges: bytes ETag: "3b46eaf02d3b6b1206078bb86a7b7013" Last-Modified: WED, 01 Jul 2015 01:19:21 GMT Content-Type: binary/octet-stream x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSD3nAiTaBoeyt9oHp9vTYtXnLDmwV6D Date: WED, 01 Jul 2015 04:19:21 GMT Content-Length: 4572 |
