.. _radosgw s3:

============================ Ceph Object Gateway S3 API

Ceph supports a RESTful API that is compatible with the basic data access model of the Amazon S3 API_.

API

.. toctree:: :maxdepth: 1

Common <s3/commons> Authentication <s3/authentication> Service Ops <s3/serviceops> Bucket Ops <s3/bucketops> Object Ops <s3/objectops> C++ <s3/cpp> C# <s3/csharp> Java <s3/java> Perl <s3/perl> PHP <s3/php> Python <s3/python> Ruby <s3/ruby>

Features Support

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

+---------------------------------+-----------------+--------------------------------------------------+ | Feature | Status | Remarks | +=================================+=================+==================================================+ | List Buckets | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Delete Bucket | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Create Bucket | Supported | Different set of canned ACLs | +---------------------------------+-----------------+--------------------------------------------------+ | Bucket Lifecycle | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Bucket Replication | Partial | Permitted only across zones | +---------------------------------+-----------------+--------------------------------------------------+ | Policy (Buckets, Objects) | Supported | ACLs & bucket policies are supported | +---------------------------------+-----------------+--------------------------------------------------+ | Bucket Website | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Bucket ACLs (Get, Put) | Supported | Different set of canned ACLs | +---------------------------------+-----------------+--------------------------------------------------+ | Bucket Location | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Bucket Notification | Supported | See :ref:radosgw-s3-notification-compatibility | +---------------------------------+-----------------+--------------------------------------------------+ | Bucket Object Versions | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Get Bucket Info (HEAD) | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Bucket Request Payment | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Put Object | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Delete Object | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Get Object | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Object ACLs (Get, Put) | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Get Object Info (HEAD) | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | POST Object | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Copy Object | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Multipart Uploads | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Object Tagging | Supported | See :ref:tag_policy for Policy verbs | +---------------------------------+-----------------+--------------------------------------------------+ | Bucket Tagging | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Storage Class | Supported | See :ref:storage_classes | +---------------------------------+-----------------+--------------------------------------------------+ | Bucket Logging | Supported | | +---------------------------------+-----------------+--------------------------------------------------+ | Object Ownership | Supported | | +---------------------------------+-----------------+--------------------------------------------------+

Unsupported Header Fields

The following common request header fields are not supported:

+----------------------------+------------+ | Name | Type | +============================+============+ | x-amz-id-2 | Response | +----------------------------+------------+

.. _Amazon S3 API: http://docs.aws.amazon.com/AmazonS3/latest/API/APIRest.html