ceph/doc/radosgw/index.rst
John Wilkins fe164e4438 doc: Republishing the admin operations API for the gateway.
fixes: #4978

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-05-09 12:08:28 -07:00

49 lines
1.9 KiB
ReStructuredText

===============
RADOS Gateway
===============
RADOS Gateway is an object storage interface built on top of ``librados`` to
provide applications with a RESTful gateway to RADOS clusters. The RADOS Gateway
supports two interfaces:
#. **S3-compatible:** Provides block storage functionality with an interface that
is compatible with a large subset of the Amazon S3 RESTful API.
#. **Swift-compatible:** Provides block storage functionality with an interface
that is compatible with a large subset of the OpenStack Swift API.
RADOS Gateway is a FastCGI module for interacting with ``librados``. Since it
provides interfaces compatible with OpenStack Swift and Amazon S3, RADOS Gateway
has its own user management. RADOS Gateway can store data in the same RADOS
cluster used to store data from Ceph FS clients or RADOS block devices.
The S3 and Swift APIs share a common namespace, so you may write data with
one API and retrieve it with the other.
.. ditaa:: +------------------------+ +------------------------+
| S3 compatible API | | Swift compatible API |
+------------------------+-+------------------------+
| radosgw |
+---------------------------------------------------+
| librados |
+------------------------+-+------------------------+
| OSDs | | Monitors |
+------------------------+ +------------------------+
.. note:: RADOS Gateway does **NOT** use the CephFS metadata server.
.. toctree::
:maxdepth: 1
Manual Install <manual-install>
Configuration <config>
Config Reference <config-ref>
Purging Temp Data <purge-temp>
S3 API <s3>
Swift API <swift>
Admin Ops API <adminops>
troubleshooting
Manpage radosgw <../../man/8/radosgw>
Manpage radosgw-admin <../../man/8/radosgw-admin>