HeadObject
- Print
- PDF
HeadObject
- Print
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.
Overview
Gets metadata of an object.
Syntax
HEAD /v1/AUTH_{project_id}/{container}/{object}
Request
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | Project ID |
container | path | string | Container (bucket) name |
object | path | string | Object name |
X-Auth-Token (Optional) | header | string | Token |
temp_url_sig | query | string | temp url |
temp_url_expires | query | integer | temp url |
filename (Optional) | query | string | tem url |
multipart-manifest (Optional) | query | string | If multipart-manifest=get, and the object is a large object, the API request responds with the manifest metadata and the X-Object-Manifest header of the dynamic large metadata. |
X-Newest (Optional) | header | boolean | If it is true, the API request queries all copies and responds with the information of the latest copy. If this header is not specified, the API request returns the information that it can respond most quickly with. |
If-Match (Optional) | header | string | ETag conditional header. For more information, refer to RFC2616 |
If-None-Match (Optional) | header | string | ETag conditional header. For more information, refer to RFC2616 |
If-Modified-Since (Optional) | header | string | Last-Modified conditional header. For more information, refer to RFC2616 |
If-Unmodified-Since (Optional) | header | string | Last-Modified conditional header. For more information, refer to RFC2616 |
Response
Name | In | Type | Description |
---|---|---|---|
Content-Length | header | string | Length of the response result (in bytes) |
X-Object-Meta-name (Optional) | header | string | Object metadata. The name part in the header name functions as a key of the metadata. |
Content-Disposition (Optional) | header | string | Redefines browser behaviors. |
Content-Encoding (Optional) | header | string | Encoding type of the object |
X-Delete-At (Optional) | header | integer | The time at which to delete the object (in UNIX Time) |
X-Object-Manifest (Optional) | header | string | Returned if the object is a large object (DLO). It shows the path of segment objects. |
Last-Modified | header | string | The latest time when the object was updated (in UTC) |
ETag | header | string | ETag header value |
X-Timestamp | header | string | Response time of the request (in Unix Epoch timestamp) |
X-Trans-Id | header | string | Transaction ID of the request |
X-Openstack-Request-Id | header | string | Transaction ID of the request (same as X-Trans-Id) |
Date | header | string | Response time of the request (in UTC) |
X-Static-Large-Object | header | boolean | If it is true, the object is the manifest object of a large object (SLO). |
Content-Type | header | string | MIME type of the response result |
Examples
Request example
curl -i -X HEAD -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}
Response example
HTTP/1.1 200 OK
Content-Length: 10485760
Accept-Ranges: bytes
Last-Modified: Mon, 17 Sep 2018 07:43:40 GMT
Etag: f1c9645dbc14efddc7d8a322685f26eb
X-Timestamp: 1537170219.48936
Content-Type: application/x-www-form-urlencoded
X-Trans-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
X-Openstack-Request-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
Date: Mon, 17 Sep 2018 08:49:21 GMT
The API request gets object metadata.
It returns OK (200) status code if successful.
Was this article helpful?