Synnefo

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

Description                                      URI                                   Method Plankton Glance

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

`List Available Images <#id2>`_                  ``/images``                           GET    ✔        ✔

`Add or update an Image <#id3>`_                 ``/images``                           POST   ✔        ✔

`Update an Image <#id5>`_                        ``/images``                           PUT    ✔        **✘**

`List Available Images in Detail <#id6>`_        ``/images/detail``                    GET    ✔        ✔

`Retrieve Image Metadata <#id7>`_                ``/images/<img-id>``                  HEAD   ✔        ✔

`Retrieve Raw Image Data <#id8>`_                ``/images/<img-id>``                  GET    **✘**    ✔

`List Image Memberships <#id9>`_                 ``/images/<img-id>/members``          GET    ✔        ✔

`Replace a Membership List of an Image <#id10>`_ ``/images/<img-id>/members``          PUT    ✔        ✔

`Add a Member to an Image <#id11>`_              ``/images/<img-id>/members/<member>`` PUT    ✔        ✔

`Remove a Member from an Image <#id12>`_         ``/images/<img-id>/members/<member>`` DELETE ✔        ✔

`List Shared Images <#id13>`_                    ``/shared-images/<member>``           GET    ✔        ✔

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

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

Description           URI         Method Plankton Glance

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

List Available Images ``/images`` GET    ✔        ✔

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

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

Description           URI         Method Plankton Glance

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

Add / update an image ``/images`` POST   ✔        ✔

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

|

|

|

In Plankton, the ReST API desctiption details above not only cover addition of new images, but also updating an existing one. An image is identified by its location at the Pithos server (X-Image-Meta-Location). For example, to alter the name of an image, add an image with the same X-Image-Meta-Location header but a different X-Image-Meta-Name header. An update overwrites the old values. An omission of a header option is equivalent to the removal of the corresponding property or metadata from the image, provided it is allowed for an image to exist without this specific metadatum.

Glance manages image updates by compining *PUT* with semantics similar to *POST* for the same URI. Check the `Glance documentation <http://docs.openstack.org/developer/glance/glanceapi.html#update-an-image>`_ for more details on Glance implementation.