Cloud.com's S3 API User's Guide

3/4/2011

Table of Contents


Part 1. Cloud.com's Specific Implementation Details

User Registration

The S3 service uses the user's Cloud.com API access and secret keys [1] to implement both the REST and SOAP authentication algorithms. This is done by re-using an EC2 provided REST command. Once this URL is invoked the user has registered for both the S3 service and the EC2 REST service. 
http://<fqdn-or-ip>:<port>/bridge/rest/AmazonS3?Action=SetUserKeys&accesskey=<key>&secretkey=<key>
SetUserKeys is an unauthorized REST call.
A HTTP 200 result code is returned on success and a 401 on failure.

Endpoints

For SOAP access the endpoint is: 
http://<fqdn-or-ip>:<port>/bridge/services/AmazonS3
For the SOAP PutObject function with a DIME attachment [3]: 
http://<fqdn-or-ip>:<port>/bridge/dime/AmazonS3
For REST access the endpoint is: 
http://<fqdn-or-ip>:<port>/bridge/rest/AmazonS3

Part 2. Generic S3 Details

List of S3 Functions Implemented

Refer to the Amazon S3 documentation [2] for a description of each function. Also see Part1, section 3 above, for a list of unsupported S3 features. 
REST calls:
GET Service
DELETE Bucket
GET Bucket
GET Bucket acl
GET Bucket versioning
PUT Bucket
PUT Bucket acl
PUT Bucket versioning
List Multipart Uploads
DELETE Object
GET Object
GET Object acl
HEAD Object
POST Object
PUT Object
PUT Object (Copy)
Initiate Multipart Upload
Upload Part
Complete Multipart Upload
Abort Multipart Upload
List Parts

SOAP calls:
ListAllMyBuckets
CreateBucket
DeleteBucket
ListBucket
GetBucketAccessControlPolicy
SetBucketAccessControlPolicy
PutObjectInline
PutObject
CopyObject
GetObject
GetObjectExtended
DeleteObject
GetObjectAccessControlPolicy
SetObjectAccessControlPolicy

Supported WSDL Version

http://s3.amazonaws.com/doc/2006-03-01/


References

  1. Cloud.com's Developer API
  2. Amazon's S3 API
  3. DIME