HeadObject

Prev Next

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
If-None-Match String Optional ETag condition header
If-Modified-Since String Optional Last-Modified condition header
If-Unmodified-Since String Optional Last-Modified condition header

Request path parameters

The following describes the parameters.

Field Type Required Description
project_id String Required Project ID
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