A CFC for managing all aspects of Amazon's Simple Storage Service, including file and directory (bucket) operations. Uses a REST interface to perform all operations. Meant to be integrated into existing applications.

The CFC has the following methods:
* init(accessKeyID, secretAccessKey) - initialize CFC (both parameters required).
* getBuckets() - List all buckets.
* putBucket(bucketName, acl, storageLocation) - create a new bucket (acl is optional and defaults to public-read, storageLocation is optional and defaults to non-EU. Use 'EU' for the European location contraint).
* getBucket(bucketName, prefix, marker, maxKeys) - get contents of a bucket (prefix
is optional and matches on the beginning of a key, marker is optional and results
start from there, maxKeys is optional and restricts the number of objects returned).
* deleteBucket(bucketName) - delete a bucket (bucket must be empty).
* putObject(bucketName, fileKey, contentType, HTTPtimeout, cacheControl, cacheDays) - puts an object into a bucket (HTTPtimeout is in seconds - default is 300; cacheControl tells browser to cache object - default is true; cacheDays default is 30).
* getObject(bucketName, fileKey, minutesValid) - get link to an object (minutesValid
is optional and defaults to 60).
* copyObject(oldBucketName, oldFileKey, newBucketName, newFileKey) - copies an object.
* renameObject(oldBucketName, oldFileKey, newBucketName, newFileKey) - renames an object.
* deleteObject(bucketName, fileKey) - delete an object from a bucket.


NOTE: You may also access your objects via:
http://bucketname.s3.amazonaws.com/name-of-the-object

12/15/08 Another New Version: 1.7
12/11/08 New Version: 1.6
2/12/08 New Streamlined Version 1.4
11/30/07 Version 1.3 Released

ID	ISSUE	STATUS	UPDATED
4	Prefix must resolve to a namespace:	Open	01/22/10 10:38 AM
3	putObject shouldn't assume file key is the same as the real path	Open	11/11/09 4:24 PM
2	Feature Request: add metadata info to 'putObject' so you can add cache-control/expires info to S3 files	Fixed	12/15/08 3:12 AM
1	getObject()	Fixed	06/13/08 12:31 AM

View All Issues

To enter issues for this (or any other) project, you must be logged in.

You may access this project's Subversion repository with your client here: http://svn.riaforge.org/amazons3.

To view files and changelists associated with this repository, go here: http://amazons3.riaforge.org/index.cfm?event=page.svnbrowse.

You may download the latest set of files from Subversion as a zip file.

Anonymous users have read access to the repository while the administrator has write access.

This project is sharing its code via Subversion. Subversion is an open source source control method. You may find more information about Subversion here: http://subversion.tigris.org/