HeadObject
更新时间：2025-08-18 15:52:08
发送HEAD请求可获取对象的元数据信息，但不会返回文件内容。此操作需要具备IAM wos:HeadObject权限。
请求语法
HEAD /ObjectName HTTP/1
Host: Bucket.Endpoint
Date: date
Authorization: authorization
URI请求参数
无
请求头
除 公共请求头 之外，还包括以下内容：
| 名称 | 描述 | 是否必填 |
|---|---|---|
| If-Match | 如果请求中的ETag与存储空间内对象的ETag一致，则返回对象元数据，否则返回412（precondition failed）（not found） 类型：string。（ETag值，例如：0f64741bf7cb1089e988e4585d0d3434） |
否 |
| If-Modified-Since | 仅当对象在If-Modified-Since时间之后被修改过，才返回对象元数据，否则返回304（not modified）。 类型：string。 |
否 |
| If-Unmodified-Since | 仅当对象在If-Unmodified-Since时间之后从未被修改，才返回对象元数据，否则返回412（precondition failed）。 类型：string。 |
否 |
| If-None-Match | 如果请求中的ETag与存储空间内对象ETag不一致，则返回对象内容，否则返回304（not modified）。 类型：string。（ETag值，例如：0f64741bf7cb1089e988e4585d0d3434） |
否 |
| Range | 获取指定范围的对象内容。如果Range无效，则返回416 Requested Range Not Satisfiable。Range是一个范围，它的起始值最小为0，最大为对象长度减1。 类型：string。（如：bytes=0-4 或 bytes=512-1024） |
否 |
请求体
无
响应语法
HTTP/1.1 status_code
x-amz-request-id: request id
Content-Type: type
Date: date
Content-Length: length
Etag: etag
Last-Modified: time
Server: WS-web-server
响应头
除 公共响应头 ，还可以使用以下头：
| 名称 | 描述 |
|---|---|
| ETag | 上传对象的Entity tag |
| x-wos-storage-class | 指定文件的存储类型，Standard-标准存储、IA-低频存储、Archive-归档存储。默认为该空间的存储类型 |
| x-amz-meta-* | 自定义元数据 |
响应体
无
特殊错误
| Situation | HTTP Status | Error Code | Message |
|---|---|---|---|
| 头部带range，range值不合法 | 416 Requested Range Not Satisfiable | InvalidRange | The requested range cannot be satisfied. |
示例
HEAD /objectName HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/1
Host: bucket.s3-cn-east-1.wcsapi.com
Accept: */*
Date: Sat, 03 Dec 2011 09:17:57 +0000
Authorization: WOS BF6C09F302931425E9A7:++6NkzwVhw4qccNfIqf4G2vMggg=
HTTP/1.1 200 OK
x-amz-request-id: 001B21A61C6C0000013403373811529D
ETag: "507e3fff69b69bf57d303e807448560b"
Last-Modified: Sat, 03 Dec 2011 08:47:50 GMT
Content-Length: 30
Content-Type: binary/octet-stream
Date: Sat, 03 Dec 2011 09:17:57 GMT
Server: WS-web-server
本篇文档内容对您是否有帮助？
有帮助
我要反馈