HeadObject

Article summary

Did you find this summary helpful?

Thank you for your feedback

Available in Classic and VPC

View the metadata of a stored object.

Requests

The following describes the request format for the endpoint. The request format is as follows.

Method	URI
HEAD	/v1/AUTH_{project_id}/{container}/{object}

Request headers

The following describes the headers.

Field	Type	Required	Description
`X-Auth-Token`	String	Optional	Value of the issued token
`X-Newest`	Boolean	Optional	Set whether to respond with information from the most recent replica `true` \| `false` `true`: Query all replicas and respond with information from the most recent replica If the header is omitted, respond with the fastest information available
`If-Match`	String	Optional	ETag condition header For more information, see RFC2616
`If-None-Match`	String	Optional	ETag condition header For more information, see RFC2616
`If-Modified-Since`	String	Optional	Last-Modified condition header For more information, see RFC2616
`If-Unmodified-Since`	String	Optional	Last-Modified condition header For more information, see RFC2616

Request path parameters

The following describes the parameters.

Field	Type	Required	Description
`project_id`	String	Required	Project ID For more information on how to check the project ID, see Archive Storage overview
`container`	String	Required	Name of the container where the target object will be stored
`object`	String	Required	Target object name

Request example

The following is a sample request.

curl -L -I 'https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}' \
-H 'X-Auth-Token: {token}' \
-H 'X-Newest: true'

Responses

The following describes the response format.

Response headers

The following describes the headers.

Field	Type	Required	Description
`Content-Type`	String	-	MIME type of the response result
`Content-Length`	String	-	Length of the response result (bytes)
`X-Object-Meta-{name}`	String	-	Object metadata `{name}` part is the metadata's key Header value is the metadata value
`Cache-Control`	String	-	Caching rules for requests and responses
`ETag`	String	-	ETag header value
`Last-Modified`	String	-	Most recent modification time of the object (UTC)
`X-Timestamp`	String	-	Response time for the request (Unix timestamp)
`Content-Disposition`	String	-	Browser's response handling method
`Content-Encoding`	String	-	Object's encoding method
`X-Delete-At`	Integer	-	Scheduled deletion time when automatic deletion of objects is enabled (Unix timestamp)
`X-Object-Manifest`	String	-	Response for large objects (SLOs) It displays the part's storage path
`X-Static-Large-Object`	Boolean	-	Whether it's a large object (SLO) `true` \| `false` `true`: The object is the manifest of a large object
`Accept-Ranges`	String	-	Whether the server honors a partial scope request from a client
`X-Trans-Id`	String	-	Transaction ID of the request
`X-Openstack-Request-Id`	String	-	Transaction ID of the request Identical to `X-Trans-Id`
`Date`	String	-	Response time for the request (UTC)

Response status codes

The following describes the response status codes.

HTTP status code	Code	Message	Description
200	-	OK	Request succeeded

Response example

The following is a sample response.

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

Was this article helpful?

What's Next

PostObject

Table of contents

Requests
Responses