This script is a wrapper around curl, a popular command line http client, that will calculate the authentication parameters for the request.
To start, create an .s3curl file in your home directory. This file will contain your
AWS Access Key Id and AWS Secret Access Key pairs.
For example:
%awsSecretAccessKeys = (
# personal account
personal => {
id => '1ME55KNV6SBTR7EXG0R2',
key => 'zyMrlZUKeG9UcYpwzlPko/+Ciu0K2co0duRM3fhi',
},
# corporate account
company => {
id => '1ATXQ3HHA59CYF1CVS02',
key => 'WQY4SrSS95pJUT95V6zWea01gBKBCL6PI0cdxeH8',
},
);
After creating the .s3curl file, you can try the following commands using s3curl
To get an object, you would run:
./s3curl.pl --id=[friendly-name] -- http://s3.amazonaws.com/[bucket-name]/[key-name]
If you just want to see the object's metadata, run:
./s3curl.pl --id=[friendly=name] --head -- http://s3.amazonaws.com/[bucket-name]/[key-name]
The arguments after the '--' are passed through to curl, so you could put any curl specific options there, and then the url you are trying to get.
To put an object, run:
./s3curl.pl --id=[friendly-name] --put=<file-name> -- http://s3.amazonaws.com/[bucket-name]/[key-name]
To delete an object:
./s3curl.pl --id=[friendly-name] --delete -- http://s3.amazonaws.com/[bucket-name]/[key-name]
To copy an object:
./s3curl.pl --id=[friendly-name] --copy=[source-bucket-name/source-key-name] -- http://s3.amazonaws.com/[bucket-name]/[key-name]
To restore an object (previously archived to Glacier):
./s3curl.pl --id=[friendly-name] --post --data-binary "<RestoreRequest><Days>[number-of-days]</Days></RestoreRequest>" -- http://s3.amazonaws.com/[bucket-name]/[key-name]?restore
To list a bucket:
./s3curl.pl --id=[friendly-name] -- http://s3.amazonaws.com/[bucket-name]
To create a bucket:
./s3curl.pl --id=[friendly-name] --createBucket -- http://s3.amazonaws.com/[bucket-name]
To create a bucket with a location constraint EU:
./s3curl.pl --id=[friendly-name] --createBucket=EU -- http://s3.amazonaws.com/[bucket-name]
To delete a bucket:
./s3curl.pl --id=[friendly-name] --delete -- http://s3.amazonaws.com/[bucket-name]
To enable versioning for a bucket:
./s3curl.pl --id=[friendly-name] --put ~/versioningEnable -- http://s3.amazonaws.com/[bucket-name]?versioning
where, contents of ~/versioningEnable is
<?xml version="1.0" encoding="UTF-8"?>
<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Status>Enabled</Status>
</VersioningConfiguration>
Doing a GET for an object on a bucket where versioning is enabled, returns the latest version.
./s3curl.pl --id=[friendly-name] -- http://s3.amazonaws.com/[bucket-name]/[key-name] -v
[Look for x-amz-version-id in the response]
To get a specific version of an object:
./s3curl.pl --id=[friendly-name] -- http://s3.amazonaws.com/[bucket-name]/[key-name]?versionId=[version-id]
To get a ACL for a specific version of an object:
./s3curl.pl --id=[friendly-name] -- http://s3.amazonaws.com/[bucket-name]/[key-name]?versionId=[version-id]&acl
To copy a specific version of an object:
./s3curl.pl --id=[friendly-name] --copy=[source-bucket-name/source-key-name?versionId=[version-id]] -- http://s3.amazonaws.com/[bucket-name]/[key-name]
To list all the versions in a bucket:
./s3curl.pl --id=[friendly-name] -- http://s3.amazonaws.com/[bucket-name]?versions
SECURITY CONSIDERATION:
On a shared system, it is dangerous to specify your AWS Secret Access Key on the command line, as any other user on the machine can view your command line. Therefore we strongly advocate the use of .s3curl file to store and manage your keys.
This software code is made available "AS IS" without warranties of any kind. You may copy, display, modify and redistribute the software code either by itself or as incorporated into your code; provided that you do not remove any proprietary notices. Your use of this software code is at your own risk and you waive any claim against Amazon Digital Services, Inc. or its affiliates with respect to your use of this software code. (c) 2006 Amazon Digital Services, Inc. or its affiliates.