Retrieve object metadata HEAD /v1/{account}/{container}/{object}

Request headers

X-Auth-Token

Authentication token. If omitted, the request will fail, unless access using an ACL is permitted. Refer to ACL for details.

Data Type	Cardinality
String	0..1

X-Newest

When "True" is set for this header, a search of all replicas is performed, and the latest replica is returned. If this header is omitted, the response will be faster because the search is for one valid replica only. This item will increase the load on the system, so it should only be used when absolutely necessary.

Data Type	Cardinality
Boolean	0..1

Request Parameter

{account}

Unique name of the account. An "account" is also referred to as a "project" or "tenant".

Data Type	Cardinality
String	1..1

{container}

Unique name of the container.

Data Type	Cardinality
String	1..1

{object}

Unique name of the object.

Data Type	Cardinality
String	1..1

Query Parameters

temp_url_sig

Uses a signature for requests in the URL feature with effective period.

Data Type	Cardinality
String	0..1

temp_url_expires

Specifies the effective period of the temp_url_sig in the URL feature with effective period.

Data Type	Cardinality
String	0..1

Response Headers

Last-Modified

Datetime when the object was created, or datetime when the metadata was updated previously.

Data Type	Cardinality
String	1..1

Content-Length

Size of the object.

Data Type	Cardinality
String	1..1

Content-Type

MIME type of the object.

Data Type	Cardinality
String	1..1

ETag

For objects smaller than 5 GB, this value is the MD5 checksum of the object content.

When an object is smaller than 5 GB, the MD5 checksum of the object will be returned. This value is not to be enclosed in quotation marks.

In the case of a manifest object, a value with the retrieved MD5 checksum for a string that combines the ETag and MD5 checksums of each segment of the manifest is returned. This is not the MD5 checksum of the downloaded object. Also, the value is to be enclosed in double quotation marks.

You are strongly advised to calculate the MD5 checksum of the response body, and compare it with the value retrieved using the ETag header If the values are different, this indicates that the contents are corrupt, so it will be necessary to try again.

Data Type	Cardinality
String	1..1

Content-Encoding

If a value has been set, the Content-Encoding metadata value will be returned. If a value has not been set, a value will not be returned by this operation.

Data Type	Cardinality
String	0..1

Content-Disposition

This is returned when the browser behavior has been set.

Refer to "http://www.ietf.org/rfc/rfc2183.txt" for details on the value that is returned.

Data Type	Cardinality
String	0..1

X-Delete-At

The date on which an object will be deleted is returned in UNIX Epoch timestamp format. If omitted, this will not be returned.

Data Type	Cardinality
Int	0..1

X-Object-Manifest

Returns the dynamic large object settings. This value takes the container name and prefix name of the split object in the {container}/{prefix} format.

Data Type	Cardinality
String	0..1

X-Object-Meta-name

Object metadata {name} is the name of the metadata item.

Data Type	Cardinality
String	0..1

X-Static-Large-Object

If the object is the manifest object of a static large object, "True" will be returned.

Data Type	Cardinality
String	1..1

X-Trans-Id

ID assigned to this request. This is used when inquiring about issues.

Data Type	Cardinality
Uuid	1..1

Date

Datetime when the transaction was executed

Data Type	Cardinality
Datetime	1..1

Response Elements

None.

Retrieve object metadata

Example of Request


curl -i $publicURL/marktwain/goodbye -X HEAD -H "X-Auth-Token:$token"

Example of Response


HTTP/1.1 200 OK
Content-Length: 14
Accept-Ranges: bytes
Last-Modified: Thu, 16 Jan 2014 21:12:31 GMT
Etag: 451e372e48e0f6b1114fa0724aa79fa1
X-Timestamp: 1389906751.73463
X-Object-Meta-Book: GoodbyeColumbus
Content-Type: application/octet-stream
X-Trans-Id: tx37ea34dcd1ed48ca9bc7d-0052d84b6f
Date: Thu, 16 Jan 2014 21:13:19 GMT