HeadObject
Last update：2025-08-18 15:52:08
Send HEAD request to get metadata of the object. No file content is returned this way. IAM wos:HeadObject permission is required.
Request syntax
HEAD /ObjectName HTTP/1
Host: Bucket.Endpoint
Date: date
Authorization: authorization
URI request parameters
None
Request header
In addition to common request headers, it also contains
| Name | Description | Required |
|---|---|---|
| If-Match | If ETag in request matches that of the object in bucket specified by the request, metadata of the object is returned, otherwise 412 ( precondition failed ) is returned. Type: string. ( ETag value, example: 0f64741bf7cb1089e988e4585d0d3434 ) | No |
| If-Modified-Since | Only when the object has ever been modified before time of If-Modified-Since, will metadata of the object be returned, otherwise, 304 (not modified) is returned. Type: string. | No |
| If-Unmodified-Since | Only when the object has never been modified after time of If-Unmodified-Since, will metadata of the object be returned, otherwise, 412 (Precondition Failed) is returned. Type: string | No |
| If-None-Match | If ETag in request does not match that of the object in bucket specified by the request, the content of the object is returned, otherwise 304 ( not modified ) is returned. Type: String. ( ETag value, example: 0f64741bf7cb1089e988e4585d0d3434 ) | No |
| Range | Get the content of object within the Range. If the Range is invalid , 416 Requested Range Not Satisfiable will be reported . The Range specifies the start and end byte positions, where the minimum is 0 and the maximum is the object length minus 1. Type: String. ( bytes=byte_range, for example: bytes=0-4 or bytes=512-1024 .) | No |
Request body
None
Response syntax
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
Response header
In addition to common response headers , you can use the following headers as well.
| Name | Description |
|---|---|
| Etag | Entity tag of the uploaded object. |
| x-wos-storage-class | Specifies the storage class of the object. Possible values: Standard (Standard Storage), IA (Infrequent Access), Archive (Archive Storage). Defaults to the storage class of the bucket. |
| x-amz-meta-* | Customized metadata. |
Response body
None
Special error
| Situation | HTTP Status | Error Code | Message |
|---|---|---|---|
| The Range header is provided but the range value is invalid | 416 Requested Range Not Satisfiable | InvalidRange | The requested range cannot be satisfied. |
Example
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
Is the content of this document helpful to you?
Yes
I have suggestion