Object status

Edit online

The HEAD method returns the status of a previously stored object by using the object identifier. The URL consists of the vault name followed by the object identifier. An object is not available until it is written. Partially completed objects cannot be accessed with the read operation.

Sample request


HEAD /vault-name/d6133cd067ad4ea38cdcd1faa1e4e9040000 HTTP/1.1
Host: access.example.com

An object is retrieved from a vault that is named vault-name by using the access server access.example.com.

Sample response


HTTP/1.1 200 OK
Server: Cleversafe/3.2.0.0
Accept-Ranges: bytes
Date: Wed, 25 Sep 2013 14:38:12 GMT
X-SOH-Version: 2.5
X-Clv-Request-Id: b1a4edcf-20ce-4eae-b72c-0b8fd2a815b8
ETag: d6133cd067ad4ea38cdcd1faa1e4e9040000
Content-Length: 43

The response indicates that the object exists and how many bytes it contains.

Status codes

Table 1. Object status - status codes
Code	Status	Description
200	OK	Object status query was successful.
400	Bad Request	URL contained an invalid object identifier or was otherwise malformed.
401	Unauthorized	User authentication is needed. The request either did not provide correct credentials or the user does not have permission to read from the indicated vault.
403	Forbidden	Client has insufficient privileges to perform the operation.
404	Not Found	No such object exists in the vault.
500	Internal Server Error	Internal error was encountered on the access server. It is an unrecoverable error. Details can be provided in message body.