===============================
 Ceph Object Gateway Swift API
===============================

Ceph supports a RESTful API that is compatible with the basic data access model of the `Swift API`_.

API
---

.. toctree::
   :maxdepth: 1

   Authentication <swift/auth>
   Service Ops <swift/serviceops>
   Container Ops <swift/containerops>
   Object Ops <swift/objectops>
   Temp URL Ops <swift/tempurl>
   Tutorial <swift/tutorial>
   Java <swift/java>
   Python <swift/python>
   Ruby <swift/ruby>


Features Support
----------------

The following table describes the support status for current Swift functional features:

+---------------------------------+-----------------+----------------------------------------+
| Feature                         | Status          | Remarks                                |
+=================================+=================+========================================+
| **Authentication**              | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Get Account Metadata**        | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Swift ACLs**                  | Supported       | Supports a subset of Swift ACLs        |
+---------------------------------+-----------------+----------------------------------------+
| **List Containers**             | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Delete Container**            | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Create Container**            | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Get Container Metadata**      | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Update Container Metadata**   | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Delete Container Metadata**   | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **List Objects**                | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Static Website**              | Not Supported   |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Create Object**               | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Create Large Object**         | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Delete Object**               | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Get Object**                  | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Copy Object**                 | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Get Object Metadata**         | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Update Object Metadata**      | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Expiring Objects**            | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Object Versioning**           | Not Supported   |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **CORS**                        | Not Supported   |                                        |
+---------------------------------+-----------------+----------------------------------------+

.. _Swift API: http://developer.openstack.org/api-ref-objectstorage-v1.html