summaryrefslogtreecommitdiffstats
path: root/src/ceph/doc/radosgw/s3.rst
blob: 56c837a3cf08a2b863a4c7c1ea925b9d1a2cbe85 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
============================
 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       | Removing expired files is supported    |
+---------------------------------+-----------------+----------------------------------------+
| **Policy (Buckets, Objects)**   | Not Supported   | ACLs are supported                     |
+---------------------------------+-----------------+----------------------------------------+
| **Bucket Website**              | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Bucket ACLs (Get, Put)**      | Supported       | Different set of canned ACLs           |
+---------------------------------+-----------------+----------------------------------------+
| **Bucket Location**             | Supported       |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **Bucket Notification**         | Not Supported   |                                        |
+---------------------------------+-----------------+----------------------------------------+
| **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       |                                        |
+---------------------------------+-----------------+----------------------------------------+

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   |
+----------------------------+------------+

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