1 ============================
2 Ceph Object Gateway S3 API
3 ============================
5 Ceph supports a RESTful API that is compatible with the basic data access model of the `Amazon S3 API`_.
14 Authentication <s3/authentication>
15 Service Ops <s3/serviceops>
16 Bucket Ops <s3/bucketops>
17 Object Ops <s3/objectops>
30 The following table describes the support status for current Amazon S3 functional features:
32 +---------------------------------+-----------------+----------------------------------------+
33 | Feature | Status | Remarks |
34 +=================================+=================+========================================+
35 | **List Buckets** | Supported | |
36 +---------------------------------+-----------------+----------------------------------------+
37 | **Delete Bucket** | Supported | |
38 +---------------------------------+-----------------+----------------------------------------+
39 | **Create Bucket** | Supported | Different set of canned ACLs |
40 +---------------------------------+-----------------+----------------------------------------+
41 | **Bucket Lifecycle** | Supported | Removing expired files is supported |
42 +---------------------------------+-----------------+----------------------------------------+
43 | **Policy (Buckets, Objects)** | Not Supported | ACLs are supported |
44 +---------------------------------+-----------------+----------------------------------------+
45 | **Bucket Website** | Supported | |
46 +---------------------------------+-----------------+----------------------------------------+
47 | **Bucket ACLs (Get, Put)** | Supported | Different set of canned ACLs |
48 +---------------------------------+-----------------+----------------------------------------+
49 | **Bucket Location** | Supported | |
50 +---------------------------------+-----------------+----------------------------------------+
51 | **Bucket Notification** | Not Supported | |
52 +---------------------------------+-----------------+----------------------------------------+
53 | **Bucket Object Versions** | Supported | |
54 +---------------------------------+-----------------+----------------------------------------+
55 | **Get Bucket Info (HEAD)** | Supported | |
56 +---------------------------------+-----------------+----------------------------------------+
57 | **Bucket Request Payment** | Supported | |
58 +---------------------------------+-----------------+----------------------------------------+
59 | **Put Object** | Supported | |
60 +---------------------------------+-----------------+----------------------------------------+
61 | **Delete Object** | Supported | |
62 +---------------------------------+-----------------+----------------------------------------+
63 | **Get Object** | Supported | |
64 +---------------------------------+-----------------+----------------------------------------+
65 | **Object ACLs (Get, Put)** | Supported | |
66 +---------------------------------+-----------------+----------------------------------------+
67 | **Get Object Info (HEAD)** | Supported | |
68 +---------------------------------+-----------------+----------------------------------------+
69 | **POST Object** | Supported | |
70 +---------------------------------+-----------------+----------------------------------------+
71 | **Copy Object** | Supported | |
72 +---------------------------------+-----------------+----------------------------------------+
73 | **Multipart Uploads** | Supported | |
74 +---------------------------------+-----------------+----------------------------------------+
76 Unsupported Header Fields
77 -------------------------
79 The following common request header fields are not supported:
81 +----------------------------+------------+
83 +============================+============+
84 | **x-amz-security-token** | Request |
85 +----------------------------+------------+
86 | **Server** | Response |
87 +----------------------------+------------+
88 | **x-amz-delete-marker** | Response |
89 +----------------------------+------------+
90 | **x-amz-id-2** | Response |
91 +----------------------------+------------+
92 | **x-amz-version-id** | Response |
93 +----------------------------+------------+
95 .. _Amazon S3 API: http://docs.aws.amazon.com/AmazonS3/latest/API/APIRest.html