2013-08-05 20:44:59 +00:00
|
|
|
============================
|
|
|
|
Ceph Object Gateway S3 API
|
|
|
|
============================
|
2012-04-25 21:46:51 +00:00
|
|
|
|
2015-07-17 06:02:36 +00:00
|
|
|
Ceph supports a RESTful API that is compatible with the basic data access model of the `Amazon S3 API`_.
|
2012-04-25 21:46:51 +00:00
|
|
|
|
|
|
|
API
|
|
|
|
---
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
:maxdepth: 1
|
|
|
|
|
|
|
|
Common <s3/commons>
|
|
|
|
Authentication <s3/authentication>
|
|
|
|
Service Ops <s3/serviceops>
|
|
|
|
Bucket Ops <s3/bucketops>
|
|
|
|
Object Ops <s3/objectops>
|
2012-06-05 18:09:44 +00:00
|
|
|
C++ <s3/cpp>
|
|
|
|
C# <s3/csharp>
|
|
|
|
Java <s3/java>
|
|
|
|
Perl <s3/perl>
|
|
|
|
PHP <s3/php>
|
|
|
|
Python <s3/python>
|
|
|
|
Ruby <s3/ruby>
|
2012-05-03 17:15:21 +00:00
|
|
|
|
2012-04-25 21:46:51 +00:00
|
|
|
|
|
|
|
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 |
|
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
2017-01-09 03:34:02 +00:00
|
|
|
| **Bucket Lifecycle** | Supported | Removing expired files is supported |
|
2012-04-25 21:46:51 +00:00
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
2017-08-08 16:39:46 +00:00
|
|
|
| **Policy (Buckets, Objects)** | Supported | ACLs & bucket policies are supported |
|
2012-04-25 21:46:51 +00:00
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
2016-07-09 07:25:37 +00:00
|
|
|
| **Bucket Website** | Supported | |
|
2012-04-25 21:46:51 +00:00
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
|
|
|
| **Bucket ACLs (Get, Put)** | Supported | Different set of canned ACLs |
|
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
2014-11-24 17:27:44 +00:00
|
|
|
| **Bucket Location** | Supported | |
|
2012-04-25 21:46:51 +00:00
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
|
|
|
| **Bucket Notification** | Not Supported | |
|
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
2015-07-20 07:37:09 +00:00
|
|
|
| **Bucket Object Versions** | Supported | |
|
2012-04-25 21:46:51 +00:00
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
|
|
|
| **Get Bucket Info (HEAD)** | Supported | |
|
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
2016-05-19 08:48:25 +00:00
|
|
|
| **Bucket Request Payment** | Supported | |
|
2012-04-25 21:46:51 +00:00
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
|
|
|
| **Put Object** | Supported | |
|
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
|
|
|
| **Delete Object** | Supported | |
|
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
|
|
|
| **Get Object** | Supported | |
|
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
|
|
|
| **Object ACLs (Get, Put)** | Supported | |
|
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
|
|
|
| **Get Object Info (HEAD)** | Supported | |
|
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
2012-12-12 00:09:42 +00:00
|
|
|
| **POST Object** | Supported | |
|
2012-04-25 21:46:51 +00:00
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
|
|
|
| **Copy Object** | Supported | |
|
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
2016-07-26 12:56:50 +00:00
|
|
|
| **Multipart Uploads** | Supported | |
|
2012-04-25 21:46:51 +00:00
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
2018-05-24 09:05:56 +00:00
|
|
|
| **Object Tagging** | Supported | See :ref:`tag_policy` for Policy verbs |
|
2017-08-08 16:39:46 +00:00
|
|
|
+---------------------------------+-----------------+----------------------------------------+
|
2017-12-18 06:27:58 +00:00
|
|
|
| **Storage Class** | Not Supported | Use **Bucket Location** as alternative |
|
|
|
|
+--------------------------------------------------------------------------------------------+
|
2017-08-08 16:39:46 +00:00
|
|
|
|
2012-04-25 21:46:51 +00:00
|
|
|
|
|
|
|
Unsupported Header Fields
|
|
|
|
-------------------------
|
|
|
|
|
|
|
|
The following common request header fields are not supported:
|
|
|
|
|
|
|
|
+----------------------------+------------+
|
|
|
|
| Name | Type |
|
|
|
|
+============================+============+
|
|
|
|
| **x-amz-security-token** | Request |
|
|
|
|
+----------------------------+------------+
|
|
|
|
| **Server** | Response |
|
|
|
|
+----------------------------+------------+
|
|
|
|
| **x-amz-delete-marker** | Response |
|
|
|
|
+----------------------------+------------+
|
|
|
|
| **x-amz-id-2** | Response |
|
|
|
|
+----------------------------+------------+
|
|
|
|
| **x-amz-version-id** | Response |
|
|
|
|
+----------------------------+------------+
|
2015-07-17 06:02:36 +00:00
|
|
|
|
|
|
|
.. _Amazon S3 API: http://docs.aws.amazon.com/AmazonS3/latest/API/APIRest.html
|