s3curl is Perl script which implements all operations on storage services compliant with Amazon S3 RESTful interface (e.g. it works fine with Ubuntu Enterprise Cloud implementation - Eucalyptus).

Examples

The credentials for the S3 commands should be specified by --id and --key options.

Creating bucket

The following command will create bucket bucket1 on Ubuntu Enterprise Cloud service running on host 192.168.172.128 on port 8773:

./s3curl.pl --id [id] --key [key] --createBucket -- http://192.168.172.128:8773/services/Walrus/bucket1

The same operation performed on Amazon S3 service:

./s3curl.pl --id [id] --key [key] --createBucket -- http://s3.amazonaws.com/bucket1

Listing bucket's content

On Ubuntu Enterprise Cloud:

./s3curl.pl --id [id] --key [key] -- http://192.168.172.128:8773/services/Walrus/bucket1

On Amazon S3:

./s3curl.pl --id [id] --key [key] -- http://s3.amazonaws.com/bucket1

Deleting bucket

On Ubuntu Enterprise Cloud:

./s3curl.pl --id [id] --key [key] --delete -- http://192.168.172.128:8773/services/Walrus/bucket1

On Amazon S3:

./s3curl.pl --id [id] --key [key] --delete -- http://s3.amazonaws.com/bucket1

Putting object

The following command will put the file example.txt as object named object.txt inside the bucket bucket1:

./s3curl.pl --id [id] --key [key] --put=example.txt -- http://192.168.172.128:8773/services/Walrus/bucket1/object.txt

On Amazon S3:

./s3curl.pl --id [id] --key [key] --put=example.txt -- http://s3.amazonaws.com/bucket1/object.txt

Getting object

The following command will retreive the content of the object object.txt which is stored inside the bucket bucket1:

./s3curl.pl --id [id] --key [key] -- http://192.168.172.128:8773/services/Walrus/bucket1/object.txt

On Amazon S3:

./s3curl.pl --id [id] --key [key] -- http://s3.amazonaws.com/bucket1/object.txt

Deleting object

The following command will delete the object object.txt stored inside the bucket bucket1:

./s3curl.pl --id [id] --key [key] --delete -- http://192.168.172.128:8773/services/Walrus/bucket1/object.txt

On Amazon S3:

./s3curl.pl --id [id] --key [key] --delete -- http://s3.amazonaws.com/bucket1/object.txt

http://s3.amazonaws.com