Jump to: navigation, search

Difference between revisions of "Swift/APIFeatureComparison"

(General S3 REST API Support)
(Amazon S3 REST API Compatability)
Line 86: Line 86:
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETE.html DELETE Bucket]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETE.html DELETE Bucket]  
 
|  /!\  
 
|  /!\  
| 2006-03-01*
+
| /!\  5
 
|-
 
|-
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETElifecycle.html DELETE Bucket lifecycle]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETElifecycle.html DELETE Bucket lifecycle]  
Line 102: Line 102:
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGET.html GET Bucket (List Objects)]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGET.html GET Bucket (List Objects)]  
 
|  /!\  
 
|  /!\  
| 2006-03-01*
+
| /!\ 5
 
|-
 
|-
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETacl.html GET Bucket acl]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETacl.html GET Bucket acl]  
 
|  /!\  
 
|  /!\  
| 2006-03-01*
+
| X 3
 
|-
 
|-
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETlifecycle.html GET Bucket lifecycle]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETlifecycle.html GET Bucket lifecycle]  
Line 118: Line 118:
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETlocation.html GET Bucket location]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETlocation.html GET Bucket location]  
 
|  /!\  
 
|  /!\  
|  /!\  
+
|  /!\ 6
 
|-
 
|-
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETlogging.html GET Bucket logging]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETlogging.html GET Bucket logging]  
Line 126: Line 126:
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETnotification.html GET Bucket notification]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETnotification.html GET Bucket notification]  
 
|  /!\  
 
|  /!\  
/!\
+
X
 
|-
 
|-
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETVersion.html GET Bucket Object versions]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETVersion.html GET Bucket Object versions]  
Line 134: Line 134:
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTrequestPaymentGET.html GET Bucket requestPayment]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTrequestPaymentGET.html GET Bucket requestPayment]  
 
|  /!\  
 
|  /!\  
/!\
+
X
 
|-
 
|-
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETversioningStatus.html GET Bucket versioning]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETversioningStatus.html GET Bucket versioning]  
Line 146: Line 146:
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketHEAD.html HEAD Bucket]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketHEAD.html HEAD Bucket]  
 
|  /!\  
 
|  /!\  
|<span style="font-size: large; color: white; background: red">|X</span>  
+
|<span style="font-size: large; color: white; background: red">|/!\</span>  
 
|-
 
|-
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadListMPUpload.html List Multipart Uploads]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadListMPUpload.html List Multipart Uploads]  
Line 154: Line 154:
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUT.html PUT Bucket]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUT.html PUT Bucket]  
 
|  /!\  
 
|  /!\  
| 2006-03-01*
+
| X
 
|-
 
|-
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTacl.html PUT Bucket acl]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTacl.html PUT Bucket acl]  
 
|  /!\  
 
|  /!\  
/!\
+
X 2,4
 
|-
 
|-
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTlifecycle.html PUT Bucket lifecycle]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTlifecycle.html PUT Bucket lifecycle]  
Line 170: Line 170:
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTlogging.html PUT Bucket logging]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTlogging.html PUT Bucket logging]  
 
|  /!\  
 
|  /!\  
/!\
+
X
 
|-
 
|-
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTnotification.html PUT Bucket notification]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTnotification.html PUT Bucket notification]  
 
|  /!\  
 
|  /!\  
/!\
+
X
 
|-
 
|-
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTrequestPaymentPUT.html PUT Bucket requestPayment]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTrequestPaymentPUT.html PUT Bucket requestPayment]  
 
|  /!\  
 
|  /!\  
/!\
+
X
 
|-
 
|-
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTVersioningStatus.html PUT Bucket versioning]  
 
| [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTVersioningStatus.html PUT Bucket versioning]  
Line 189: Line 189:
 
|}
 
|}
  
* This version of Amazon API supports access to buckets using a subdomain (i.e. bucket.s3.amazonaws.com), whereas [[OpenStack]] Swift3 relies on a sub-directory (eg swift.domain/bucket), which renders some tools hardcoded to use "new style" buckets unable to contact Swift in the right way, despite its ability to support correct responses.
+
5. This version of Amazon API supports access to buckets using a subdomain (i.e. bucket.s3.amazonaws.com), whereas [[OpenStack]] Swift3 relies on a sub-directory (eg swift.domain/bucket), which renders some tools hardcoded to use "new style" buckets unable to contact Swift in the right way, despite its ability to support correct responses.
 +
 
 +
6. Handles GET Bucket location, but there is not support for PUT location different to “US”
  
 
Amazon S3 Object operations are referenced [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketOps.html here]
 
Amazon S3 Object operations are referenced [http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketOps.html here]

Revision as of 20:50, 19 November 2014

S3/Swift REST API Comparison Matrix

This page attempts to enumerate how OpenStack, Eucalyptus and CloudStack compare in regards to AWS S3 REST API support. Corrections/contributions welcome.

(./) == Known to be supported

X == Known not to be supported

/!\ == Support status not yet determined

General compatibility statement

S3 is a product from Amazon, and as such, it includes "features" that are outside the scope of swift itself. For example, swift doesn't have anything to do with billing, whereas S3 buckets can be tied to Amazon's billing system. Similarly, log delivery is a service outside of swift. It's entirely possible for a swift deployed to provide that functionality, but it is not part of swift itself. Likewise, a swift deployment can provide similar geographic availability as S3, but this is tied to the deployer's willingness to build the infrastructure and support systems to do so.

General S3 REST API Support

Feature Eucalyptus OpenStack
List Bucket Objects (./) (./)
Bucket ACLs (./) X 2,3,4
Bucket Lifecycle /!\ X
Bucket Policy /!\ X
Bucket Location /!\ X
Bucket Logging /!\ X
Bucket Notification /!\ X
Bucket Object Versions /!\ X
Bucket Request Payment /!\ X
Bucket Versioning X 1 X
Bucket Website /!\ X



1. https://bugs.launchpad.net/eucalyptus/+bug/751309

2. https://bugs.launchpad.net/swift3/+bug/1381548

3. https://bugs.launchpad.net/swift3/+bug/1381735

4. https://bugs.launchpad.net/swift3/+bug/1382290


Amazon S3 REST API Compatability

Amazon S3 Bucket operations are referenced here

S3 REST API method Eucalyptus OpenStack
DELETE Bucket /!\ /!\ 5
DELETE Bucket lifecycle /!\ X
DELETE Bucket policy /!\ X
DELETE Bucket website /!\ X
GET Bucket (List Objects) /!\ /!\ 5
GET Bucket acl /!\ X 3
GET Bucket lifecycle /!\ X
GET Bucket policy /!\ X
GET Bucket location /!\ /!\ 6
GET Bucket logging /!\ /!\
GET Bucket notification /!\ X
GET Bucket Object versions /!\ X
GET Bucket requestPayment /!\ X
GET Bucket versioning /!\ X
GET Bucket website /!\ X
HEAD Bucket /!\ /!\
List Multipart Uploads /!\ X
PUT Bucket /!\ X
PUT Bucket acl /!\ X 2,4
PUT Bucket lifecycle /!\ X
PUT Bucket policy /!\ X
PUT Bucket logging /!\ X
PUT Bucket notification /!\ X
PUT Bucket requestPayment /!\ X
PUT Bucket versioning /!\ X
PUT Bucket website /!\ X

5. This version of Amazon API supports access to buckets using a subdomain (i.e. bucket.s3.amazonaws.com), whereas OpenStack Swift3 relies on a sub-directory (eg swift.domain/bucket), which renders some tools hardcoded to use "new style" buckets unable to contact Swift in the right way, despite its ability to support correct responses.

6. Handles GET Bucket location, but there is not support for PUT location different to “US”

Amazon S3 Object operations are referenced here

S3 REST API method Eucalyptus OpenStack
DELETE Object /!\ 2006-03-01*
Delete Multiple Objects /!\ /!\
GET Object /!\ 2006-03-01*
GET Object ACL /!\ 2006-03-01*
GET Object torrent /!\ /!\
HEAD Object /!\ 2006-03-01*
POST Object /!\ X
PUT Object /!\ 2006-03-01*
PUT Object acl /!\ X
PUT Object - Copy /!\ 2006-03-01*
Initiate Multipart Upload /!\ X
Upload Part /!\ X
Upload Part - Copy /!\ X
Complete Multipart Upload /!\ X
Abort Multipart Upload /!\ X
List Parts /!\ X
  • This version of Amazon API supports access to buckets using a subdomain (i.e. bucket.s3.amazonaws.com), whereas OpenStack Swift3 relies on a sub-directory (eg swift.domain/bucket), which renders some tools hardcoded to use "new style" buckets unable to contact Swift in the right way, despite its ability to support correct responses.