HeadObject
- Print
- PDF
HeadObject
- Print
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Overview
Gets headers of the object by making a HEAD request with the specified object path. No parameters or payload is used for the operation.
Request
Syntax
HEAD https://{endpoint}/{bucket-name}/{object-name} # path style
HEAD https://{bucket-name}.{endpoint}/{object-name} # virtual host style
Header
| Header Name | Required | Type | Restrictions | Description |
|---|---|---|---|---|
| range | No | string | Returns the size of the object in bytes within the specified range. | |
| if-match | No | string (ETag) | Returns the object if the specified ETag string matches the source object. | |
| if-none-match | No | string (ETag) | Returns the object if the specified ETag string does not match the source object. | |
| if-unmodified-since | No | string (timestamp) | Returns the object if the source object has not been modified since the specified date. It must be in the valid date format (e.g.: Wed, 30 Nov 2016 20:21:38 GMT). | |
| if-modified-since | No | string (timestamp) | Returns the object if the source object has been modified since the specified date. It must be in the valid date format (e.g.: Wed, 30 Nov 2016 20:21:38 GMT). |
Examples
Request example
HEAD /example-bucket/soldier-bee HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20160825T183244Z
Host: kr.object.ncloudstorage.com
Response example
HTTP/1.1 200 OK
Date: Thu, 25 Aug 2016 18:32:44 GMT
Accept-Ranges: bytes
x-amz-request-id: da214d69-1999-4461-a130-81ba33c484a6
ETag: "37d4c94839ee181a2224d6242176c4b5"
Content-Type: text/plain; charset=UTF-8
Last-Modified: Thu, 25 Aug 2016 17:49:06 GMT
Content-Length: 11
Was this article helpful?