Synnefo

Client software using Pithos, should forward to the ``/feedback`` URI. The Pithos service, depending on its configuration will delegate the request to the appropriate identity management URI.

|

Client software using Pithos, should forward to the ``/user_catalogs`` URI to get uuid to displayname translations and vice versa. The Pithos service, depending on its configuration will delegate the request to the appropriate identity management URI.

|

::

Example ``format=xml`` reply:

  <?xml version="1.0" encoding="UTF-8"?>

  <accounts>

    <account>

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

    </account>

    <account>...</account>

::

  <?xml version="1.0" encoding="UTF-8"?>

    <container>

      <name>pithos</name>

      <bytes>62452</bytes>

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)

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

Sharing metadata and last modification timestamp will only be returned if there is no ``until`` parameter defined.

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

    "x_object_version": 98,

    "x_object_version_timestamp": "1322813441.565891",

Example ``format=xml`` reply:

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

      <x_object_version>98</x_object_version>

      <x_object_version_timestamp>1322813441.565891</x_object_version_timestamp>

    </object>

    <object>...</object>

  </container>

The ``POST`` method can also be used for creating an object via a standard HTML form. If the request ``Content-Type`` is ``multipart/form-data``, none of the above headers will be processed. The form should have an ``X-Object-Data`` field, as in the following example. The token is passed as a request parameter. ::

    <input type="file" name="X-Object-Data">

    <input type="submit">

  </form>

    curl -X HEAD -D - \

         -H "X-Auth-Token: 0000" \

* List available containers ::

    curl -X GET -D - \

         -H "X-Auth-Token: 0000" \

* Get container information ::

    curl -X HEAD -D - \

         -H "X-Auth-Token: 0000" \

* Add a new container ::

    curl -X PUT -D - \

         -H "X-Auth-Token: 0000" \

* Delete a container ::

    curl -X DELETE -D - \

         -H "X-Auth-Token: 0000" \

* List objects in a container ::

    curl -X GET -D - \

         -H "X-Auth-Token: 0000" \

* List objects in a container (extended reply) ::

    curl -X GET -D - \

         -H "X-Auth-Token: 0000" \

  It is recommended that extended replies are cached and subsequent requests utilize the ``If-Modified-Since`` header.

    curl -X GET -D - \

         -H "X-Auth-Token: 0000" \

* Retrieve an object ::

    curl -X GET -D - \

         -H "X-Auth-Token: 0000" \

* Retrieve an object (specific ranges of data) ::

    curl -X GET -D - \

         -H "X-Auth-Token: 0000" \

         -H "Range: bytes=0-9" \

  This will return the first 10 bytes. To get the first 10, bytes 30-39 and the last 100 use ``Range: bytes=0-9,30-39,-100``.

    curl -X PUT -D - \

         -H "X-Auth-Token: 0000" \

         -H "Content-Type: application/directory" \

* Add a new object ::

         -H "X-Auth-Token: 0000" \

         -H "Content-Type: text/plain" \

         -T EXAMPLE.txt

* Update an object ::

         -H "Content-Type: application/octet-stream" \

         -H "Content-Range: bytes 10-19/*" \

         -d "0123456789" \

  This will update bytes 10-19 with the data specified.

         -H "Content-Type: application/octet-stream" \

         -H "Content-Range: bytes */*" \

         -d "0123456789" \

* Update an object (truncate) ::

         -H "X-Source-Object: /folder/EXAMPLE.txt" \

         -H "Content-Range: bytes 0-0/*" \

         -H "X-Object-Bytes: 0" \

  This will truncate the object to 0 bytes.

         -H "X-Auth-Token: 0000" \

         -H "X-Object-Meta-First: first_meta_value" \

         -H "X-Object-Meta-Second: second_meta_value" \

* Delete object metadata ::

    curl -X POST -D - \

         -H "X-Auth-Token: 0000" \

         -H "X-Object-Meta-First: first_meta_value" \

  Metadata can only be "set". To delete ``X-Object-Meta-Second``, reset all metadata.

    curl -X DELETE -D - \

         -H "X-Auth-Token: 0000" \