Synnefo

=========================  ================================

Revision                   Description

=========================  ================================

0.8 (Jan 24, 2012)         Update allowed versioning values.

\                          Change policy/meta formatting in JSON/XML replies.

\                          Document that all non-ASCII characters in headers should be URL-encoded.

Cross-user requests are not allowed to use ``until`` and only include the account/container modification dates in the reply.

If a ``format=xml`` or ``format=json`` argument is given, extended information on the containers will be returned, serialized in the chosen format.

===========================  ============================

Name                         Description

bytes                        The total size of the objects inside the container

last_modified                The last container modification date (regardless of ``until``)

x_container_until_timestamp  The last container modification date until the timestamp provided

===========================  ============================

Example ``format=json`` reply:

    "bytes": 62452,

    "count": 8374,

    "last_modified": "2011-12-02T08:10:41.565891+00:00",

Example ``format=xml`` reply:

        <key>quota</key><value>53687091200</value>

        <key>versioning</key><value>auto</value>

      </x_container_policy>

    </container>

    <container>...</container>

  </account>

===========================  =====================

Return Code                  Description

===========================  ===============================

If a ``format=xml`` or ``format=json`` argument is given, extended information on the objects will be returned, serialized in the chosen format.

==========================  ======================================

Name                        Description

hash                        The ETag of the object

bytes                       The size of the object

content_type                The MIME content type of the object

last_modified               The last object modification date (regardless of version)

x_object_hash               The Merkle hash

x_object_uuid               The object's UUID

x_object_version            The object's version identifier

x_object_version_timestamp  The object's version timestamp

x_object_modified_by        The user that committed the object's version

x_object_sharing            Object permissions (optional)

x_object_allowed_to         Allowed actions on object (optional)

x_object_public             Object's publicly accessible URI (optional)

==========================  ======================================

Extended replies may also include virtual directory markers in separate sections of the ``json`` or ``xml`` results.

Virtual directory markers are only included when ``delimiter`` is explicitly set. They correspond to the substrings up to and including the first occurrence of the delimiter.

    "hash": "d41d8cd98f00b204e9800998ecf8427e",

    "content_type": "application/octet-stream",

    "last_modified": "2011-12-02T08:10:41.565891+00:00",

    "x_object_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",

    "x_object_uuid": "8ed9af1b-c948-4bb6-82b0-48344f5c822c",

    "x_object_version": 98,

      <hash>d41d8cd98f00b204e9800998ecf8427e</hash>

      <content_type>application/octet-stream</content_type>

      <last_modified>2011-12-02T08:10:41.565891+00:00</last_modified>

      <x_object_hash>e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855</x_object_hash>

      <x_object_uuid>8ed9af1b-c948-4bb6-82b0-48344f5c822c</x_object_uuid>

      <x_object_version>98</x_object_version>

    <object>...</object>

  </container>

===========================  ===============================

Return Code                  Description

* Headers ``X-Container-Block-*`` at the container level, exposing the underlying storage characteristics.

* All metadata replies, at all levels, include latest modification information.

* At all levels, a ``HEAD`` or ``GET`` request may use ``If-Modified-Since`` and ``If-Unmodified-Since`` headers.

* Option to include only shared containers/objects in listings.

* Object metadata allowed, in addition to ``X-Object-Meta-*``: ``Content-Encoding``, ``Content-Disposition``, ``X-Object-Manifest``. These are all replaced with every update operation, except if using the ``update`` parameter (in which case individual keys can also be deleted). Deleting meta by providing empty values also works when copying/moving an object.

* Multi-range object ``GET`` support as outlined in RFC2616.